Dela via

az vmss run-command

  • Referens

Hantera körningskommandon på en VM-skalningsuppsättning.

Mer information finns i https://learn.microsoft.com/azure/virtual-machines/windows/run-command eller https://learn.microsoft.com/azure/virtual-machines/linux/run-command.

Kommandon

Name Description Typ Status
az vmss run-command create

Åtgärden för att skapa VMSS VM-körningskommandot.

 Kärna GA
az vmss run-command delete

Åtgärden för att ta bort körningskommandot.

 Kärna GA
az vmss run-command invoke

Kör ett specifikt körningskommando på en vm-skalningsuppsättningsinstans.

 Kärna GA
az vmss run-command list

Åtgärden för att hämta alla körningskommandon för en instans i Vm-skalningsuppsättning.

 Kärna GA
az vmss run-command show

Åtgärden för att hämta VMSS-körningskommandot.

 Kärna GA
az vmss run-command update

Åtgärden för att uppdatera VMSS-körningskommandot.

 Kärna GA

az vmss run-command create

Redigera

Åtgärden för att skapa VMSS VM-körningskommandot.

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]

Exempel

Skapa VMSS-körningskommando.

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"

Obligatoriska parametrar

--instance-id

Instans-ID för den virtuella datorn.

--name --run-command-name

Namnet på kommandot för körning av virtuell dator.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--vmss-name

Namnet på VM-skalningsuppsättningen.

Valfria parametrar

--async-execution

Valfri. Om värdet är true slutförs etableringen så snart skriptet startar och väntar inte på att skriptet ska slutföras.

Godkända värden: false, true
--command-id

Ange ett commandId för fördefinierat inbyggt skript.

--error-blob-uri

Uri (utan SAS) till en tilläggsblob där skriptfelströmmen laddas upp.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--output-blob-uri

Uri (utan SAS) till en tilläggsblob där skriptutdata laddas upp.

--parameters

Parametrarna som används av skriptet.

Användning: --parameters arg1=XX arg2=XX.

--protected-parameters

Parametrarna som används av skriptet.

Användning: --protected-parameters credentials=somefoo secret=somebar.

--run-as-password

Lösenord om det behövs för att använda parametern kör som användare. Den krypteras och loggas inte.

--run-as-user

Som standard körs skriptprocessen under system-/rotanvändare. Ange anpassad användare som värd för processen.

--script

Ange det skriptinnehåll som ska köras på den virtuella datorn.

--script-uri

Ange platsen för nedladdning av skript.

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--timeout-in-seconds

Tidsgränsen i sekunder för att köra körningskommandot.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vmss run-command delete

Redigera

Åtgärden för att ta bort körningskommandot.

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

Exempel

Åtgärden för att ta bort VMSS-körningskommandot..

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

Obligatoriska parametrar

--name --run-command-name

Namnet på kommandot för körning av virtuell dator.

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--instance-id

Instans-ID för den virtuella datorn.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--vmss-name

Namnet på VM-skalningsuppsättningen.

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vmss run-command invoke

Redigera

Kör ett specifikt körningskommando på en vm-skalningsuppsättningsinstans.

az vmss run-command show returnerar användbar information om varje körningskommando. Identifiera Kör kommando-ID:er via az vmss run-command list.

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

Exempel

Installera nginx på en VMSS-instans.

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"

Anropa ett körningskommando med parametrar på en VMSS-instans.

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

Anropa kommandot på alla VMSS-instanser med resurs-ID:n för VMSS-instansen. Obs! "@-" expanderas till 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 @-

Kör PowerShell-skript på en Windows VMSS-instans med parametrar. Skriptet har angetts infogat. Var försiktig med att citera i 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

Kör PowerShell-skript på en Windows VMSS-instans med parametrar. Skript som tillhandahålls från filen.

# 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

Obligatoriska parametrar

--command-id

Kommando-ID:t.

Värde från: az vmss run-command list

Valfria parametrar

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--instance-id

Vm-instans-ID för skalningsuppsättning.

--name -n

Namn på skalningsuppsättning. Du kan konfigurera standardvärdet med hjälp av az configure --defaults vmss=<name>.

--parameters

Blankstegsavgränsade parametrar i formatet [name=]value".

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--scripts

Blankstegsavgränsade skriptrader. Använd @{file} för att läsa in skript från en fil.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vmss run-command list

Redigera

Åtgärden för att hämta alla körningskommandon för en instans i Vm-skalningsuppsättning.

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

Exempel

Visa en lista över körningskommandon i Vmss-instansen.

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

Obligatoriska parametrar

--instance-id

Instans-ID för den virtuella datorn.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--vmss-name

Namnet på VM-skalningsuppsättningen.

Valfria parametrar

--expand

Det expanderingsuttryck som ska tillämpas på åtgärden.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vmss run-command show

Redigera

Åtgärden för att hämta VMSS-körningskommandot.

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

Exempel

Hämta VMSS-körningskommandon.

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

Obligatoriska parametrar

--name --run-command-name

Namnet på kommandot för körning av virtuell dator.

Valfria parametrar

--expand
Inaktuell

Argumentet "expand" har blivit inaktuellt och tas bort i en framtida version.

Det expanderingsuttryck som ska tillämpas på åtgärden.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--instance-id

Instans-ID för den virtuella datorn.

--instance-view

Instansvyn för ett körningskommando.

Standardvärde: False
--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--vmss-name

Namnet på VM-skalningsuppsättningen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az vmss run-command update

Redigera

Åtgärden för att uppdatera VMSS-körningskommandot.

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]

Exempel

Uppdatera VMSS-körningskommandot.

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"

Obligatoriska parametrar

--name --run-command-name

Namnet på kommandot för körning av virtuell dator.

Valfria parametrar

--async-execution

Valfri. Om värdet är true slutförs etableringen så snart skriptet startar och väntar inte på att skriptet ska slutföras.

Godkända värden: false, true
--command-id

Ange ett commandId för fördefinierat inbyggt skript.

--error-blob-uri

Uri (utan SAS) till en tilläggsblob där skriptfelströmmen laddas upp.

--ids

Ett eller flera resurs-ID:t (utrymmesavgränsade). Det bör vara ett fullständigt resurs-ID som innehåller all information om argumenten "Resurs-ID". Du bör ange antingen --id eller andra "Resurs-ID"-argument.

--instance-id

Instans-ID för den virtuella datorn.

--location -l

Plats. Värden från: az account list-locations. Du kan konfigurera standardplatsen med hjälp av az configure --defaults location=<location>.

--no-wait

Vänta inte tills den långvariga åtgärden har slutförts.

Standardvärde: False
--output-blob-uri

Uri (utan SAS) till en tilläggsblob där skriptutdata laddas upp.

--parameters

Parametrarna som används av skriptet.

Användning: --parameters arg1=XX arg2=XX.

--protected-parameters

Parametrarna som används av skriptet.

Användning: --protected-parameters credentials=somefoo secret=somebar.

--resource-group -g

Namn på resursgrupp. Du kan konfigurera standardgruppen med hjälp av az configure --defaults group=<name>.

--run-as-password

Lösenord om det behövs för att använda parametern kör som användare. Den krypteras och loggas inte.

--run-as-user

Som standard körs skriptprocessen under system-/rotanvändare. Ange anpassad användare som värd för processen.

--script

Ange det skriptinnehåll som ska köras på den virtuella datorn.

--script-uri

Ange platsen för nedladdning av skript.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--tags

Blankstegsavgränsade taggar: key[=value] [key[=value] ...]. Använd "" för att rensa befintliga taggar.

--timeout-in-seconds

Tidsgränsen i sekunder för att köra körningskommandot.

--vmss-name

Namnet på VM-skalningsuppsättningen.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.