Dela via


az vm run-command

Kommandon

Name Description Typ Status
az vm run-command create

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

Kärna Allmän tillgänglighet
az vm run-command delete

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

Kärna Allmän tillgänglighet
az vm run-command invoke

Kör ett specifikt körningskommando på en virtuell dator.

Kärna Allmän tillgänglighet
az vm run-command list

Visa en lista över körningskommandon från en virtuell dator eller en plats.

Kärna Allmän tillgänglighet
az vm run-command show

Hämta ett specifikt körningskommando.

Kärna Allmän tillgänglighet
az vm run-command update

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

Kärna Allmän tillgänglighet
az vm run-command wait

Placera CLI i vänteläge tills ett villkor för kommandot res virtual-machine-run-är uppfyllt.

Kärna Allmän tillgänglighet

az vm run-command create

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

az vm run-command create --name
                         --resource-group
                         --vm-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 ett körningskommando.

az vm run-command create --resource-group "myResourceGroup" --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" --vm-name "myVM"

Skapa ett körningskommando med uppladdning av skriptutdataström till Azure Storage Blob (SAS URI).

az vm run-command create --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --run-command-name "myRunCommand" --vm-name "myVM" --output-blob-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D"

Obligatoriska parametrar

--name --run-command-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--vm-name

Namnet på den virtuella datorn.

Valfria parametrar

--async-execution

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

Ange den Azure Storage-blob där skriptfelströmmen ska 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

Ange den Azure Storage-blob (SAS-URI) där skriptutdataströmmen ska 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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az vm run-command delete

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

az vm run-command delete --name
                         [--ids]
                         [--no-wait]
                         [--resource-group]
                         [--subscription]
                         [--vm-name]
                         [--yes]

Exempel

Ta bort ett körningskommando.

az vm run-command delete --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"

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.

--no-wait

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

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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--vm-name

Namnet på den virtuella datorn.

--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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az vm run-command invoke

Kör ett specifikt körningskommando på en virtuell dator.

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

az vm run-command invoke --command-id
                         [--ids]
                         [--name]
                         [--no-wait]
                         [--parameters]
                         [--resource-group]
                         [--scripts]
                         [--subscription]

Exempel

Installera nginx på en virtuell Linux-dator.

az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts "sudo apt-get update && sudo apt-get install -y nginx"

Kör shell-kommandot på en virtuell Linux-dator med parametrar.

az vm run-command invoke -g MyResourceGroup -n MyVm --command-id RunShellScript --scripts 'echo $1 $2' --parameters hello world

Kör PowerShell-skript på en virtuell Windows-dator med parametrar. Skriptet har angetts infogat. Var försiktig med enkla citat i CMD.exe.

az vm 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'

Kör PowerShell-skript på en virtuell Windows-dator 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 vm run-command invoke  --command-id RunPowerShellScript --name win-vm -g my-resource-group \
    --scripts @script.ps1 --parameters "arg1=somefoo" "arg2=somebar"

Obligatoriska parametrar

--command-id

Kommando-ID:t.

Värde från: az vm 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.

--name -n

Namnet på den virtuella datorn. Du kan konfigurera standardinställningen med .az configure --defaults vm=<name>

--no-wait

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

Standardvärde: False
--parameters

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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 prenumerationen. Du kan konfigurera standardprenumerationen med .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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az vm run-command list

Visa en lista över körningskommandon från en virtuell dator eller en plats.

Du kan ange "--resource-group" och "--vm-name" för att hämta alla körningskommandon för en virtuell dator. Eller så kan du ange "--location" för att visa alla tillgängliga körningskommandon för en prenumeration på en plats.

az vm run-command list [--expand]
                       [--location]
                       [--resource-group]
                       [--vm-name]

Exempel

Visa en lista över körningskommandon på en virtuell dator.

az vm run-command list --resource-group "myResourceGroup" --vm-name "myVM"

Visa en lista över alla tillgängliga körningskommandon för en prenumeration på en plats.

az vm run-command list --location "SoutheastAsia"

Valfria parametrar

--expand

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

--location -l

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--vm-name

Namnet på den virtuella datorn.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az vm run-command show

Hämta ett specifikt körningskommando.

Du kan ange "--resource-group", "--run-command-name" och "--vm-name" för att hämta körningskommandot på en virtuell dator. Du kan också ange "--command-id" och "--location" för att hämta körningskommandot för en prenumeration på en plats.

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

Exempel

Hämta körningskommandona på en virtuell dator.

az vm run-command show --resource-group "myResourceGroup" --run-command-name "myRunCommand" --vm-name "myVM"

Hämta ett specifikt körningskommando för en prenumeration på en plats.

az vm run-command show --command-id "RunPowerShellScript" --location "SoutheastAsia"

Valfria parametrar

--command-id

Kommando-ID:t.

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

Instansvyn för ett körningskommando.

Standardvärde: False
--location -l

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

--name --run-command-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--vm-name

Namnet på den virtuella datorn.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az vm run-command update

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

az vm run-command update --name
                         [--async-execution {false, true}]
                         [--command-id]
                         [--error-blob-uri]
                         [--ids]
                         [--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]
                         [--vm-name]

Exempel

Uppdatera ett körningskommando.

az vm run-command update --resource-group "myResourceGroup" --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" --vm-name "myVM"

Uppdatera ett körningskommando med uppladdning av skriptutdataström till Azure Storage Blob (SAS URI).

az vm run-command update --resource-group "myResourceGroup" --location "West US" --script "Write-Host Hello World!" --run-command-name "myRunCommand" --vm-name "myVM" --output-blob-uri "https://mystorageaccount.blob.core.windows.net/mycontainer/RuncommandOutput.txt?sp=racw&st=2022-10-17T19:02:15Z&se=2022-10-18T03:02:15Z&spr=https&sv=2021-06-08&sr=b&sig=3BxtEasfdasdfasdfdYki9yvYsqc60V0%3D"

Obligatoriska parametrar

--name --run-command-name

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

Valfria parametrar

--async-execution

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

Ange den Azure Storage-blob där skriptfelströmmen ska 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.

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

Ange den Azure Storage-blob (SAS-URI) där skriptutdataströmmen ska 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

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .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 prenumerationen. Du kan konfigurera standardprenumerationen med .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.

--vm-name

Namnet på den virtuella datorn.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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

az vm run-command wait

Placera CLI i vänteläge tills ett villkor för kommandot res virtual-machine-run-är uppfyllt.

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

Valfria parametrar

--command-id

Kommando-ID:t.

--created

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

Standardvärde: False
--custom

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

--deleted

Vänta tills den har tagits bort.

Standardvärde: False
--exists

Vänta tills resursen finns.

Standardvärde: False
--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-view

Instansvyn för ett körningskommando.

Standardvärde: False
--interval

Avsökningsintervall i sekunder.

Standardvärde: 30
--location -l

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

--name --run-command-name

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

--resource-group -g

Namnet på resursgruppen. Du kan konfigurera standardgruppen med .az configure --defaults group=<name>

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--timeout

Maximal väntetid i sekunder.

Standardvärde: 3600
--updated

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

Standardvärde: False
--vm-name

Namnet på den virtuella datorn.

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 http://jmespath.org/ information och exempel finns i.

--subscription

Namn eller ID för prenumerationen. Du kan konfigurera standardprenumerationen med .az account set -s NAME_OR_ID

--verbose

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