az vmss run-command

  • 參考

管理虛擬機器擴展集上的執行命令。

如需詳細資訊，請參閱 https://docs.microsoft.com/azure/virtual-machines/windows/run-command或 https://docs.microsoft.com/azure/virtual-machines/linux/run-command。

命令

名稱 Description 類型 狀態
az vmss run-command create

建立 VMSS VM 執行命令的作業。

 核心 GA
az vmss run-command delete

要刪除執行命令的作業。

 核心 GA
az vmss run-command invoke

在虛擬機器擴展集實例上執行特定的執行命令。

 核心 GA
az vmss run-command list

在虛擬機器擴展集中取得實例所有執行命令的作業。

 核心 GA
az vmss run-command show

取得 VMSS 執行命令的作業。

 核心 GA
az vmss run-command update

更新 VMSS 執行命令的作業。

 核心 GA

az vmss run-command create

編輯

建立 VMSS VM 執行命令的作業。

az vmss run-command create --instance-id
                           --name
                           --resource-group
                           --vmss-name
                           [--async-execution {false, true}]
                           [--command-id]
                           [--error-blob-uri]
                           [--location]
                           [--no-wait]
                           [--output-blob-uri]
                           [--parameters]
                           [--protected-parameters]
                           [--run-as-password]
                           [--run-as-user]
                           [--script]
                           [--script-uri]
                           [--tags]
                           [--timeout-in-seconds]

範例

建立 VMSS 執行命令。

az vmss run-command create --resource-group "myResourceGroup" --instance-id "0" --location "West US" --async-execution false --parameters arg1=param1 arg2=value1 --run-as-password "<runAsPassword>" --run-as-user "user1" --script "Write-Host Hello World!" --timeout-in-seconds 3600 --run-command-name "myRunCommand" --vmss-name "myVMSS"

必要參數

--instance-id

虛擬機器的實例識別碼。

--name --run-command-name

虛擬機器執行命令的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--vmss-name

VM 擴展集的名稱。

選擇性參數

--async-execution

選擇性。 如果設定為 true，則一開始腳本就會完成布建，且不會等待腳本完成。

接受的值: false, true
--command-id

指定預先定義內建腳本的 commandId。

--error-blob-uri

URI （不含 SAS）至附加 Blob，其中會上傳腳本錯誤資料流程。

--location -l

位置。​​ 來自的值： az account list-locations 。 您可以使用 來設定預設位置 az configure --defaults location=<location> 。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--output-blob-uri

URI （不含 SAS）至將上傳腳本輸出的附加 Blob。

--parameters

腳本所使用的參數。

使用方式：-parameters arg1=XX arg2=XX。

--protected-parameters

腳本所使用的參數。

使用方式：--protected-parameters credentials=somefoo secret=somebar。

--run-as-password

如果需要使用執行身分使用者參數，請使用密碼。 將會加密且未記錄。

--run-as-user

根據預設，腳本進程會在系統/根使用者下執行。 指定要裝載進程的自訂使用者。

--script

指定要在 VM 上執行的腳本內容。

--script-uri

指定腳本下載位置。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--timeout-in-seconds

執行命令的逾時以秒為單位。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss run-command delete

編輯

要刪除執行命令的作業。

az vmss run-command delete --name
                           [--ids]
                           [--instance-id]
                           [--no-wait]
                           [--resource-group]
                           [--subscription]
                           [--vmss-name]
                           [--yes]

範例

刪除 VMSS run 命令的作業。

az vmss run-command delete --resource-group "myResourceGroup" --instance-id "0" --run-command-name "myRunCommand" --vmss-name "myVMSS"

必要參數

--name --run-command-name

虛擬機器執行命令的名稱。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--instance-id

虛擬機器的實例識別碼。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--vmss-name

VM 擴展集的名稱。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss run-command invoke

編輯

在虛擬機器擴展集實例上執行特定的執行命令。

az vmss run-command show 會傳回每個 run-command 的實用資訊。 透過 探索執行命令識別碼 az vmss run-command list 。

az vmss run-command invoke --command-id
                           [--ids]
                           [--instance-id]
                           [--name]
                           [--parameters]
                           [--resource-group]
                           [--scripts]
                           [--subscription]

範例

在 VMSS 實例上安裝 nginx。

az vmss run-command invoke -g MyResourceGroup -n MyVMSS --command-id RunShellScript \ --instance-id 0 --scripts "sudo apt-get update && sudo apt-get install -y nginx"

在 VMSS 實例上使用參數叫用 run-command。

az vmss run-command invoke -g MyResourceGroup -n MyVMSS --command-id RunShellScript \ --instance-id 4 --scripts 'echo $1 $2' --parameters hello world

使用 VMSS 實例資源識別碼在所有 VMSS 實例上叫用命令。 注意：「@-」 會展開至 stdin。

az vmss list-instances -n MyVMSS -g my-rg --query "[].id" --output tsv | \
az vmss run-command invoke --scripts 'echo $1 $2' --parameters hello world  \
    --command-id RunShellScript --ids @-

在具有參數的 Windows VMSS 實例上執行 Powershell 腳本。 內嵌提供的腳本。 在 CMD.exe 中謹慎引用單引號。

az vmss run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts 'param([string]$arg1,[string]$arg2)' \
    'Write-Host This is a sample script with parameters $arg1 and $arg2' \
    --parameters 'arg1=somefoo' 'arg2=somebar' --instance-id 2

在具有參數的 Windows VMSS 實例上執行 Powershell 腳本。 從檔案提供的腳本。

# script.ps1
#   param(
#       [string]$arg1,
#       [string]$arg2
#   )
#   Write-Host This is a sample script with parameters $arg1 and $arg2

az vmss run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar" --instance-id 5

必要參數

--command-id

命令識別碼。

值來自: az vmss run-command list

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--instance-id

擴展集 VM 實例識別碼。

--name -n

擴展集名稱。 您可以使用 來設定預設值 az configure --defaults vmss=<name> 。

--parameters

以 '[name=]value' 格式的空格分隔參數。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--scripts

以空格分隔的腳本行。 使用 @{file} 從檔案載入腳本。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss run-command list

編輯

在虛擬機器擴展集中取得實例所有執行命令的作業。

az vmss run-command list --instance-id
                         --resource-group
                         --vmss-name
                         [--expand]

範例

列出 Vmss 實例中的執行命令。

az vmss run-command list --resource-group "myResourceGroup" --vmss-name "myVMSS" --instance-id "0"

必要參數

--instance-id

虛擬機器的實例識別碼。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--vmss-name

VM 擴展集的名稱。

選擇性參數

--expand

要套用至作業的展開運算式。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss run-command show

編輯

取得 VMSS 執行命令的作業。

az vmss run-command show --name
                         [--ids]
                         [--instance-id]
                         [--instance-view]
                         [--resource-group]
                         [--subscription]
                         [--vmss-name]

範例

取得 VMSS 執行命令。

az vmss run-command show --instance-id "0" --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vmss-name "myVMSS"

必要參數

--name --run-command-name

虛擬機器執行命令的名稱。

選擇性參數

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--instance-id

虛擬機器的實例識別碼。

--instance-view

執行命令的實例檢視。

預設值: False
--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--vmss-name

VM 擴展集的名稱。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az vmss run-command update

編輯

更新 VMSS 執行命令的作業。

az vmss run-command update --name
                           [--async-execution {false, true}]
                           [--command-id]
                           [--error-blob-uri]
                           [--ids]
                           [--instance-id]
                           [--location]
                           [--no-wait]
                           [--output-blob-uri]
                           [--parameters]
                           [--protected-parameters]
                           [--resource-group]
                           [--run-as-password]
                           [--run-as-user]
                           [--script]
                           [--script-uri]
                           [--subscription]
                           [--tags]
                           [--timeout-in-seconds]
                           [--vmss-name]

範例

更新 VMSS 執行命令。

az vmss run-command update --resource-group "myResourceGroup" --instance-id "0" --location "West US" --async-execution false --parameters arg1=param1 arg2=value1 --run-as-password "<runAsPassword>" --run-as-user "user1" --script "Write-Host Hello World!" --timeout-in-seconds 3600 --run-command-name "myRunCommand" --vmss-name "myVMSS"

必要參數

--name --run-command-name

虛擬機器執行命令的名稱。

選擇性參數

--async-execution

選擇性。 如果設定為 true，則一開始腳本就會完成布建，且不會等待腳本完成。

接受的值: false, true
--command-id

指定預先定義內建腳本的 commandId。

--error-blob-uri

URI （不含 SAS）至附加 Blob，其中會上傳腳本錯誤資料流程。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--instance-id

虛擬機器的實例識別碼。

--location -l

位置。​​ 來自的值： az account list-locations 。 您可以使用 來設定預設位置 az configure --defaults location=<location> 。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--output-blob-uri

URI （不含 SAS）至將上傳腳本輸出的附加 Blob。

--parameters

腳本所使用的參數。

使用方式：-parameters arg1=XX arg2=XX。

--protected-parameters

腳本所使用的參數。

使用方式：--protected-parameters credentials=somefoo secret=somebar。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--run-as-password

如果需要使用執行身分使用者參數，請使用密碼。 將會加密且未記錄。

--run-as-user

根據預設，腳本進程會在系統/根使用者下執行。 指定要裝載進程的自訂使用者。

--script

指定要在 VM 上執行的腳本內容。

--script-uri

指定腳本下載位置。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--tags

以空格分隔的標記：key[=value] [key[=value] ...]。使用 「」 清除現有的標記。

--timeout-in-seconds

執行命令的逾時以秒為單位。

--vmss-name

VM 擴展集的名稱。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。