az connectedmachine extension

Note

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

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

Команды

Имя	Описание	Тип	Состояние
az connectedmachine extension create	Создайте или обновите расширение.	Extension	GA
az connectedmachine extension delete	Операция удаления расширения.	Extension	GA
az connectedmachine extension image	Управление метаданными расширения виртуальной машины, доступными для серверов Arc-Enabled Azure.	Extension	GA
az connectedmachine extension image list	Вывод списка всех версий расширений на основе расположения, издателя, extensionType.	Extension	GA
az connectedmachine extension image show	Получение метаданных расширения на основе расположения, издателя, расширенияType и версии.	Extension	GA
az connectedmachine extension list	Получение всех расширений компьютера, отличного от Azure.	Extension	GA
az connectedmachine extension show	Получение операции получения расширения.	Extension	GA
az connectedmachine extension update	Операция обновления для создания или обновления расширения.	Extension	GA
az connectedmachine extension wait	Поместите интерфейс командной строки в состояние ожидания, пока не будет выполнено условие.	Extension	GA

az connectedmachine extension create

Создайте или обновите расширение.

az connectedmachine extension create --extension-name --name
                                     --machine-name
                                     --resource-group
                                     [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {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 --resource-group myResourceGroup --machine-name myMachine --extension-name CustomScriptExtension --location eastus2euap --publisher Microsoft.Compute --type-handler-version 1.10 --type CustomScriptExtension --settings "{commandToExecute:'powershell.exe -c "Get-Process | Where-Object { $_.CPU -gt 10000 }"'}"

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

--extension-name --name -n

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

--machine-name

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

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-upgrade-min --auto-upgrade-minor-version

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

Свойство	Значение
Parameter group:	Properties Arguments
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

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

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

Свойство	Значение
Parameter group:	Properties Arguments
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

--force-update-tag

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

Свойство	Значение
Parameter group:	Properties Arguments

--instance-view

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

Свойство	Значение
Parameter group:	Properties Arguments

--location -l

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

Свойство	Значение
Parameter group:	ExtensionParameters Arguments

--no-wait

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

Свойство	Значение
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

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

Свойство	Значение
Parameter group:	Properties Arguments

--publisher

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

Свойство	Значение
Parameter group:	Properties Arguments

--settings

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

Свойство	Значение
Parameter group:	Properties Arguments

--tags

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

Свойство	Значение
Parameter group:	ExtensionParameters Arguments

--type

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

Свойство	Значение
Parameter group:	Properties Arguments

--type-handler-version

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

Свойство	Значение
Parameter group:	Properties Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

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

Свойство	Значение
Default value:	False

az connectedmachine extension delete

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

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

Примеры

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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--extension-name --name -n

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--ids

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--machine-name

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--no-wait

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

Свойство	Значение
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

--resource-group -g

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--subscription

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--yes -y

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

Свойство	Значение
Default value:	False

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

Свойство	Значение
Default value:	False

az connectedmachine extension list

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

az connectedmachine extension list --machine-name
                                   --resource-group
                                   [--expand]
                                   [--max-items]
                                   [--next-token]

Примеры

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

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

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

--machine-name

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

--resource-group -g

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--expand

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

--max-items

Общее количество элементов, возвращаемых в выходных данных команды. Если общее количество доступных элементов превышает указанное значение, маркер предоставляется в выходных данных команды. Чтобы возобновить разбиение на страницы, укажите значение маркера в --next-token аргументе последующей команды.

Свойство	Значение
Parameter group:	Pagination Arguments

--next-token

Маркер, чтобы указать, где начать разбиение на страницы. Это значение маркера из ранее усеченного ответа.

Свойство	Значение
Parameter group:	Pagination Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--subscription

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

--verbose

Свойство	Значение
Default value:	False

az connectedmachine extension show

Получение операции получения расширения.

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

Примеры

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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--extension-name --name -n

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--ids

Свойство	Значение
Parameter group:	Resource Id Arguments

--machine-name

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--resource-group -g

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--subscription

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

Свойство	Значение
Parameter group:	Resource Id Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

Свойство	Значение
Default value:	False

az connectedmachine extension update

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

az connectedmachine extension update [--auto-upgrade-min --auto-upgrade-minor-version {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--enable-auto-upgrade --enable-automatic-upgrade {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--extension-name --name]
                                     [--force-update-tag]
                                     [--ids]
                                     [--machine-name]
                                     [--no-wait {0, 1, f, false, n, no, t, true, y, yes}]
                                     [--protected-settings]
                                     [--publisher]
                                     [--resource-group]
                                     [--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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--auto-upgrade-min --auto-upgrade-minor-version

Свойство	Значение
Parameter group:	Properties Arguments
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

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

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

Свойство	Значение
Parameter group:	Properties Arguments
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

--extension-name --name -n

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--force-update-tag

Свойство	Значение
Parameter group:	Properties Arguments

--ids

Свойство	Значение
Parameter group:	Resource Id Arguments

--machine-name

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--no-wait

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

Свойство	Значение
Допустимые значения:	0, 1, f, false, n, no, t, true, y, yes

--protected-settings

Свойство	Значение
Parameter group:	Properties Arguments

--publisher

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

Свойство	Значение
Parameter group:	Properties Arguments

--resource-group -g

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--settings

Свойство	Значение
Parameter group:	Properties Arguments

--subscription

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--tags

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

Свойство	Значение
Parameter group:	ExtensionParameters Arguments

--type

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

Свойство	Значение
Parameter group:	Properties Arguments

--type-handler-version

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

Свойство	Значение
Parameter group:	Properties Arguments

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

Свойство	Значение
Default value:	False

az connectedmachine extension wait

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

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

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

The following parameters are optional, but depending on the context, one or more might become required for the command to execute successfully.

--created

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

Свойство	Значение
Parameter group:	Wait Condition Arguments
Default value:	False

--custom

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

Свойство	Значение
Parameter group:	Wait Condition Arguments

--deleted

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

Свойство	Значение
Parameter group:	Wait Condition Arguments
Default value:	False

--exists

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

Свойство	Значение
Parameter group:	Wait Condition Arguments
Default value:	False

--extension-name --name -n

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--ids

Свойство	Значение
Parameter group:	Resource Id Arguments

--interval

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

Свойство	Значение
Parameter group:	Wait Condition Arguments
Default value:	30

--machine-name

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--resource-group -g

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--subscription

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

Свойство	Значение
Parameter group:	Resource Id Arguments

--timeout

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

Свойство	Значение
Parameter group:	Wait Condition Arguments
Default value:	3600

--updated

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

Свойство	Значение
Parameter group:	Wait Condition Arguments
Default value:	False

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

--debug

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

Свойство	Значение
Default value:	False

--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство	Значение
Default value:	False

--output -o

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

Свойство	Значение
Default value:	json
Допустимые значения:	json, jsonc, none, table, tsv, yaml, yamlc

--query

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

--verbose

Свойство	Значение
Default value:	False

Обратная связь

Были ли сведения на этой странице полезными?

Поделиться через

az connectedmachine extension

Команды

az connectedmachine extension create

Примеры

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

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

az connectedmachine extension delete

Примеры

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

az connectedmachine extension list

Примеры

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

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

az connectedmachine extension show

Примеры

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

az connectedmachine extension update

Примеры

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

az connectedmachine extension wait

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

Обратная связь