az guestconfig guest-configuration-assignment

  • Экспериментальный
  • Ссылка

Примечание.

Эта ссылка является частью расширения гостевой конфигурации для Azure CLI (версия 2.3.1 или более поздней). Расширение автоматически установит команду az guestconfig guest-configuration-assignment . Подробнее о расширениях.

Эта группа команд экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Назначение гостевой конфигурации гостевой конфигурации.

Команды

Имя Описание Тип Состояние
az guestconfig guest-configuration-assignment create

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

 Расширение Экспериментальный
az guestconfig guest-configuration-assignment delete

Удаление назначения гостевой конфигурации.

 Расширение Экспериментальный
az guestconfig guest-configuration-assignment list

Список всех назначений гостевой конфигурации для виртуальной машины.

 Расширение Экспериментальный
az guestconfig guest-configuration-assignment show

Получение сведений о назначении гостевой конфигурации.

 Расширение Экспериментальный
az guestconfig guest-configuration-assignment update

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

 Расширение Экспериментальный
az guestconfig guest-configuration-assignment wait

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

 Расширение Экспериментальный

az guestconfig guest-configuration-assignment create

Экспериментальный

Группа команд "guestconfig guest-configuration-assignment" экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name
                                                     --resource-group
                                                     --vm-name
                                                     [--context]
                                                     [--guest-configuration-configuration-parameter]
                                                     [--guest-configuration-configuration-setting]
                                                     [--guest-configuration-name]
                                                     [--guest-configuration-version]
                                                     [--latest-assignment-report-assignment]
                                                     [--location]
                                                     [--name]
                                                     [--no-wait]

Примеры

Создание или обновление назначения гостевой конфигурации

az guestconfig guest-configuration-assignment create --guest-configuration-assignment-name "WhitelistedApplication" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName" --vm-name "myVMName"

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

--guest-configuration-assignment-name

Имя назначения гостевой конфигурации.

--resource-group -g

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

--vm-name

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

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

--context

Источник, инициирующий назначение гостевой конфигурации. Например, Политика Azure.

--guest-configuration-configuration-parameter

Параметры конфигурации гостевой конфигурации.

Использование: --guest-configuration-configuration-parameter name=XX value=XX

имя: имя параметра конфигурации. значение: значение параметра конфигурации.

Несколько действий можно указать с помощью нескольких аргументов --guest-configuration-configuration-parameter.

--guest-configuration-configuration-setting

Параметр конфигурации для гостевой конфигурации.

Использование: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX

режим конфигурации. Указывает, как LCM(Local Configuration Manager) фактически применяет конфигурацию к целевым узлам. Возможные значения: ApplyOnly, ApplyAndMonitor и ApplyAndAutoCorrect. allow-module-overwrite: если значение true — новые конфигурации, скачанные из службы извлечения, могут перезаписать старые конфигурации на целевом узле. В противном случае ложное действие после перезагрузки: указывает, что происходит после перезагрузки во время приложения конфигурации. Возможные значения: ContinueConfiguration и StopConfiguration refresh-frequency-mins: интервал времени в минутах, в течение которого LCM проверка службу извлечения для получения обновленных конфигураций. Это значение пропускается, если LCM не настроен в режиме запроса. Значение по умолчанию — 30. при необходимости перезагрузка. Установите для этого значение true, чтобы автоматически перезагрузить узел после настройки, требующей перезагрузки. В противном случае для каждой такой конфигурации узел придется перезагружать вручную. По умолчанию используется значение false. Чтобы использовать этот параметр, если условие перезагрузки инициируется не с помощью DSC (а например, установщика Windows), объедините этот параметр с модулем xPendingReboot. частота конфигурации: как часто, в минутах, текущая конфигурация проверка применяется и применяется. Это свойство игнорируется, если свойство ConfigurationMode имеет значение ApplyOnly. Значение по умолчанию ― 15.

--guest-configuration-name

Имя гостевой конфигурации.

--guest-configuration-version

Версия гостевой конфигурации.

--latest-assignment-report-assignment

Сведения о конфигурации назначения гостевой конфигурации. Ожидаемое значение: json-string/@json-file.

--location -l

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

--name

Имя назначения гостевой конфигурации.

--no-wait

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

значение по умолчанию: 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 guestconfig guest-configuration-assignment delete

Экспериментальный

Группа команд "guestconfig guest-configuration-assignment" экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Удаление назначения гостевой конфигурации.

az guestconfig guest-configuration-assignment delete [--ids]
                                                     [--name]
                                                     [--no-wait]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--vm-name]

Примеры

Удаление назначения гостевой конфигурации

az guestconfig guest-configuration-assignment delete --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

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

--ids

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

--name -n

Имя назначения гостевой конфигурации.

--no-wait

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

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

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

--subscription

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

--vm-name

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

Глобальные параметры
--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 guestconfig guest-configuration-assignment list

Экспериментальный

Группа команд "guestconfig guest-configuration-assignment" экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Список всех назначений гостевой конфигурации для виртуальной машины.

az guestconfig guest-configuration-assignment list --resource-group
                                                   --vm-name

Примеры

Вывод списка всех назначений гостевой конфигурации для виртуальной машины

az guestconfig guest-configuration-assignment list --resource-group "myResourceGroupName" --vm-name "myVMName"

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

--resource-group -g

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

--vm-name

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

Глобальные параметры
--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 guestconfig guest-configuration-assignment show

Экспериментальный

Группа команд "guestconfig guest-configuration-assignment" экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

Получение сведений о назначении гостевой конфигурации.

az guestconfig guest-configuration-assignment show [--ids]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--vm-name]

Примеры

Получение назначения гостевой конфигурации

az guestconfig guest-configuration-assignment show --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName"

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

--ids

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

--name -n

Имя назначения гостевой конфигурации.

--resource-group -g

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

--subscription

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

--vm-name

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

Глобальные параметры
--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 guestconfig guest-configuration-assignment update

Экспериментальный

Группа команд "guestconfig guest-configuration-assignment" экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az guestconfig guest-configuration-assignment update [--context]
                                                     [--guest-configuration-assignment-name]
                                                     [--guest-configuration-configuration-parameter]
                                                     [--guest-configuration-configuration-setting]
                                                     [--guest-configuration-name]
                                                     [--guest-configuration-version]
                                                     [--ids]
                                                     [--latest-assignment-report-assignment]
                                                     [--location]
                                                     [--name]
                                                     [--no-wait]
                                                     [--resource-group]
                                                     [--subscription]
                                                     [--vm-name]

Примеры

Создание или обновление назначения гостевой конфигурации

az guestconfig guest-configuration-assignment update --guest-configuration-assignment-name "WhitelistedApplication" --guest-configuration-name "WhitelistedApplication" --location "westcentralus" --context "Azure policy" --guest-configuration-name "WhitelistedApplication" --guest-configuration-configuration-parameter name="[InstalledApplication]bwhitelistedapp;Name" value="NotePad,sql" --guest-configuration-configuration-setting action-after-reboot="ContinueConfiguration" configuration-mode="MonitorOnly" configuration-mode-frequency-mins=15 reboot-if-needed="False" --guest-configuration-version "1.*" --resource-group "myResourceGroupName" --vm-name "myVMName"

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

--context

Источник, инициирующий назначение гостевой конфигурации. Например, Политика Azure.

--guest-configuration-assignment-name

Имя назначения гостевой конфигурации.

--guest-configuration-configuration-parameter

Параметры конфигурации гостевой конфигурации.

Использование: --guest-configuration-configuration-parameter name=XX value=XX

имя: имя параметра конфигурации. значение: значение параметра конфигурации.

Несколько действий можно указать с помощью нескольких аргументов --guest-configuration-configuration-parameter.

--guest-configuration-configuration-setting

Параметр конфигурации для гостевой конфигурации.

Использование: --guest-configuration-configuration-setting configuration-mode=XX allow-module-overwrite=XX action-after-reboot=XX refresh-frequency-mins=XX reboot-if-needed=XX configuration-mode-frequency-mins=XX

режим конфигурации. Указывает, как LCM(Local Configuration Manager) фактически применяет конфигурацию к целевым узлам. Возможные значения: ApplyOnly, ApplyAndMonitor и ApplyAndAutoCorrect. allow-module-overwrite: если значение true — новые конфигурации, скачанные из службы извлечения, могут перезаписать старые конфигурации на целевом узле. В противном случае ложное действие после перезагрузки: указывает, что происходит после перезагрузки во время приложения конфигурации. Возможные значения: ContinueConfiguration и StopConfiguration refresh-frequency-mins: интервал времени в минутах, в течение которого LCM проверка службу извлечения для получения обновленных конфигураций. Это значение пропускается, если LCM не настроен в режиме запроса. Значение по умолчанию — 30. при необходимости перезагрузка. Установите для этого значение true, чтобы автоматически перезагрузить узел после настройки, требующей перезагрузки. В противном случае для каждой такой конфигурации узел придется перезагружать вручную. По умолчанию используется значение false. Чтобы использовать этот параметр, если условие перезагрузки инициируется не с помощью DSC (а например, установщика Windows), объедините этот параметр с модулем xPendingReboot. частота конфигурации: как часто, в минутах, текущая конфигурация проверка применяется и применяется. Это свойство игнорируется, если свойство ConfigurationMode имеет значение ApplyOnly. Значение по умолчанию ― 15.

--guest-configuration-name

Имя гостевой конфигурации.

--guest-configuration-version

Версия гостевой конфигурации.

--ids

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

--latest-assignment-report-assignment

Сведения о конфигурации назначения гостевой конфигурации. Ожидаемое значение: json-string/@json-file.

--location -l

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

--name

Имя назначения гостевой конфигурации.

--no-wait

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

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

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

--subscription

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

--vm-name

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

Глобальные параметры
--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 guestconfig guest-configuration-assignment wait

Экспериментальный

Группа команд "guestconfig guest-configuration-assignment" экспериментальна и находится в стадии разработки. Уровни ссылок и поддержки: https://aka.ms/CLI_refstatus

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

az guestconfig guest-configuration-assignment wait [--created]
                                                   [--custom]
                                                   [--deleted]
                                                   [--exists]
                                                   [--ids]
                                                   [--interval]
                                                   [--name]
                                                   [--resource-group]
                                                   [--subscription]
                                                   [--timeout]
                                                   [--updated]
                                                   [--vm-name]

Примеры

Приостанавливает выполнение следующей строки скрипта CLI до тех пор, пока не будет успешно создана гостевая конфигурация гостевой конфигурации.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --created

Приостанавливайте выполнение следующей строки скрипта CLI до успешного удаления гостевой конфигурации гостевой конфигурации.

az guestconfig guest-configuration-assignment wait --name "SecureProtocol" --resource-group "myResourceGroupName" --vm-name "myVMName" --deleted

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

--created

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

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

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

--deleted

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

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

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

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

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

--interval

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

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

Имя назначения гостевой конфигурации.

--resource-group -g

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

--subscription

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

--timeout

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

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

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

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

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

Глобальные параметры
--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.