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

Microsoft.GuestConfiguration guestConfigurationAssignments

  • Статья

Определение ресурсов Bicep

Тип ресурса guestConfigurationAssignments является ресурсом расширения, что означает, что его можно применить к другому ресурсу.

Используйте свойство scope в этом ресурсе, чтобы задать область для этого ресурса. См. раздел Настройка области для ресурсов расширения в Bicep.

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.GuestConfiguration/guestConfigurationAssignments, добавьте следующий Bicep в шаблон.

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25' = {
  name: 'string'
  location: 'string'
  scope: resourceSymbolicName
  properties: {
    context: 'string'
    guestConfiguration: {
      assignmentType: 'string'
      configurationParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationProtectedParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      contentHash: 'string'
      contentUri: 'string'
      kind: 'DSC'
      name: 'string'
      version: 'string'
    }
    latestAssignmentReport: {
      assignment: {
        configuration: {}
      }
      resources: [
        {
          reasons: [
            {
            }
          ]
        }
      ]
      vm: {}
    }
    vmssVMList: [
      {
      }
    ]
  }
}

Значения свойств

guestConfigurationAssignments

Имя Описание Ценность
имя Имя ресурса строка (обязательно)
местоположение Регион, в котором находится виртуальная машина. струна
размах Используется при создании ресурса расширения в области, отличной от области развертывания. Целевой ресурс

Для Bicep задайте для этого свойства символическое имя ресурса, чтобы применить ресурс расширения .
свойства Свойства назначения гостевой конфигурации. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Имя Описание Ценность
контекст Источник, инициирующий назначение гостевой конфигурации. Например: политика Azure струна
guestConfiguration Назначаемая гостевая конфигурация. GuestConfigurationNavigation
latestAssignmentReport Последний отчет о назначении гостевой конфигурации. AssignmentReport
vmssVMList Список данных о соответствии виртуальных машин для VMSS VmssvmInfo[]

GuestConfigurationNavigation

Имя Описание Ценность
assignmentType Указывает тип назначения и выполнение конфигурации. Возможные значения: Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect и ApplyAndMonitor. ApplyAndAutoCorrect
"ApplyAndMonitor"
Аудит
DeployAndAutoCorrect
configurationParameter Параметры конфигурации гостевой конфигурации. ConfigurationParameter[]
configurationProtectedParameter Защищенные параметры конфигурации для гостевой конфигурации. ConfigurationParameter[]
contentHash Объединенный хэш пакета гостевой конфигурации и параметров конфигурации. струна
contentUri Uri хранилища, в котором отправляется пакет гостевой конфигурации. струна
добрый Тип гостевой конфигурации. Например:DSC DSC
имя Имя гостевой конфигурации. струна
Версия Версия гостевой конфигурации. струна

ConfigurationParameter

Имя Описание Ценность
имя Имя параметра конфигурации. струна
ценность Значение параметра конфигурации. струна

НазначениеReport

Имя Описание Ценность
задание Сведения о конфигурации назначения гостевой конфигурации. AssignmentInfo
ресурсы Список ресурсов, для которых проверяется соответствие назначения гостевой конфигурации. AssignmentReportResource[]
виртуальная машина Сведения о виртуальной машине. VMInfo

AssignmentInfo

Имя Описание Ценность
конфигурация Сведения о конфигурации. ConfigurationInfo

ConfigurationInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

AssignmentReportResource

Имя Описание Ценность
Причин Причина соответствия и код причины для ресурса. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

VMInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

VmssvmInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
виртуальные машины IIS & виртуальной машины SQL Server 2014

развертывание в Azure		 Создайте веб-серверы Windows 2012 R2 с 1 или 2 IIS и один серверный сервер SQL Server 2014 в виртуальной сети.
виртуальной машине Windows с безопасной базы данных Azure

развертывание в Azure		 Шаблон создает виртуальную машину под управлением Windows Server в новой виртуальной сети с общедоступным IP-адресом. После развертывания компьютера устанавливается расширение гостевой конфигурации и применяется безопасный базовый план Azure для Windows Server. При перемещении конфигурации компьютеров можно повторно применить параметры, развернув шаблон еще раз.

Определение ресурса шаблона ARM

Тип ресурса guestConfigurationAssignments является ресурсом расширения, что означает, что его можно применить к другому ресурсу.

Используйте свойство scope в этом ресурсе, чтобы задать область для этого ресурса. См. раздел Настройка области для ресурсов расширения в шаблонах ARM.

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.GuestConfiguration/guestConfigurationAssignments, добавьте следующий код JSON в шаблон.

{
  "type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
  "apiVersion": "2022-01-25",
  "name": "string",
  "location": "string",
  "scope": "string",
  "properties": {
    "context": "string",
    "guestConfiguration": {
      "assignmentType": "string",
      "configurationParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationProtectedParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "contentHash": "string",
      "contentUri": "string",
      "kind": "DSC",
      "name": "string",
      "version": "string"
    },
    "latestAssignmentReport": {
      "assignment": {
        "configuration": {}
      },
      "resources": [
        {
          "reasons": [
            {
            }
          ]
        }
      ],
      "vm": {}
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

Значения свойств

guestConfigurationAssignments

Имя Описание Ценность
тип Тип ресурса "Microsoft.GuestConfiguration/guestConfigurationAssignments"
apiVersion Версия API ресурсов '2022-01-25'
имя Имя ресурса строка (обязательно)
местоположение Регион, в котором находится виртуальная машина. струна
размах Используется при создании ресурса расширения в области, отличной от области развертывания. Целевой ресурс

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

GuestConfigurationAssignmentProperties

Имя Описание Ценность
контекст Источник, инициирующий назначение гостевой конфигурации. Например: политика Azure струна
guestConfiguration Назначаемая гостевая конфигурация. GuestConfigurationNavigation
latestAssignmentReport Последний отчет о назначении гостевой конфигурации. AssignmentReport
vmssVMList Список данных о соответствии виртуальных машин для VMSS VmssvmInfo[]

GuestConfigurationNavigation

Имя Описание Ценность
assignmentType Указывает тип назначения и выполнение конфигурации. Возможные значения: Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect и ApplyAndMonitor. ApplyAndAutoCorrect
"ApplyAndMonitor"
Аудит
DeployAndAutoCorrect
configurationParameter Параметры конфигурации гостевой конфигурации. ConfigurationParameter[]
configurationProtectedParameter Защищенные параметры конфигурации для гостевой конфигурации. ConfigurationParameter[]
contentHash Объединенный хэш пакета гостевой конфигурации и параметров конфигурации. струна
contentUri Uri хранилища, в котором отправляется пакет гостевой конфигурации. струна
добрый Тип гостевой конфигурации. Например:DSC DSC
имя Имя гостевой конфигурации. струна
Версия Версия гостевой конфигурации. струна

ConfigurationParameter

Имя Описание Ценность
имя Имя параметра конфигурации. струна
ценность Значение параметра конфигурации. струна

НазначениеReport

Имя Описание Ценность
задание Сведения о конфигурации назначения гостевой конфигурации. AssignmentInfo
ресурсы Список ресурсов, для которых проверяется соответствие назначения гостевой конфигурации. AssignmentReportResource[]
виртуальная машина Сведения о виртуальной машине. VMInfo

AssignmentInfo

Имя Описание Ценность
конфигурация Сведения о конфигурации. ConfigurationInfo

ConfigurationInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

AssignmentReportResource

Имя Описание Ценность
Причин Причина соответствия и код причины для ресурса. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

VMInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

VmssvmInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

Шаблоны быстрого запуска

Следующие шаблоны быстрого запуска развертывают этот тип ресурса.

Шаблон Описание
виртуальные машины IIS & виртуальной машины SQL Server 2014

развертывание в Azure		 Создайте веб-серверы Windows 2012 R2 с 1 или 2 IIS и один серверный сервер SQL Server 2014 в виртуальной сети.
виртуальной машине Windows с безопасной базы данных Azure

развертывание в Azure		 Шаблон создает виртуальную машину под управлением Windows Server в новой виртуальной сети с общедоступным IP-адресом. После развертывания компьютера устанавливается расширение гостевой конфигурации и применяется безопасный базовый план Azure для Windows Server. При перемещении конфигурации компьютеров можно повторно применить параметры, развернув шаблон еще раз.

Определение ресурса Terraform (поставщик AzAPI)

Тип ресурса guestConfigurationAssignments является ресурсом расширения, что означает, что его можно применить к другому ресурсу.

Используйте свойство parent_id в этом ресурсе, чтобы задать область для этого ресурса.

Список измененных свойств в каждой версии API см. в журнала изменений.

Формат ресурса

Чтобы создать ресурс Microsoft.GuestConfiguration/guestConfigurationAssignments, добавьте следующий terraform в шаблон.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25"
  name = "string"
  location = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      context = "string"
      guestConfiguration = {
        assignmentType = "string"
        configurationParameter = [
          {
            name = "string"
            value = "string"
          }
        ]
        configurationProtectedParameter = [
          {
            name = "string"
            value = "string"
          }
        ]
        contentHash = "string"
        contentUri = "string"
        kind = "DSC"
        name = "string"
        version = "string"
      }
      latestAssignmentReport = {
        assignment = {
          configuration = {}
        }
        resources = [
          {
            reasons = [
              {
              }
            ]
          }
        ]
        vm = {}
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

Значения свойств

guestConfigurationAssignments

Имя Описание Ценность
тип Тип ресурса "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25"
имя Имя ресурса строка (обязательно)
местоположение Регион, в котором находится виртуальная машина. струна
parent_id Идентификатор ресурса для применения этого ресурса расширения. строка (обязательно)
свойства Свойства назначения гостевой конфигурации. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Имя Описание Ценность
контекст Источник, инициирующий назначение гостевой конфигурации. Например: политика Azure струна
guestConfiguration Назначаемая гостевая конфигурация. GuestConfigurationNavigation
latestAssignmentReport Последний отчет о назначении гостевой конфигурации. AssignmentReport
vmssVMList Список данных о соответствии виртуальных машин для VMSS VmssvmInfo[]

GuestConfigurationNavigation

Имя Описание Ценность
assignmentType Указывает тип назначения и выполнение конфигурации. Возможные значения: Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect и ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Аудит"
DeployAndAutoCorrect
configurationParameter Параметры конфигурации гостевой конфигурации. ConfigurationParameter[]
configurationProtectedParameter Защищенные параметры конфигурации для гостевой конфигурации. ConfigurationParameter[]
contentHash Объединенный хэш пакета гостевой конфигурации и параметров конфигурации. струна
contentUri Uri хранилища, в котором отправляется пакет гостевой конфигурации. струна
добрый Тип гостевой конфигурации. Например:DSC DSC
имя Имя гостевой конфигурации. струна
Версия Версия гостевой конфигурации. струна

ConfigurationParameter

Имя Описание Ценность
имя Имя параметра конфигурации. струна
ценность Значение параметра конфигурации. струна

НазначениеReport

Имя Описание Ценность
задание Сведения о конфигурации назначения гостевой конфигурации. AssignmentInfo
ресурсы Список ресурсов, для которых проверяется соответствие назначения гостевой конфигурации. AssignmentReportResource[]
виртуальная машина Сведения о виртуальной машине. VMInfo

AssignmentInfo

Имя Описание Ценность
конфигурация Сведения о конфигурации. ConfigurationInfo

ConfigurationInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

AssignmentReportResource

Имя Описание Ценность
Причин Причина соответствия и код причины для ресурса. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

VMInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.

VmssvmInfo

Этот объект не содержит свойств, заданных во время развертывания. Все свойства — ReadOnly.