Invoke-AzSynapsePipeline
叫用管線以啟動它的執行。
語法
Invoke-AzSynapsePipeline
-WorkspaceName <String>
-PipelineName <String>
[-Parameter <Hashtable>]
[-ParameterFile <String>]
[-ReferencePipelineRunId <String>]
[-IsRecovery]
[-StartActivityName <String>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Invoke-AzSynapsePipeline
-InputObject <PSPipelineResource>
[-Parameter <Hashtable>]
[-ParameterFile <String>]
[-ReferencePipelineRunId <String>]
[-IsRecovery]
[-StartActivityName <String>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Invoke-AzSynapsePipeline
-WorkspaceObject <PSSynapseWorkspace>
-PipelineName <String>
[-Parameter <Hashtable>]
[-ParameterFile <String>]
[-ReferencePipelineRunId <String>]
[-IsRecovery]
[-StartActivityName <String>]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>] Description
Invoke-AzSynapsePipeline 命令會在指定的管線上啟動執行，並傳回該執行的標識碼。 此 GUID 可以傳遞 至 get-AzSynapsePipelineRun 或 Get-AzSynapseActivityRun，以取得此回合的進一步詳細數據。
範例
範例 1
Invoke-AzSynapsePipeline -WorkspaceName ContosoWorkspace -PipelineName ContosoPipeline此命令會在工作區 ContosoWorkspace 中啟動名為 ContosoPipeline 的管線執行。
範例 2
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Invoke-AzSynapsePipeline -PipelineName ContosoPipeline此命令會透過管線在工作區 ContosoWorkspace 中啟動名為 ContosoPipeline 的管線執行。
範例 3
$pipeline = Get-AzSynapsePipeline -WorkspaceName ContosoWorkspace -Name ContosoPipeline
$pipeline | Invoke-AzSynapsePipeline此命令會透過管線在工作區 ContosoWorkspace 中啟動名為 ContosoPipeline 的管線執行。
參數
-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 |
-InputObject
管線執行的相關信息。
| 類型: | PSPipelineResource |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | True |
| 接受萬用字元: | False |
-IsRecovery
復原模式旗標。 如果復原模式設定為 true，則指定的參考管線執行和新的執行將會分組在相同的 groupId 下。
| 類型: | SwitchParameter |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-Parameter
管線執行的參數。
| 類型: | Hashtable |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ParameterFile
具有管線執行參數的檔名。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-PipelineName
管線名稱。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | True |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-ReferencePipelineRunId
用於重新執行的管線執行標識碼。 如果指定執行標識碼，則會使用指定回合的參數來建立新的執行。
| 類型: | String |
| Position: | Named |
| 預設值: | None |
| 必要: | False |
| 接受管線輸入: | False |
| 接受萬用字元: | False |
-StartActivityName
在復原模式中，重新執行會從此活動開始。 如果未指定，則會執行所有活動。
| 類型: | String |
| 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 |
