az vm run-command

  • Ссылка

Управление командами выполнения на виртуальной машине.

Дополнительные сведения см. в разделе https://docs.microsoft.com/azure/virtual-machines/windows/run-command или https://docs.microsoft.com/azure/virtual-machines/linux/run-command.

Команды

az vm run-command create

Операция для создания команды run.
az vm run-command delete

Операция удаления команды run.
az vm run-command invoke

Выполните определенную команду запуска на виртуальной машине.
az vm run-command list

Вывод списка команд выполнения из виртуальной машины или расположения.
az vm run-command show

Получение конкретной команды выполнения.
az vm run-command update

Операция обновления команды выполнения.
az vm run-command wait

Поместите CLI в состояние ожидания, пока не будет выполнено условие команды res virtual-machine-run-.

az vm run-command create

Изменить

Операция для создания команды 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]

Примеры

Создайте команду выполнения.

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"

Создайте команду выполнения с отправкой потока вывода скрипта в большой двоичный объект хранилища 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"

Обязательные параметры

--name --run-command-name

Имя команды выполнения виртуальной машины.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--vm-name

Имя виртуальной машины.

Необязательные параметры

--async-execution

Необязательный элемент. Если задано значение true, подготовка завершится сразу после запуска скрипта и не будет ожидать завершения скрипта.

допустимые значения: false, true
--command-id

Укажите commandId предопределенного встроенного скрипта.

--error-blob-uri

Укажите большой двоичный объект службы хранилища Azure, куда будет отправляться поток ошибок скрипта.

--location -l

Расположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--output-blob-uri

Укажите большой двоичный объект хранилища Azure (URI SAS), куда будет отправляться выходной поток скрипта.

--parameters

Параметры, используемые скриптом.

--protected-parameters

Параметры, используемые скриптом.

--run-as-password

Пароль, если это необходимо для использования параметра запуска от имени пользователя. Он будет зашифрован и не зарегистрирован.

--run-as-user

По умолчанию процесс скрипта выполняется под системным или корневым пользователем. Укажите пользовательского пользователя для размещения процесса.

--script

Укажите содержимое скрипта, выполняемого на виртуальной машине.

--script-uri

Укажите расположение для скачивания скрипта.

--tags

Разделенные пробелами теги: key[=value] [key[=value] ...]. Используйте "", чтобы очистить существующие теги.

--timeout-in-seconds

Время ожидания в секундах для выполнения команды выполнения.

az vm run-command delete

Изменить

Операция удаления команды run.

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

Примеры

Удаление команды выполнения.

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

Обязательные параметры

--name --run-command-name

Имя команды выполнения виртуальной машины.

Необязательные параметры

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах "Идентификатор ресурса". Необходимо указать аргументы --ids или другие аргументы "Идентификатор ресурса".

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--vm-name

Имя виртуальной машины.

--yes -y

Не запрашивать подтверждение.

значение по умолчанию: False

az vm run-command invoke

Изменить

Выполните определенную команду запуска на виртуальной машине.

az vm run-command show возвращает полезные сведения о каждой команде выполнения. Узнайте, как выполнить командный идентификатор с помощью az vmss run-command list.

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

Примеры

Установите nginx на виртуальной машине Linux.

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

Выполните команду оболочки на виртуальной машине Linux с параметрами.

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

Выполнение скрипта PowerShell на виртуальной машине Windows с параметрами. Встроенный скрипт. Будьте осторожны с одиночными кавыканиями в 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'

Выполнение скрипта PowerShell на виртуальной машине Windows с параметрами. Скрипт, предоставленный из файла.

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

Обязательные параметры

--command-id

Идентификатор команды.

значение из: az vm run-command list

Необязательные параметры

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах "Идентификатор ресурса". Необходимо указать аргументы --ids или другие аргументы "Идентификатор ресурса".

--name -n

Имя виртуальной машины. Вы можете настроить значение по умолчанию с помощью az configure --defaults vm=<name>.

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--parameters

Разделенные пробелами параметры в формате "[name=]value".

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--scripts

Строки скрипта, разделенные пробелами. Используйте @{file} для загрузки скрипта из файла.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

az vm run-command list

Изменить

Вывод списка команд выполнения из виртуальной машины или расположения.

Чтобы получить все команды выполнения виртуальной машины, можно указать "--resource-group" и "--vm-name". Или можно указать "--location", чтобы получить список всех доступных команд выполнения для подписки в расположении.

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

Примеры

Вывод списка команд выполнения на виртуальной машине.

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

Список всех доступных команд выполнения для подписки в расположении.

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

Необязательные параметры

--expand

Выражение expand, применяемое к операции.

--location -l

Расположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--vm-name

Имя виртуальной машины.

az vm run-command show

Изменить

Получение определенной команды выполнения.

Чтобы получить команду выполнения на виртуальной машине, можно указать "--resource-group", "--run-command-name" и "--vm-name". Или можно указать "--command-id" и "--location", чтобы получить команду выполнения для подписки в расположении.

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

Примеры

Получение команд выполнения на виртуальной машине.

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

Получение определенной команды запуска для подписки в расположении.

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

Необязательные параметры

--command-id

Идентификатор команды.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах "Идентификатор ресурса". Необходимо указать аргументы --ids или другие аргументы "Идентификатор ресурса".

--instance-view

Представление экземпляра команды выполнения.

значение по умолчанию: False
--location -l

Расположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name --run-command-name

Имя команды запуска виртуальной машины.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--vm-name

Имя виртуальной машины.

az vm run-command update

Изменить

Операция обновления команды 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]

Примеры

Обновите команду запуска.

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"

Обновите команду выполнения, отправив выходной поток скрипта в большой двоичный объект хранилища 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"

Обязательные параметры

--name --run-command-name

Имя команды запуска виртуальной машины.

Необязательные параметры

--async-execution

Необязательный элемент. Если задано значение true, подготовка завершится сразу после запуска скрипта и не будет ждать завершения скрипта.

допустимые значения: false, true
--command-id

Укажите commandId предопределенного встроенного скрипта.

--error-blob-uri

Укажите большой двоичный объект службы хранилища Azure, в который будет отправлен поток ошибок скрипта.

--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах "Идентификатор ресурса". Необходимо указать аргументы --ids или другие аргументы "Идентификатор ресурса".

--location -l

Расположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--output-blob-uri

Укажите большой двоичный объект хранилища Azure (URI SAS), куда будет отправляться выходной поток скрипта.

--parameters

Параметры, используемые скриптом.

--protected-parameters

Параметры, используемые скриптом.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--run-as-password

Пароль при необходимости для использования параметра запуска от имени пользователя. Она будет зашифрована и не заносится в журнал.

--run-as-user

По умолчанию процесс скрипта выполняется под системным или корневым пользователем. Укажите пользовательского пользователя для размещения процесса.

--script

Укажите содержимое скрипта, который будет выполняться на виртуальной машине.

--script-uri

Укажите расположение для скачивания скрипта.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--tags

Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "", чтобы очистить существующие теги.

--timeout-in-seconds

Время ожидания в секундах для выполнения команды выполнения.

--vm-name

Имя виртуальной машины.

az vm run-command wait

Изменить

Поместите CLI в состояние ожидания, пока не будет выполнено условие команды res virtual-machine-run-.

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

Необязательные параметры

--command-id

Идентификатор команды.

--created

Дождитесь создания с параметром "provisioningState" в "Успешно".

значение по умолчанию: False
--custom

Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Дождитесь удаления.

значение по умолчанию: False
--exists

Дождитесь появления ресурса.

значение по умолчанию: False
--ids

Один или несколько идентификаторов ресурсов (через пробелы). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах "Идентификатор ресурса". Необходимо указать аргументы --ids или другие аргументы "Идентификатор ресурса".

--instance-view

Представление экземпляра команды выполнения.

значение по умолчанию: False
--interval

Интервал опроса в секундах.

значение по умолчанию: 30
--location -l

Расположение. Значения из az account list-locations. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>.

--name --run-command-name

Имя команды запуска виртуальной машины.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--timeout

Максимальное время ожидания в секундах.

значение по умолчанию: 3600
--updated

Дождитесь обновления с параметром provisioningState в "Успешно".

значение по умолчанию: False
--vm-name

Имя виртуальной машины.