FabricTools v0.33.0 Public Preview

New-FabricKQLQueryset

Creates a new KQLQueryset in a specified Microsoft Fabric workspace.

Syntax

New-FabricKQLQueryset [-WorkspaceId] <guid> [-KQLQuerysetName] <string>
 [[-KQLQuerysetDescription] <string>] [[-KQLQuerysetPathDefinition] <string>]
 [[-KQLQuerysetPathPlatformDefinition] <string>] [-WhatIf] [-Confirm] [<CommonParameters>]

Description

This function sends a POST request to the Microsoft Fabric API to create a new KQLQueryset in the specified workspace. It supports optional parameters for KQLQueryset description and path definitions for the KQLQueryset content.

Examples

Example 1

Creates a new KQLQueryset named "New KQLQueryset" in the specified workspace with a path to the definition file.

New-FabricKQLQueryset -WorkspaceId "workspace-12345" -KQLQuerysetName "New KQLQueryset" -KQLQuerysetPathDefinition "C:\kql\example.ipynb"

Parameters

NameTypeReq.Pos.PipelineDescription
-KQLQuerysetName string ✓Required 1 –

The name of the KQLQueryset to be created.

-WorkspaceId guid ✓Required 0 –

The unique identifier of the workspace where the KQLQueryset will be created.

-Confirmalias: cf switch Named –

Prompts you for confirmation before running the cmdlet.

-KQLQuerysetDescription string 2 –

An optional description for the KQLQueryset.

-KQLQuerysetPathDefinition string 3 –

An optional path to the KQLQueryset definition file (e.g., .ipynb file) to upload.

-KQLQuerysetPathPlatformDefinition string 4 –

An optional path to the platform-specific definition (e.g., .platform file) to upload.

-WhatIfalias: wi switch Named –

Runs the command in a mode that only reports what would happen without performing the actions.

This cmdlet also supports the common parameters, such as -Verbose and -ErrorAction. See about_CommonParameters.

Notes

  • Calls Confirm-TokenState to ensure token validity before making the API request.

Author: Tiago Balabuch, Kamil Nowinski