az connectedmachine extension

  • Ссылка

Примечание.

Эта ссылка является частью расширения connectedmachine для Azure CLI (версия 2.49.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды расширения az connectedmachine . Подробнее о расширениях.

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

Команды

Имя Описание Тип Состояние
az connectedmachine extension create

Операция создания расширения.

 Расширение Общедоступная версия
az connectedmachine extension delete

Операция удаления расширения.

 Расширение Общедоступная версия
az connectedmachine extension image

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

 Расширение Общедоступная версия
az connectedmachine extension image list

Вывод списка всех версий расширений на основе расположения, издателя, extensionType.

 Расширение Общедоступная версия
az connectedmachine extension image show

Получение метаданных расширения на основе расположения, издателя, расширенияType и версии.

 Расширение Общедоступная версия
az connectedmachine extension list

Операция получения всех расширений компьютера, отличного от Azure.

 Расширение Общедоступная версия
az connectedmachine extension show

Операция создания или обновления расширения.

 Расширение Общедоступная версия
az connectedmachine extension update

Операция обновления для обновления расширения.

 Расширение Общедоступная версия
az connectedmachine extension wait

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

 Расширение Общедоступная версия

az connectedmachine extension create

Операция создания расширения.

az connectedmachine extension create --extension-name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--auto-upgrade-minor {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--instance-view]
                                     [--location]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--settings]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Примеры

Пример команды для создания расширения

az connectedmachine extension create --name CustomScriptExtension --location eastus2euap --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

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

--extension-name --name -n

Имя расширения компьютера.

--machine-name

Имя компьютера, в котором должно быть создано или обновлено расширение.

--resource-group -g

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

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

--auto-upgrade --enable-auto-upgrade --enable-automatic-upgrade

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--auto-upgrade-minor --auto-upgrade-minor-version --upgrade-minor-ver

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--force-update-tag

Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась.

--instance-view

Представление экземпляра расширения компьютера. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--location -l

Географическое расположение, в котором находится ресурс, если он не указан, будет использоваться расположение группы ресурсов.

--no-wait

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--protected-settings

Расширение может содержать защищенные Параметры или защищенные Параметры FromKeyVault или не защищенные параметры. Поддержка json-file и yaml-file.

--publisher

Имя издателя обработчика расширений.

--settings

Форматированные общедоступные параметры json для расширения. Поддержка json-file и yaml-file.

--tags

Теги ресурсов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--type

Указывает тип расширения; примером является CustomScriptExtension.

--type-handler-version

Указывает версию обработчика скрипта.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az connectedmachine extension delete

Операция удаления расширения.

az connectedmachine extension delete [--extension-name]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--resource-group]
                                     [--subscription]
                                     [--yes]

Примеры

Пример команды удаления расширения

az connectedmachine extension delete --name myName --machine-name myMachine --resource-group myResourceGroup

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

--extension-name --name -n

Имя расширения компьютера.

--ids

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

--machine-name

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

--no-wait

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--resource-group -g

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

--subscription

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

--yes -y

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

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az connectedmachine extension list

Операция получения всех расширений компьютера, отличного от Azure.

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]

Примеры

Пример команды для списка расширений

az connectedmachine extension list --machine-name myMachine --resource-group myResourceGroup

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

--machine-name

Имя компьютера, содержащего расширение.

--resource-group -g

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

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

--expand

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

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az connectedmachine extension show

Операция создания или обновления расширения.

az connectedmachine extension show [--extension-name]
                                   [--ids]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]

Примеры

Пример команды для отображения расширения

az connectedmachine extension show --name CustomScriptExtension --machine-name myMachine --resource-group myResourceGroup

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

--extension-name --name -n

Имя расширения компьютера.

--ids

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

--machine-name

Имя компьютера, содержащего расширение.

--resource-group -g

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

--subscription

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

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az connectedmachine extension update

Операция обновления для обновления расширения.

az connectedmachine extension update [--add]
                                     [--auto-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--auto-upgrade-minor {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--extension-name]
                                     [--force-string {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--force-update-tag]
                                     [--ids]
                                     [--instance-view]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--remove]
                                     [--resource-group]
                                     [--set]
                                     [--settings]
                                     [--subscription]
                                     [--tags]
                                     [--type]
                                     [--type-handler-version]

Примеры

Пример команды для обновления расширения

az connectedmachine extension update --name CustomScriptExtension --type CustomScriptExtension --publisher Microsoft.Compute --type-handler-version 1.10 --machine-name myMachine --resource-group myResourceGroup

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

--add

Добавьте объект в список объектов, указав пары пути и значения ключа. Пример: --add property.listProperty <key=value, string или JSON string>.

--auto-upgrade --enable-auto-upgrade --enable-automatic-upgrade

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--auto-upgrade-minor --auto-upgrade-minor-version --upgrade-minor-ver

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--extension-name --name -n

Имя расширения компьютера.

--force-string

При использовании "set" или "add" сохраняйте строковые литералы вместо попытки преобразовать в JSON.

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--force-update-tag

Как обработчик расширений должен быть вынужден обновляться, даже если конфигурация расширения не изменилась.

--ids

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

--instance-view

Представление экземпляра расширения компьютера. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--machine-name

Имя компьютера, содержащего расширение.

--no-wait

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

допустимые значения: 0, 1, f, false, n, no, t, true, y, yes
--protected-settings

Расширение может содержать защищенные Параметры или защищенные Параметры FromKeyVault или не защищенные параметры. Поддержка json-file и yaml-file.

--publisher

Имя издателя обработчика расширений.

--remove

Удалите свойство или элемент из списка. Пример: --remove property.list OR --remove propertyToRemove.

--resource-group -g

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

--set

Обновите объект, указав путь к свойству и значение для задания. Пример: --set property1.property2=.

--settings

Форматированные общедоступные параметры json для расширения. Поддержка json-file и yaml-file.

--subscription

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

--tags

Теги ресурсов. Поддержка сокращенного синтаксиса, json-file и yaml-file. Попробуйте "??", чтобы показать больше.

--type

Указывает тип расширения; примером является CustomScriptExtension.

--type-handler-version

Указывает версию обработчика скрипта.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az connectedmachine extension wait

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

az connectedmachine extension wait [--created]
                                   [--custom]
                                   [--deleted]
                                   [--exists]
                                   [--extension-name]
                                   [--ids]
                                   [--interval]
                                   [--machine-name]
                                   [--resource-group]
                                   [--subscription]
                                   [--timeout]
                                   [--updated]

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

--created

Подождите, пока не будет создано с помощью provisioningState по адресу "Успешно".

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

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

--deleted

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

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

Подождите, пока ресурс не существует.

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

Имя расширения компьютера.

--ids

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

--interval

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

значение по умолчанию: 30
--machine-name

Имя компьютера, содержащего расширение.

--resource-group -g

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

--subscription

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

--timeout

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

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

Подождите, пока не будет обновлено с помощью provisioningState по адресу "Успешно".

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

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

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.