다음을 통해 공유


Start-AzAutomationRunbook

Runbook 작업을 시작합니다.

구문

ByAsynchronousReturnJob (기본값)

Start-AzAutomationRunbook
    [-Name] <String>
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    [-Parameters <IDictionary>]
    [-RunOn <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

BySynchronousReturnJobOutput

Start-AzAutomationRunbook
    [-Name] <String>
    [-ResourceGroupName] <String>
    [-AutomationAccountName] <String>
    [-Parameters <IDictionary>]
    [-RunOn <String>]
    [-Wait]
    [-MaxWaitSeconds <Int32>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Description

Start-AzAutomationRunbook cmdlet은 Azure Automation Runbook 작업을 시작합니다. Runbook의 ID 또는 이름을 지정합니다.

예제

예제 1: Runbook 작업 시작

Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01"

이 명령은 Contoso17이라는 Azure Automation 계정에서 Runbk01이라는 Runbook에 대한 Runbook 작업을 시작합니다.

예제 2: 매개 변수를 사용하여 Python 2 Runbook 작업 시작

$params = [ordered]@{"Key1"="ValueForPosition1";"Key2"="ValueForPosition2"}
Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "RunbkPy01" -ResourceGroupName "ResourceGroup01" -Parameters $params

이 명령은 Contoso17이라는 Azure Automation 계정에서 RunbkPy01이라는 Python 2 Runbook에 대한 Runbook 작업을 시작하고 첫 번째 위치 매개 변수로 "ValueForPosition1"을 사용하고 두 번째 계정에는 "ValueForPosition2"를 사용합니다.

예제 3: Runbook 작업 시작 및 결과 대기

Start-AzAutomationRunbook -AutomationAccountName "Contoso17" -Name "Runbk01" -ResourceGroupName "ResourceGroup01" -MaxWaitSeconds 1000 -Wait

이 명령은 Contoso17이라는 Azure Automation 계정에서 Runbk01이라는 Runbook에 대한 Runbook 작업을 시작합니다. 이 명령은 Wait 매개 변수를 지정합니다. 따라서 작업이 완료된 후 결과를 반환합니다. cmdlet은 결과에 대해 최대 1000초 동안 대기합니다.

매개 변수

-AutomationAccountName

Start-AzAutomationRunbook cmdlet은 Azure Automation Runbook 작업을 시작합니다. Runbook의 ID 또는 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:1
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-DefaultProfile

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

매개 변수 속성

형식:IAzureContextContainer
Default value:None
와일드카드 지원:False
DontShow:False
별칭:AzContext, AzureRmContext, AzureCredential

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MaxWaitSeconds

이 cmdlet은 작업을 중단하기 전에 작업이 완료될 때까지 대기하는 시간(초)을 지정합니다. 기본값은 10800 또는 3시간입니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

BySynchronousReturnJobOutput
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Name

Start-AzAutomationRunbook cmdlet은 Azure Automation Runbook 작업을 시작합니다. Runbook의 ID 또는 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:RunbookName

매개 변수 집합

(All)
Position:2
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Parameters

Start-AzAutomationRunbook cmdlet은 Azure Automation Runbook 작업을 시작합니다. Runbook의 ID 또는 이름을 지정합니다.

매개 변수 속성

형식:IDictionary
Default value:None
와일드카드 지원:False
DontShow:False
별칭:JobParameters

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-ResourceGroupName

Start-AzAutomationRunbook cmdlet은 Azure Automation Runbook 작업을 시작합니다. Runbook의 ID 또는 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:0
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-RunOn

Runbook을 실행할 Hybrid Worker 그룹을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False
별칭:HybridWorker

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:True
나머지 인수의 값:False

-Wait

이 cmdlet은 작업이 완료, 일시 중단 또는 실패할 때까지 기다린 다음, Azure PowerShell에 컨트롤을 반환합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

BySynchronousReturnJobOutput
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

String

출력

Job

PSObject