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

az guestconfig guest-configuration-assignment

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

Note

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

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

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

Команды

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

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

 Extension Experimental
az guestconfig guest-configuration-assignment delete

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

 Extension Experimental
az guestconfig guest-configuration-assignment list

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

 Extension Experimental
az guestconfig guest-configuration-assignment show

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

 Extension Experimental
az guestconfig guest-configuration-assignment update

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

 Extension Experimental
az guestconfig guest-configuration-assignment wait

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

 Extension Experimental

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

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

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

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

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

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

Свойство Значение
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/.

--subscription

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

--verbose

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

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

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"

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

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

--ids

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

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

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

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

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

Свойство Значение
Default value: False
--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
--vm-name

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

Свойство Значение
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

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

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

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

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

Свойство Значение
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 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"

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

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

--ids

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

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

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

Свойство Значение
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
--vm-name

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

Свойство Значение
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

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

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

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"

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

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

--context

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

--guest-configuration-assignment-name

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

Свойство Значение
Parameter group: Resource Id Arguments
--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'.

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

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

--location -l

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

--name

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

--no-wait

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

Свойство Значение
Default value: False
--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
--vm-name

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

Свойство Значение
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

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

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

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

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

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
--ids

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

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

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

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

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

Свойство Значение
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
--vm-name

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

Свойство Значение
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

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

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