az vm run-command
Управление командами выполнения на виртуальной машине.
Дополнительные сведения см. в разделе https://learn.microsoft.com/azure/virtual-machines/windows/run-command или https://learn.microsoft.com/azure/virtual-machines/linux/run-command.
Команды
Имя | Описание | Тип | Состояние |
---|---|---|---|
az vm run-command create |
Операция создания команды выполнения. |
Ядро | ГА |
az vm run-command delete |
Операция удаления команды выполнения. |
Ядро | ГА |
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 |
Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие команды res virtual-machine-run-run.. |
Ядро | ГА |
az vm run-command create
Операция создания команды выполнения.
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"
Создайте команду выполнения с отправкой потока выходных данных скрипта в BLOB-объект хранилища 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"
Обязательные параметры
Имя команды запуска виртуальной машины.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя виртуальной машины.
Необязательные параметры
Необязательный. Если задано значение true, подготовка завершится сразу после запуска скрипта и не будет ожидать завершения скрипта.
Укажите идентификатор командной строки предопределенного встроенного скрипта.
Укажите большой двоичный объект хранилища Azure, в котором будет отправлен поток ошибок скрипта.
Местоположение. Значения из: az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Не дождитесь завершения длительной операции.
Укажите большой двоичный объект хранилища Azure (URI SAS), в котором будет отправлен выходной поток скрипта.
Параметры, используемые скриптом.
Использование: --parameters arg1=XX arg2=XX.
Параметры, используемые скриптом.
Использование: --protected-parameters credentials=somefoo secret=somebar.
Пароль при необходимости для использования параметра run-as-user. Он будет зашифрован и не зарегистрирован.
По умолчанию процесс скрипта выполняется под системным или корневым пользователем. Укажите настраиваемого пользователя для размещения процесса.
Укажите содержимое скрипта, выполняемого на виртуальной машине.
Укажите расположение загрузки скрипта.
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Время ожидания в секундах для выполнения команды выполнения.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az vm run-command delete
Операция удаления команды выполнения.
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"
Обязательные параметры
Имя команды запуска виртуальной машины.
Необязательные параметры
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Не дождитесь завершения длительной операции.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Имя виртуальной машины.
Не запрашивайте подтверждение.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az vm run-command invoke
Выполните определенную команду запуска на виртуальной машине.
az vm run-command show
возвращает полезные сведения о каждой команде выполнения. Обнаружение идентификатора команды run с помощью 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"
Обязательные параметры
Идентификатор команды.
Необязательные параметры
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Имя виртуальной машины. Можно настроить значение по умолчанию с помощью az configure --defaults vm=<name>
.
Не дождитесь завершения длительной операции.
Разделенные пробелами параметры в формате "[name=]value".
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Строки скрипта, разделенные пробелами. Используйте @{file} для загрузки скрипта из файла.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
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"
Необязательные параметры
Выражение расширения, применяемое к операции.
Местоположение. Значения из: az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя виртуальной машины.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az vm run-command show
Получите определенную команду запуска.
Вы можете указать "--resource-group", "--run-command-name" и "--vm-name", чтобы получить команду выполнения в виртуальной машине. Кроме того, можно указать "--command-id" и "-location", чтобы получить команду выполнения для подписки в расположении.
az vm run-command show [--command-id]
[--expand]
[--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"
Необязательные параметры
Идентификатор команды.
Аргумент "expand" устарел и будет удален в будущем выпуске.
Выражение расширения, применяемое к операции.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Представление экземпляра команды выполнения.
Местоположение. Значения из: az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Имя команды запуска виртуальной машины.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Имя виртуальной машины.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az vm run-command update
Операция обновления команды выполнения.
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"
Обязательные параметры
Имя команды запуска виртуальной машины.
Необязательные параметры
Необязательный. Если задано значение true, подготовка завершится сразу после запуска скрипта и не будет ожидать завершения скрипта.
Укажите идентификатор командной строки предопределенного встроенного скрипта.
Укажите большой двоичный объект хранилища Azure, в котором будет отправлен поток ошибок скрипта.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Местоположение. Значения из: az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Не дождитесь завершения длительной операции.
Укажите большой двоичный объект хранилища Azure (URI SAS), в котором будет отправлен выходной поток скрипта.
Параметры, используемые скриптом.
Использование: --parameters arg1=XX arg2=XX.
Параметры, используемые скриптом.
Использование: --protected-parameters credentials=somefoo secret=somebar.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Пароль при необходимости для использования параметра run-as-user. Он будет зашифрован и не зарегистрирован.
По умолчанию процесс скрипта выполняется под системным или корневым пользователем. Укажите настраиваемого пользователя для размещения процесса.
Укажите содержимое скрипта, выполняемого на виртуальной машине.
Укажите расположение загрузки скрипта.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Теги, разделенные пробелами: key[=value] [key[=value] ...]. Используйте "" для очистки существующих тегов.
Время ожидания в секундах для выполнения команды выполнения.
Имя виртуальной машины.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.
az vm run-command wait
Поместите интерфейс командной строки в состояние ожидания до тех пор, пока не будет выполнено условие команды res virtual-machine-run-run..
az vm run-command wait [--command-id]
[--created]
[--custom]
[--deleted]
[--exists]
[--expand]
[--ids]
[--instance-view]
[--interval]
[--location]
[--name]
[--resource-group]
[--subscription]
[--timeout]
[--updated]
[--vm-name]
Необязательные параметры
Идентификатор команды.
Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".
Подождите, пока условие не будет удовлетворено пользовательским запросом JMESPath. Например, provisioningState!='InProgress', instanceView.statuses[?code='PowerState/running'].
Дождитесь удаления.
Подождите, пока ресурс не существует.
Аргумент "expand" устарел и будет удален в будущем выпуске.
Выражение расширения, применяемое к операции.
Один или несколько идентификаторов ресурсов (разделенных пробелами). Это должен быть полный идентификатор ресурса, содержащий все сведения о аргументах Resource Id. Необходимо указать аргументы --ids или другие аргументы Resource Id.
Представление экземпляра команды выполнения.
Интервал опроса в секундах.
Местоположение. Значения из: az account list-locations
. Расположение по умолчанию можно настроить с помощью az configure --defaults location=<location>
.
Имя команды запуска виртуальной машины.
Имя группы ресурсов. Группу по умолчанию можно настроить с помощью az configure --defaults group=<name>
.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Максимальное ожидание в секундах.
Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".
Имя виртуальной машины.
Глобальные параметры
Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.
Отображение этого сообщения справки и выхода.
Отображаются только ошибки, подавляющие предупреждения.
Формат вывода.
Строка запроса JMESPath. Дополнительные сведения и примеры см. в http://jmespath.org/.
Имя или идентификатор подписки. Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID
.
Увеличьте детализацию ведения журнала. Используйте --debug для полных журналов отладки.