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

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

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

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

Свойства GuestConfigurationAssignmentProperties

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

GuestConfigurationNavigation

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

ConfigurationParameter

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

Отчет о назначении

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

AssignmentInfo

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

ConfigurationInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

AssignmentReportResource

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

AssignmentReportResourceComplianceReason

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

VMInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

VmssvmInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

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

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

Шаблон Описание
Виртуальная машина 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
версия_API Версия API ресурсов '2022-01-25'
name имя ресурса. string (обязательно)
location Регион, в котором находится виртуальная машина. строка
область Используется при создании ресурса расширения в области, отличной от области развертывания. Целевой ресурс

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

Свойства GuestConfigurationAssignment

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

GuestConfigurationNavigation

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

ConfigurationParameter

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

Отчет о назначении

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

AssignmentInfo

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

ConfigurationInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

AssignmentReportResource

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

AssignmentReportResourceComplianceReason

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

VMInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

VmssvmInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

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

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

Шаблон Описание
Виртуальная машина 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"
name имя ресурса. строка (обязательно)
location Регион, в котором находится виртуальная машина. строка
parent_id Идентификатор ресурса, к который применяется этот ресурс расширения. строка (обязательно)
properties Свойства назначения гостевой конфигурации. Свойства GuestConfigurationAssignmentProperties

Свойства GuestConfigurationAssignmentProperties

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

GuestConfigurationNavigation

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

ConfigurationParameter

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

Отчет о назначении

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

AssignmentInfo

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

ConfigurationInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

AssignmentReportResource

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

AssignmentReportResourceComplianceReason

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

VMInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.

VmssvmInfo

Этот объект не содержит свойств, которые необходимо задать во время развертывания. Все свойства доступны только для чтения.