New-AzSynapseKqlScript
在工作區中建立或更新 KQL 腳本。
語法
New-AzSynapseKqlScript
-WorkspaceName <String>
[-Name <String>]
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzSynapseKqlScript
-WorkspaceName <String>
[-Name <String>]
-KustoPoolName <String>
-KustoPoolDatabaseName <String>
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzSynapseKqlScript
-WorkspaceObject <PSSynapseWorkspace>
[-Name <String>]
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] New-AzSynapseKqlScript
-WorkspaceObject <PSSynapseWorkspace>
[-Name <String>]
-KustoPoolName <String>
-KustoPoolDatabaseName <String>
-DefinitionFile <String>
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
New-AzSynapseKqlScript Cmdlet 會在工作區中建立或更新 KQL 腳本。
範例
範例 1
New-AzSynapseKqlScript -WorkspaceName ContosoWorkspace -DefinitionFile "C:\samples\KqlScript.kql"此命令會在名為 ContosoWorkspace 的工作區中，從 Kusto 查詢檔案 KqlScript.kql 建立或更新 KQL 腳本。
範例 2
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | New-AzSynapseKqlScript -DefinitionFile "C:\samples\KqlScript.kql"此命令會透過管線，在名為 ContosoWorkspace 的工作區中，從 Kusto 查詢檔案 KqlScript.kql 建立或更新 KQL 腳本。
範例 3
New-AzSynapseKqlScript -WorkspaceName ContosoWorkspace -DefinitionFile "C:\samples\KqlScript.kql" -KustoPoolName ContosoKustoPool -KustoPoolDatabaseName ContosoKustoPoolDatabase此命令會從 Kusto 查詢檔案 KqlScript.kql 建立或更新 KqlScript，此檔案會附加至名為 ContosoWorkspace 的工作區中的 ContosoKustoPoolDatabase。
參數
-AsJob
在背景執行 Cmdlet
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Confirm
執行 Cmdlet 之前先提示您確認。
| 類型: | SwitchParameter |
| 別名: | cf |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefaultProfile
用於與 Azure 通訊的認證、帳戶、租用戶和訂用帳戶。
| 類型: | IAzureContextContainer |
| 別名: | AzContext, AzureRmContext, AzureCredential |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-DefinitionFile
KQL 檔案路徑。
| 類型: | String |
| 別名: | File |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-KustoPoolDatabaseName
Synapse Kusto 資料庫的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-KustoPoolName
Synapse Kusto 集區的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Name
KQL 文稿名稱。
| 類型: | String |
| 別名: | KqlScriptName |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WhatIf
顯示執行 Cmdlet 後會發生的情況。 未執行 Cmdlet。
| 類型: | SwitchParameter |
| 別名: | wi |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WorkspaceName
Synapse 工作區的名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-WorkspaceObject
工作區輸入物件，通常是透過管線傳遞。
| 類型: | PSSynapseWorkspace |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
