az vm run-command

  • Reference

Správa příkazů spuštění na virtuálním počítači

Další informace naleznete v tématech https://docs.microsoft.com/azure/virtual-machines/windows/run-command a https://docs.microsoft.com/azure/virtual-machines/linux/run-command.

Příkazy

Name Description Typ Stav
az vm run-command create

Operace pro vytvoření příkazu run.

 Základ GA
az vm run-command delete

Operace pro odstranění příkazu run.

 Základ GA
az vm run-command invoke

Na virtuálním počítači spusťte konkrétní příkaz spuštění.

 Základ GA
az vm run-command list

Vypíše příkazy spuštění z virtuálního počítače nebo umístění.

 Základ GA
az vm run-command show

Získejte konkrétní příkaz pro spuštění.

 Základ GA
az vm run-command update

Operace pro aktualizaci příkazu run.

 Základ GA
az vm run-command wait

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka příkazu res virtual-machine-run-command.

 Základ GA

az vm run-command create

Upravit

Operace pro vytvoření příkazu run.

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]

Příklady

Vytvořte příkaz pro spuštění.

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"

Vytvořte příkaz spuštění s nahráním výstupního streamu skriptu do objektu blob úložiště Azure (URI SAS).

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"

Povinné parametry

--name --run-command-name

Název příkazu spuštění virtuálního počítače.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--vm-name

Název virtuálního počítače.

Volitelné parametry

--async-execution

Nepovinné. Pokud je hodnota true, zřizování se dokončí, jakmile se skript spustí a nečeká na dokončení skriptu.

Přípustné hodnoty: false, true
--command-id

Zadejte commandId předdefinovaného předdefinovaného skriptu.

--error-blob-uri

Zadejte objekt blob úložiště Azure, ve kterém se nahraje datový proud chyb skriptu.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--output-blob-uri

Zadejte objekt blob úložiště Azure (URI SAS), kde se nahraje výstupní datový proud skriptu.

--parameters

Parametry používané skriptem.

Použití: --parameters arg1=XX arg2=XX.

--protected-parameters

Parametry používané skriptem.

Použití: --protected-parameters credentials=somefoo secret=somebar.

--run-as-password

Heslo v případě potřeby pro použití parametru run-as-user Zašifruje se a nezaprotokoluje.

--run-as-user

Ve výchozím nastavení se proces skriptu spouští pod systémovým nebo kořenovým uživatelem. Zadejte vlastního uživatele, který má být hostitelem procesu.

--script

Zadejte obsah skriptu, který se má na virtuálním počítači spustit.

--script-uri

Zadejte umístění pro stažení skriptu.

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--timeout-in-seconds

Časový limit v sekundách pro spuštění příkazu.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm run-command delete

Upravit

Operace pro odstranění příkazu run.

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

Příklady

Odstraňte příkaz spustit.

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

Povinné parametry

--name --run-command-name

Název příkazu spuštění virtuálního počítače.

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače.

--yes -y

Nezotvádejte výzvu k potvrzení.

Default value: False
Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm run-command invoke

Upravit

Na virtuálním počítači spusťte konkrétní příkaz spuštění.

az vm run-command show vrátí užitečné informace o každém příkazu run-command. Zjišťování příkazu Run command-id přes az vmss run-command list.

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

Příklady

Nainstalujte nginx na virtuální počítač s Linuxem.

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

Spusťte příkaz shellu na virtuálním počítači s Linuxem s parametry.

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

Spusťte skript PowerShellu na virtuálním počítači s Windows s parametry. Skript zadaný vložený. Buďte opatrní na jedno-quoting v 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'

Spusťte skript PowerShellu na virtuálním počítači s Windows s parametry. Skript zadaný ze souboru

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

Povinné parametry

--command-id

ID příkazu.

Počáteční hodnota: az vm run-command list

Volitelné parametry

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--name -n

Název virtuálního počítače. Výchozí nastavení můžete nakonfigurovat pomocí az configure --defaults vm=<name>.

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--parameters

Parametry oddělené mezerami ve formátu [name=]value

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--scripts

Řádky skriptu oddělené mezerami. K načtení skriptu ze souboru použijte soubor @{file}.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm run-command list

Upravit

Vypíše příkazy spuštění z virtuálního počítače nebo umístění.

Můžete zadat "--resource-group" a "--vm-name" a získat všechny příkazy spuštění virtuálního počítače. Nebo můžete zadat "--location" a zobrazit seznam všech dostupných příkazů spuštění pro předplatné v umístění.

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

Příklady

Výpis příkazů spuštění ve virtuálním počítači

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

Vypište všechny dostupné příkazy pro spuštění předplatného v umístění.

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

Volitelné parametry

--expand

Výraz rozbalení, který se má použít pro operaci.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm run-command show

Upravit

Získejte konkrétní příkaz pro spuštění.

Můžete zadat "--resource-group", "--run-command-name" a "--vm-name" a získat příkaz pro spuštění ve virtuálním počítači. Nebo můžete zadat --command-id a--location, abyste získali příkaz pro spuštění předplatného v umístění.

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

Příklady

Získejte příkazy spuštění ve virtuálním počítači.

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

Získejte konkrétní příkaz pro spuštění předplatného v umístění.

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

Volitelné parametry

--command-id

ID příkazu.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--instance-view

Zobrazení instance příkazu spustit.

Default value: False
--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--name --run-command-name

Název příkazu spuštění virtuálního počítače.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm run-command update

Upravit

Operace pro aktualizaci příkazu run.

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]

Příklady

Aktualizujte příkaz pro spuštění.

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"

Aktualizujte příkaz spuštění s využitím nahrání výstupního streamu skriptu do objektu blob úložiště Azure (URI SAS).

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"

Povinné parametry

--name --run-command-name

Název příkazu spuštění virtuálního počítače.

Volitelné parametry

--async-execution

Nepovinné. Pokud je hodnota true, zřizování se dokončí, jakmile se skript spustí a nečeká na dokončení skriptu.

Přípustné hodnoty: false, true
--command-id

Zadejte commandId předdefinovaného předdefinovaného skriptu.

--error-blob-uri

Zadejte objekt blob úložiště Azure, ve kterém se nahraje datový proud chyb skriptu.

--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--no-wait

Nečekejte na dokončení dlouhotrvající operace.

Default value: False
--output-blob-uri

Zadejte objekt blob úložiště Azure (URI SAS), kde se nahraje výstupní datový proud skriptu.

--parameters

Parametry používané skriptem.

Použití: --parameters arg1=XX arg2=XX.

--protected-parameters

Parametry používané skriptem.

Použití: --protected-parameters credentials=somefoo secret=somebar.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--run-as-password

Heslo v případě potřeby pro použití parametru run-as-user Zašifruje se a nezaprotokoluje.

--run-as-user

Ve výchozím nastavení se proces skriptu spouští pod systémovým nebo kořenovým uživatelem. Zadejte vlastního uživatele, který má být hostitelem procesu.

--script

Zadejte obsah skriptu, který se má na virtuálním počítači spustit.

--script-uri

Zadejte umístění pro stažení skriptu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--tags

Značky oddělené mezerami: klíč[=hodnota] [klíč[=hodnota] ...]. K vymazání existujících značek použijte "".

--timeout-in-seconds

Časový limit v sekundách pro spuštění příkazu.

--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az vm run-command wait

Upravit

Umístěte rozhraní příkazového řádku do stavu čekání, dokud nebude splněna podmínka příkazu res virtual-machine-run-command.

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

Volitelné parametry

--command-id

ID příkazu.

--created

Počkejte na vytvoření s 'provisioningState' v 'Succeeded'.

Default value: False
--custom

Počkejte, až podmínka splňuje vlastní dotaz JMESPath. Například provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Počkejte na odstranění.

Default value: False
--exists

Počkejte, až prostředek existuje.

Default value: False
--ids

Jedno nebo více ID prostředků (oddělených mezerami) Mělo by se jednat o úplné ID prostředku obsahující všechny informace o argumentech ID prostředku. Měli byste zadat argumenty --ids nebo jiné argumenty ID prostředku.

--instance-view

Zobrazení instance příkazu spustit.

Default value: False
--interval

Interval dotazování v sekundách

Default value: 30
--location -l

Umístění. Hodnoty z: az account list-locations. Výchozí umístění můžete nakonfigurovat pomocí .az configure --defaults location=<location>

--name --run-command-name

Název příkazu spuštění virtuálního počítače.

--resource-group -g

Název skupiny prostředků. Výchozí skupinu můžete nakonfigurovat pomocí az configure --defaults group=<name>.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--timeout

Maximální čekání v sekundách.

Default value: 3600
--updated

Počkejte, dokud se neaktualizuje stav zřizování ve stavu Úspěch.

Default value: False
--vm-name

Název virtuálního počítače.

Globální parametry
--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

Řetězec dotazu JMESPath Další http://jmespath.org/ informace a příklady najdete v tématu.

--subscription

Název nebo ID předplatného. Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.