az automation runbook

참고

이 참조는 Azure CLI 자동화 확장의 일부이며 버전 2.13.0 이상에 필요합니다. az automation runbook 명령을 처음 실행할 때 확장이 자동으로 설치됩니다. 확장에 대해 자세히 알아보세요.

Automation Runbook.

명령

az automation runbook create

Runbook 이름으로 식별되는 Runbook을 만듭니다.

az automation runbook delete

이름으로 Runbook을 삭제합니다.

az automation runbook list

Runbook 목록을 검색합니다.

az automation runbook publish

Runbook 초안을 게시합니다.

az automation runbook replace-content

Runbook의 콘텐츠를 대체합니다.

az automation runbook revert-to-published

Runbook 콘텐츠를 마지막으로 알려진 게시된 상태로 되돌려야 합니다.

az automation runbook show

Runbook 이름으로 식별된 Runbook을 검색합니다.

az automation runbook start

Runbook을 시작합니다.

az automation runbook update

Runbook 이름으로 식별되는 Runbook을 업데이트합니다.

az automation runbook wait

자동화 Runbook 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az automation runbook create

Runbook 이름으로 식별되는 Runbook을 만듭니다.

az automation runbook create --automation-account-name
                             --name
                             --resource-group
                             --type {Graph, GraphPowerShell, GraphPowerShellWorkflow, PowerShell, PowerShellWorkflow, Script}
                             [--description]
                             [--location]
                             [--log-activity-trace]
                             [--log-progress {false, true}]
                             [--log-verbose {false, true}]
                             [--tags]

예제

Runbook 만들기

az automation runbook create --automation-account-name "myAutomationAccount" --resource-group "rg"                --name "myRunbook" --type "PowerShell" --location "East US 2"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--type

Runbook의 형식입니다.

허용되는 값: Graph, GraphPowerShell, GraphPowerShellWorkflow, PowerShell, PowerShellWorkflow, Script

선택적 매개 변수

--description

Runbook에 대한 설명입니다.

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--log-activity-trace

Runbook의 작업 수준 추적 옵션입니다.

--log-progress

Runbook의 진행률 로그 옵션입니다.

허용되는 값: false, true
--log-verbose

Runbook의 자세한 로그 옵션입니다.

허용되는 값: false, true
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

az automation runbook delete

이름으로 Runbook을 삭제합니다.

az automation runbook delete --automation-account-name
                             --name
                             --resource-group
                             [--yes]

예제

Runbook 삭제

az automation runbook delete --automation-account-name "myAutomationAccount" --resource-group "rg"                --name "myRunbook"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az automation runbook list

Runbook 목록을 검색합니다.

az automation runbook list --automation-account-name
                           --resource-group

예제

Automation 계정별 Runbook 나열

az automation runbook list --automation-account-name "myAutomationAccount" --resource-group "rg"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az automation runbook publish

Runbook 초안을 게시합니다.

az automation runbook publish --automation-account-name
                              --name
                              --resource-group
                              [--no-wait]

예제

Runbook 초안 게시

az automation runbook publish --automation-account-name "myAutomationAccount" --resource-group                "rg" --name "myRunbook"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 게시 작업에 제공된 매개 변수입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

az automation runbook replace-content

Runbook의 콘텐츠를 대체합니다.

az automation runbook replace-content --automation-account-name
                                      --content
                                      --name
                                      --resource-group
                                      [--no-wait]

예제

Runbook의 콘텐츠 바꾸기

az automation runbook replace-content --automation-account-name "myAutomationAccount" --resource-group                "rg" --name "myRunbook" --content @/path/to/script

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--content

Runbook 콘텐츠입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

az automation runbook revert-to-published

Runbook 콘텐츠를 마지막으로 알려진 게시된 상태로 되돌려야 합니다.

az automation runbook revert-to-published --automation-account-name
                                          --name
                                          --resource-group

예제

Runbook의 콘텐츠 바꾸기

az automation runbook revert-to-published --automation-account-name "myAutomationAccount"                --resource-group "rg" --name "myRunbook"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az automation runbook show

Runbook 이름으로 식별된 Runbook을 검색합니다.

az automation runbook show --automation-account-name
                           --name
                           --resource-group

예제

Runbook을 얻습니다.

az automation runbook show --automation-account-name "myAutomationAccount" --resource-group "rg"                --name "myRunbook"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az automation runbook start

Runbook을 시작합니다.

az automation runbook start --automation-account-name
                            --resource-group
                            [--name]
                            [--parameters]
                            [--run-on]

예제

Runbook을 시작합니다.

az automation runbook start --automation-account-name "myAutomationAccount" --resource-group "rg"                --name "myRunbook"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--name --runbook-name -n

Runbook 이름입니다.

--parameters

작업의 매개 변수입니다. 예상 값: KEY1=VALUE1 KEY2=VALUE2 ...

--run-on

RunOn - 작업을 실행할 그룹 이름을 지정합니다.

az automation runbook update

Runbook 이름으로 식별되는 Runbook을 업데이트합니다.

az automation runbook update --automation-account-name
                             --name
                             --resource-group
                             [--description]
                             [--log-activity-trace]
                             [--log-progress {false, true}]
                             [--log-verbose {false, true}]
                             [--tags]

예제

Runbook 업데이트

az automation runbook update --automation-account-name "myAutomationAccount" --description                "Runbook Description" --log-activity-trace 1 --log-progress true --log-verbose false                --resource-group "rg" --runbook-name "myRunbook"

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--description

Runbook에 대한 설명입니다.

--log-activity-trace

Runbook의 작업 수준 추적 옵션입니다.

--log-progress

Runbook의 진행률 로그 옵션입니다.

허용되는 값: false, true
--log-verbose

Runbook의 자세한 로그 옵션입니다.

허용되는 값: false, true
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

az automation runbook wait

자동화 Runbook 조건이 충족될 때까지 CLI를 대기 상태로 유지합니다.

az automation runbook wait --automation-account-name
                           --name
                           --resource-group
                           [--created]
                           [--custom]
                           [--deleted]
                           [--exists]
                           [--interval]
                           [--timeout]
                           [--updated]

예제

자동화 Runbook이 성공적으로 만들어질 때까지 CLI 스크립트의 다음 줄 실행을 일시 중지합니다.

az automation runbook wait --automation-account-name "myAutomationAccount" --resource-group "rg"                --name "myRunbook" --created

필수 매개 변수

--automation-account-name

Automation 계정의 이름입니다.

--name --runbook-name -n

Runbook 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

선택적 매개 변수

--created

'Succeeded'에서 'provisioningState'를 통해 생성될 때까지 기다립니다.

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예를 들어 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

삭제될 때까지 기다립니다.

--exists

리소스가 존재할 때까지 기다립니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--timeout

최대 대기 시간(초)입니다.

기본값: 3600
--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.