다음을 통해 공유


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 명령은 지정된 파이프라인에서 실행을 시작하고 해당 실행에 대한 ID를 반환합니다. 이 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
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

형식:SwitchParameter
별칭:cf
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-DefaultProfile

Azure와의 통신에 사용되는 자격 증명, 계정, 테넌트 및 구독입니다.

형식:IAzureContextContainer
별칭:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-InputObject

파이프라인 실행에 대한 정보입니다.

형식:PSPipelineResource
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-IsRecovery

복구 모드 플래그입니다. 복구 모드가 true로 설정되면 지정된 참조된 파이프라인이 실행되고 새 실행이 동일한 groupId 아래에 그룹화됩니다.

형식:SwitchParameter
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Parameter

파이프라인 실행에 대한 매개 변수입니다.

형식:Hashtable
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ParameterFile

파이프라인 실행에 대한 매개 변수가 있는 파일의 이름입니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-PipelineName

파이프라인 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReferencePipelineRunId

다시 실행하기 위한 파이프라인 실행 ID입니다. 실행 ID를 지정하면 지정된 실행의 매개 변수를 사용하여 새 실행을 만듭니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-StartActivityName

복구 모드에서는 이 작업에서 다시 실행이 시작됩니다. 지정하지 않으면 모든 활동이 실행됩니다.

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

cmdlet이 실행되면 어떻게 되는지 보여 주세요. cmdlet이 실행되지 않습니다.

형식:SwitchParameter
별칭:wi
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WorkspaceName

Synapse 작업 영역의 이름입니다.

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WorkspaceObject

일반적으로 파이프라인을 통해 전달되는 작업 영역 입력 개체입니다.

형식:PSSynapseWorkspace
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

입력

PSPipelineResource

PSSynapseWorkspace

출력

PSCreateRunResponse