Dela via

az vmss run-command

Hantera körningskommando.

Kommandon

Name Description Typ Status
az vmss run-command create

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

 Core GA
az vmss run-command delete

Ta bort åtgärden för att ta bort vmSS VM-körningskommandot.

 Core GA
az vmss run-command invoke

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

 Core GA
az vmss run-command list

Liståtgärd för att hämta alla körningskommandon för en instans i Vm-skalningsuppsättning.

 Core GA
az vmss run-command show

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

 Core GA
az vmss run-command update

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

 Core GA
az vmss run-command wait

Placera CLI i vänteläge tills ett villkor uppfylls.

 Core 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 --run-command-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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--async-execution

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

Egenskap Värde
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

Location. 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.

Egenskap Värde
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.

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--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.

Egenskap Värde
Standardvärde: False

az vmss run-command delete

Redigera

Ta bort åtgärden för att ta bort vmSS VM-körningskommandot.

az vmss run-command delete [--ids]
                           [--instance-id]
                           [--name --run-command-name]
                           [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                           [--resource-group]
                           [--subscription]
                           [--vmss-name]
                           [--yes]

Exempel

Ta bort ett VMSS-körningskommando.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Egenskap Värde
Parameter group: Resource Id Arguments
--instance-id

Den virtuella datorns instans.

Egenskap Värde
Parameter group: Resource Id Arguments
--name --run-command-name -n

Namnet på VirtualMachineRunCommand.

Egenskap Värde
Parameter group: Resource Id Arguments
--no-wait

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

Egenskap Värde
Godkända värden: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

Egenskap Värde
Parameter group: Resource Id Arguments
--subscription

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

Egenskap Värde
Parameter group: Resource Id Arguments
--vmss-name

Namnet på VirtualMachineScaleSet.

Egenskap Värde
Parameter group: Resource Id Arguments
--yes -y

Fråga inte efter bekräftelse.

Egenskap Värde
Standardvärde: False
Globala parametrar
--debug

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

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--verbose

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

Egenskap Värde
Standardvärde: False

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.

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

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Egenskap Värde
Parameter group: Resource Id Arguments
--instance-id

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

Egenskap Värde
Parameter group: Resource Id Arguments
--name -n

Namn på skalningsuppsättning. Du kan konfigurera standardinställningen med .az configure --defaults vmss=<name>

Egenskap Värde
Parameter group: Resource Id Arguments
--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>.

Egenskap Värde
Parameter group: Resource Id Arguments
--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.

Egenskap Värde
Parameter group: Resource Id Arguments
Globala parametrar
--debug

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

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--verbose

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

Egenskap Värde
Standardvärde: False

az vmss run-command list

Redigera

Liståtgärd 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]
                         [--max-items]
                         [--next-token]

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

Den virtuella datorns instans.

--resource-group -g

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

--vmss-name

Namnet på VirtualMachineScaleSet.

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

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

--max-items

Totalt antal objekt som ska returneras i kommandots utdata. Om det totala antalet tillgängliga objekt är mer än det angivna värdet anges en token i kommandots utdata. Om du vill återuppta sidnumreringen anger du tokenvärdet i --next-token argument för ett efterföljande kommando.

Egenskap Värde
Parameter group: Pagination Arguments
--next-token

Token för att ange var sidnumrering ska börja. Detta är tokenvärdet från ett tidigare trunkerat svar.

Egenskap Värde
Parameter group: Pagination Arguments
Globala parametrar
--debug

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

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--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.

Egenskap Värde
Standardvärde: False

az vmss run-command show

Redigera

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

az vmss run-command show --name --run-command-name
                         [--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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--ids

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

Egenskap Värde
Parameter group: Resource Id Arguments
--instance-id

Instans-ID för den virtuella datorn.

Egenskap Värde
Parameter group: Resource Id Arguments
--instance-view

Instansvyn för ett körningskommando.

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

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

Egenskap Värde
Parameter group: Resource Id Arguments
--subscription

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

Egenskap Värde
Parameter group: Resource Id Arguments
--vmss-name

Namnet på VM-skalningsuppsättningen.

Egenskap Värde
Parameter group: Resource Id Arguments
Globala parametrar
--debug

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

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--verbose

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

Egenskap Värde
Standardvärde: False

az vmss run-command update

Redigera

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

az vmss run-command update --name --run-command-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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--async-execution

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

Egenskap Värde
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 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parameter group: Resource Id Arguments
--instance-id

Instans-ID för den virtuella datorn.

Egenskap Värde
Parameter group: Resource Id Arguments
--location -l

Location. 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.

Egenskap Värde
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>.

Egenskap Värde
Parameter group: Resource Id Arguments
--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.

Egenskap Värde
Parameter group: Resource Id Arguments
--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.

Egenskap Värde
Parameter group: Resource Id Arguments
Globala parametrar
--debug

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

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--verbose

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

Egenskap Värde
Standardvärde: False

az vmss run-command wait

Redigera

Placera CLI i vänteläge tills ett villkor uppfylls.

az vmss run-command wait [--created]
                         [--custom]
                         [--deleted]
                         [--exists]
                         [--expand]
                         [--ids]
                         [--instance-id]
                         [--interval]
                         [--name --run-command-name]
                         [--resource-group]
                         [--subscription]
                         [--timeout]
                         [--updated]
                         [--vmss-name]

Valfria parametrar

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

Vänta tills du har skapat med "provisioningState" på "Lyckades".

Egenskap Värde
Parameter group: Wait Condition Arguments
Standardvärde: False
--custom

Vänta tills villkoret uppfyller en anpassad JMESPath-fråga. T.ex. provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

Egenskap Värde
Parameter group: Wait Condition Arguments
--deleted

Vänta tills den har tagits bort.

Egenskap Värde
Parameter group: Wait Condition Arguments
Standardvärde: False
--exists

Vänta tills resursen finns.

Egenskap Värde
Parameter group: Wait Condition Arguments
Standardvärde: False
--expand

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 'resurs-ID' argumenten. Du bör ange antingen --id eller andra "Resurs-ID"-argument.

Egenskap Värde
Parameter group: Resource Id Arguments
--instance-id

Den virtuella datorns instans.

Egenskap Värde
Parameter group: Resource Id Arguments
--interval

Avsökningsintervall i sekunder.

Egenskap Värde
Parameter group: Wait Condition Arguments
Standardvärde: 30
--name --run-command-name -n

Namnet på VirtualMachineRunCommand.

Egenskap Värde
Parameter group: Resource Id Arguments
--resource-group -g

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

Egenskap Värde
Parameter group: Resource Id Arguments
--subscription

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

Egenskap Värde
Parameter group: Resource Id Arguments
--timeout

Maximal väntetid i sekunder.

Egenskap Värde
Parameter group: Wait Condition Arguments
Standardvärde: 3600
--updated

Vänta tills det har uppdaterats med provisioningState på Lyckades.

Egenskap Värde
Parameter group: Wait Condition Arguments
Standardvärde: False
--vmss-name

Namnet på VirtualMachineScaleSet.

Egenskap Värde
Parameter group: Resource Id Arguments
Globala parametrar
--debug

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

Egenskap Värde
Standardvärde: False
--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

Egenskap Värde
Standardvärde: False
--output -o

Utdataformat.

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

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

--verbose

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

Egenskap Värde
Standardvärde: False