Microsoft.GuestConfiguration guestConfigurationAssignments 2018-06-30-preview
Определение ресурсов Bicep
Тип ресурса guestConfigurationAssignments можно развернуть с помощью операций, целевых:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.GuestConfiguration/guestConfigurationAssignments, добавьте следующий Bicep в шаблон.
resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
context: 'string'
guestConfiguration: {
configurationParameter: [
{}
]
configurationSetting: {
actionAfterReboot: 'string'
allowModuleOverwrite: bool
configurationMode: 'string'
configurationModeFrequencyMins: int
rebootIfNeeded: bool
refreshFrequencyMins: int
}
kind: 'string'
name: 'string'
version: 'string'
}
}
}
Значения свойств
ConfigurationParameter
| Имя | Описание | Ценность |
|---|
ConfigurationSetting
| Имя | Описание | Ценность |
|---|---|---|
| actionAfterReboot | Указывает, что происходит после перезагрузки во время приложения конфигурации. Возможные значения: ContinueConfiguration и StopConfiguration | 'ContinueConfiguration' StopConfiguration |
| allowModuleOverwrite | Если значение true — новые конфигурации, скачанные из службы извлечения, могут перезаписать старые конфигурации на целевом узле. В противном случае — значение false | bool |
| configurationMode | Указывает, как LCM(Local Configuration Manager) фактически применяет конфигурацию к целевым узлам. Возможные значения: ApplyOnly, ApplyAndMonitor и ApplyAndAutoCorrect. | ApplyAndAutoCorrect "ApplyAndMonitor" ApplyOnly |
| configurationModeFrequencyMins | Как часто текущая конфигурация проверяется и применяется в минутах. Это свойство игнорируется, если для свойства ConfigurationMode задано значение ApplyOnly. Значение по умолчанию — 15. | int |
| перезагрузкаIfNeed | Установите для этого значение true, чтобы автоматически перезагрузить узел после настройки, требующей перезагрузки. В противном случае необходимо вручную перезагрузить узел для любой конфигурации, требующей ее. Значение по умолчанию — false. Чтобы использовать этот параметр при принятии условия перезагрузки, отличном от DSC (например, установщика Windows), объедините этот параметр с модулем xPendingReboot. | bool |
| refreshFrequencyMins | Интервал времени в минутах, в течение которого LCM проверяет службу извлечения, чтобы получить обновленные конфигурации. Это значение игнорируется, если LCM не настроен в режиме извлечения. Значение по умолчанию — 30. | int |
GuestConfigurationAssignmentProperties
| Имя | Описание | Ценность |
|---|---|---|
| контекст | Источник, инициирующий назначение гостевой конфигурации. Например: политика Azure | струна |
| guestConfiguration | Назначаемая гостевая конфигурация. | GuestConfigurationNavigation |
GuestConfigurationNavigation
| Имя | Описание | Ценность |
|---|---|---|
| configurationParameter | Параметры конфигурации гостевой конфигурации. | ConfigurationParameter[] |
| configurationSetting | Параметр конфигурации для гостевой конфигурации. | ConfigurationSetting |
| добрый | Тип гостевой конфигурации. Например:DSC | DSC |
| имя | Имя гостевой конфигурации. | струна |
| Версия | Версия гостевой конфигурации. | струна |
Microsoft.GuestConfiguration/guestConfigurationAssignments
| Имя | Описание | Ценность |
|---|---|---|
| местоположение | Регион, в котором находится виртуальная машина. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства назначения гостевой конфигурации. | GuestConfigurationAssignmentProperties |
| размах | Используется при создании ресурса в области, отличной от области развертывания. | Задайте для этого свойства символьное имя ресурса, чтобы применить ресурс расширения. |
Примеры краткого руководства
Следующие примеры краткого руководства по развертыванию этого типа ресурса.
| Bicep-файл | Описание |
|---|---|
| виртуальные машины IIS & виртуальной машины SQL Server 2014 | Создайте веб-серверы Windows 2012 R2 с 1 или 2 IIS и один серверный сервер SQL Server 2014 в виртуальной сети. |
| виртуальной машине Windows с безопасной базы данных Azure | Шаблон создает виртуальную машину под управлением Windows Server в новой виртуальной сети с общедоступным IP-адресом. После развертывания компьютера устанавливается расширение гостевой конфигурации и применяется безопасный базовый план Azure для Windows Server. При перемещении конфигурации компьютеров можно повторно применить параметры, развернув шаблон еще раз. |
Определение ресурса шаблона ARM
Тип ресурса guestConfigurationAssignments можно развернуть с помощью операций, целевых:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.GuestConfiguration/guestConfigurationAssignments, добавьте следующий код JSON в шаблон.
{
"type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
"apiVersion": "2018-06-30-preview",
"name": "string",
"location": "string",
"properties": {
"context": "string",
"guestConfiguration": {
"configurationParameter": [
{
}
],
"configurationSetting": {
"actionAfterReboot": "string",
"allowModuleOverwrite": "bool",
"configurationMode": "string",
"configurationModeFrequencyMins": "int",
"rebootIfNeeded": "bool",
"refreshFrequencyMins": "int"
},
"kind": "string",
"name": "string",
"version": "string"
}
}
}
Значения свойств
ConfigurationParameter
| Имя | Описание | Ценность |
|---|
ConfigurationSetting
| Имя | Описание | Ценность |
|---|---|---|
| actionAfterReboot | Указывает, что происходит после перезагрузки во время приложения конфигурации. Возможные значения: ContinueConfiguration и StopConfiguration | 'ContinueConfiguration' StopConfiguration |
| allowModuleOverwrite | Если значение true — новые конфигурации, скачанные из службы извлечения, могут перезаписать старые конфигурации на целевом узле. В противном случае — значение false | bool |
| configurationMode | Указывает, как LCM(Local Configuration Manager) фактически применяет конфигурацию к целевым узлам. Возможные значения: ApplyOnly, ApplyAndMonitor и ApplyAndAutoCorrect. | ApplyAndAutoCorrect "ApplyAndMonitor" ApplyOnly |
| configurationModeFrequencyMins | Как часто текущая конфигурация проверяется и применяется в минутах. Это свойство игнорируется, если для свойства ConfigurationMode задано значение ApplyOnly. Значение по умолчанию — 15. | int |
| перезагрузкаIfNeed | Установите для этого значение true, чтобы автоматически перезагрузить узел после настройки, требующей перезагрузки. В противном случае необходимо вручную перезагрузить узел для любой конфигурации, требующей ее. Значение по умолчанию — false. Чтобы использовать этот параметр при принятии условия перезагрузки, отличном от DSC (например, установщика Windows), объедините этот параметр с модулем xPendingReboot. | bool |
| refreshFrequencyMins | Интервал времени в минутах, в течение которого LCM проверяет службу извлечения, чтобы получить обновленные конфигурации. Это значение игнорируется, если LCM не настроен в режиме извлечения. Значение по умолчанию — 30. | int |
GuestConfigurationAssignmentProperties
| Имя | Описание | Ценность |
|---|---|---|
| контекст | Источник, инициирующий назначение гостевой конфигурации. Например: политика Azure | струна |
| guestConfiguration | Назначаемая гостевая конфигурация. | GuestConfigurationNavigation |
GuestConfigurationNavigation
| Имя | Описание | Ценность |
|---|---|---|
| configurationParameter | Параметры конфигурации гостевой конфигурации. | ConfigurationParameter[] |
| configurationSetting | Параметр конфигурации для гостевой конфигурации. | ConfigurationSetting |
| добрый | Тип гостевой конфигурации. Например:DSC | DSC |
| имя | Имя гостевой конфигурации. | струна |
| Версия | Версия гостевой конфигурации. | струна |
Microsoft.GuestConfiguration/guestConfigurationAssignments
| Имя | Описание | Ценность |
|---|---|---|
| apiVersion | Версия API | '2018-06-30-preview' |
| местоположение | Регион, в котором находится виртуальная машина. | струна |
| имя | Имя ресурса | строка (обязательно) |
| свойства | Свойства назначения гостевой конфигурации. | GuestConfigurationAssignmentProperties |
| тип | Тип ресурса | "Microsoft.GuestConfiguration/guestConfigurationAssignments" |
Шаблоны быстрого запуска
Следующие шаблоны быстрого запуска развертывают этот тип ресурса.
| Шаблон | Описание |
|---|---|
|
виртуальные машины IIS & виртуальной машины SQL Server 2014 развертывание  |
Создайте веб-серверы Windows 2012 R2 с 1 или 2 IIS и один серверный сервер SQL Server 2014 в виртуальной сети. |
|
виртуальной машине Windows с безопасной базы данных Azure развертывание |
Шаблон создает виртуальную машину под управлением Windows Server в новой виртуальной сети с общедоступным IP-адресом. После развертывания компьютера устанавливается расширение гостевой конфигурации и применяется безопасный базовый план Azure для Windows Server. При перемещении конфигурации компьютеров можно повторно применить параметры, развернув шаблон еще раз. |
Определение ресурса Terraform (поставщик AzAPI)
Тип ресурса guestConfigurationAssignments можно развернуть с помощью операций, целевых:
Список измененных свойств в каждой версии API см. в журнала изменений.
Формат ресурса
Чтобы создать ресурс Microsoft.GuestConfiguration/guestConfigurationAssignments, добавьте следующий terraform в шаблон.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview"
name = "string"
parent_id = "string"
location = "string"
body = jsonencode({
properties = {
context = "string"
guestConfiguration = {
configurationParameter = [
{
}
]
configurationSetting = {
actionAfterReboot = "string"
allowModuleOverwrite = bool
configurationMode = "string"
configurationModeFrequencyMins = int
rebootIfNeeded = bool
refreshFrequencyMins = int
}
kind = "string"
name = "string"
version = "string"
}
}
})
}
Значения свойств
ConfigurationParameter
| Имя | Описание | Ценность |
|---|
ConfigurationSetting
| Имя | Описание | Ценность |
|---|---|---|
| actionAfterReboot | Указывает, что происходит после перезагрузки во время приложения конфигурации. Возможные значения: ContinueConfiguration и StopConfiguration | 'ContinueConfiguration' StopConfiguration |
| allowModuleOverwrite | Если значение true — новые конфигурации, скачанные из службы извлечения, могут перезаписать старые конфигурации на целевом узле. В противном случае — значение false | bool |
| configurationMode | Указывает, как LCM(Local Configuration Manager) фактически применяет конфигурацию к целевым узлам. Возможные значения: ApplyOnly, ApplyAndMonitor и ApplyAndAutoCorrect. | ApplyAndAutoCorrect "ApplyAndMonitor" ApplyOnly |
| configurationModeFrequencyMins | Как часто текущая конфигурация проверяется и применяется в минутах. Это свойство игнорируется, если для свойства ConfigurationMode задано значение ApplyOnly. Значение по умолчанию — 15. | int |
| перезагрузкаIfNeed | Установите для этого значение true, чтобы автоматически перезагрузить узел после настройки, требующей перезагрузки. В противном случае необходимо вручную перезагрузить узел для любой конфигурации, требующей ее. Значение по умолчанию — false. Чтобы использовать этот параметр при принятии условия перезагрузки, отличном от DSC (например, установщика Windows), объедините этот параметр с модулем xPendingReboot. | bool |
| refreshFrequencyMins | Интервал времени в минутах, в течение которого LCM проверяет службу извлечения, чтобы получить обновленные конфигурации. Это значение игнорируется, если LCM не настроен в режиме извлечения. Значение по умолчанию — 30. | int |
GuestConfigurationAssignmentProperties
| Имя | Описание | Ценность |
|---|---|---|
| контекст | Источник, инициирующий назначение гостевой конфигурации. Например: политика Azure | струна |
| guestConfiguration | Назначаемая гостевая конфигурация. | GuestConfigurationNavigation |
GuestConfigurationNavigation
| Имя | Описание | Ценность |
|---|---|---|
| configurationParameter | Параметры конфигурации гостевой конфигурации. | ConfigurationParameter[] |
| configurationSetting | Параметр конфигурации для гостевой конфигурации. | ConfigurationSetting |
| добрый | Тип гостевой конфигурации. Например:DSC | DSC |
| имя | Имя гостевой конфигурации. | струна |
| Версия | Версия гостевой конфигурации. | струна |
Microsoft.GuestConfiguration/guestConfigurationAssignments
| Имя | Описание | Ценность |
|---|---|---|
| местоположение | Регион, в котором находится виртуальная машина. | струна |
| имя | Имя ресурса | строка (обязательно) |
| parent_id | Идентификатор ресурса для применения этого ресурса расширения. | строка (обязательно) |
| свойства | Свойства назначения гостевой конфигурации. | GuestConfigurationAssignmentProperties |
| тип | Тип ресурса | "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview" |