az automation runbook
注意
此參考是 Azure CLI 自動化延伸模組的一部分(2.55.0 版或更高版本)。 擴充功能會在您第一次執行 az automation Runbook 命令時自動安裝。 深入了解擴充功能。
此命令群組是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
自動化 Runbook。
命令
名稱 | Description | 類型 | 狀態 |
---|---|---|---|
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 |
將 CLI 置於等候狀態,直到符合自動化 Runbook 的條件為止。 |
副檔名 | 實驗 |
az automation runbook create
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
建立 Runbook 名稱所識別的 Runbook。
az automation runbook create --automation-account-name
--name
--resource-group
--type {Graph, GraphPowerShell, GraphPowerShellWorkflow, PowerShell, PowerShellWorkflow, Python2, Python3, 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"
必要參數
自動化帳戶的名稱。
Runbook 名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
Runbook 的類型。
選擇性參數
Runbook 的描述。
位置。 來自的值: az account list-locations
。 您可以使用 az configure --defaults location=<location>
設定預設位置。
Runbook 的活動層級追蹤選項。
Runbook 的進度記錄選項。
Runbook 的詳細信息記錄選項。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook delete
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
依名稱刪除 Runbook。
az automation runbook delete [--automation-account-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
[--yes]
範例
刪除 Runbook
az automation runbook delete --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook"
選擇性參數
自動化帳戶的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
Runbook 名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
不提示確認。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook list
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
擷取 Runbook 清單。
az automation runbook list --automation-account-name
--resource-group
範例
依自動化帳戶列出 Runbook
az automation runbook list --automation-account-name "myAutomationAccount" --resource-group "rg"
必要參數
自動化帳戶的名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook publish
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
發佈 Runbook 草稿。
az automation runbook publish [--automation-account-name]
[--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
範例
發佈 Runbook 草稿
az automation runbook publish --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook"
選擇性參數
自動化帳戶的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
提供給發行 Runbook 作業的參數。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook replace-content
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
取代 Runbook 的內容。
az automation runbook replace-content --content
[--automation-account-name]
[--ids]
[--name]
[--no-wait]
[--resource-group]
[--subscription]
範例
取代 Runbook 的內容
az automation runbook replace-content --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook" --content @/path/to/script
必要參數
Runbook 內容。
選擇性參數
自動化帳戶的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
Runbook 名稱。
請勿等候長時間執行的作業完成。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook revert-to-published
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
將 Runbook 內容還原為最後已知的已發佈狀態。
az automation runbook revert-to-published [--automation-account-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
範例
取代 Runbook 的內容
az automation runbook revert-to-published --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook"
選擇性參數
自動化帳戶的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
Runbook 名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook show
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
擷取 Runbook 名稱所識別的 Runbook。
az automation runbook show [--automation-account-name]
[--ids]
[--name]
[--resource-group]
[--subscription]
範例
取得 Runbook
az automation runbook show --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook"
選擇性參數
自動化帳戶的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
Runbook 名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook start
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
啟動 Runbook。
az automation runbook start [--automation-account-name]
[--ids]
[--name]
[--parameters]
[--resource-group]
[--run-on]
[--subscription]
範例
啟動 Runbook
az automation runbook start --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook"
選擇性參數
自動化帳戶的名稱。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
Runbook 名稱。
作業的參數。 預期值:KEY1=VALUE1 KEY2=VALUE2 ...
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
RunOn,指定要執行作業的組名。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook update
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
更新 Runbook 名稱所識別的 Runbook。
az automation runbook update [--automation-account-name]
[--description]
[--ids]
[--log-activity-trace]
[--log-progress {false, true}]
[--log-verbose {false, true}]
[--name]
[--resource-group]
[--subscription]
[--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"
選擇性參數
自動化帳戶的名稱。
Runbook 的描述。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
Runbook 的活動層級追蹤選項。
Runbook 的進度記錄選項。
Runbook 的詳細信息記錄選項。
Runbook 名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
以空格分隔的標記:key[=value] [key[=value] ...]。使用 「清除現有的標記」。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
az automation runbook wait
命令群組 「自動化 Runbook」是實驗性且正在開發中。 參考和支援層級: https://aka.ms/CLI_refstatus
將 CLI 置於等候狀態,直到符合自動化 Runbook 的條件為止。
az automation runbook wait [--automation-account-name]
[--created]
[--custom]
[--deleted]
[--exists]
[--ids]
[--interval]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
範例
暫停執行下一行 CLI 腳本,直到自動化 Runbook 成功建立為止。
az automation runbook wait --automation-account-name "myAutomationAccount" --resource-group "rg" --name "myRunbook" --created
選擇性參數
自動化帳戶的名稱。
請等候在 'Succeeded' 使用 'provisioningState' 建立。
等到條件符合自定義 JMESPath 查詢為止。 例如 provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running']。
等到刪除為止。
等候資源存在。
一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源標識碼」自變數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」自變數。
輪詢間隔以秒為單位。
Runbook 名稱。
資源群組的名稱。 您可以使用 來設定預設群組 az configure --defaults group=<name>
。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
以秒為單位的等候上限。
等到 provisioningState 更新為 'Succeeded'。
全域參數
增加記錄詳細資訊,以顯示所有偵錯記錄。
顯示此說明訊息並結束。
只顯示錯誤,隱藏警告。
輸出格式。
JMESPath 查詢字串。 如需詳細資訊和範例,請參閱 http://jmespath.org/。
訂用帳戶的名稱或標識碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID
帳戶。
增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。
意見反應
https://aka.ms/ContentUserFeedback。
即將登場:在 2024 年,我們將逐步淘汰 GitHub 問題作為內容的意見反應機制,並將它取代為新的意見反應系統。 如需詳細資訊,請參閱:提交並檢視相關的意見反應