Compartir a través de

Microsoft.GuestConfiguration guestConfigurationAssignments

  • Artículo

Definición de recursos de Bicep

El tipo de recurso guestConfigurationAssignments es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en Bicep.

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, agregue el siguiente bicep a la plantilla.

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: [
      {
      }
    ]
  }
}

Valores de propiedades

guestConfigurationAssignments

Nombre Descripción Value
name El nombre del recurso string (obligatorio)
ubicación Región donde se encuentra la máquina virtual. string
scope Use al crear un recurso de extensión en un ámbito diferente del ámbito de implementación. Recurso de destino

Para Bicep, establezca esta propiedad en el nombre simbólico del recurso para aplicar el recurso de extensión.
properties Propiedades de la asignación de configuración de invitado. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Nombre Descripción Valor
context Origen que inició la asignación de configuración de invitado. Por ejemplo: Azure Policy string
guestConfiguration Configuración de invitado que se va a asignar. GuestConfigurationNavigation
latestAssignmentReport Informe de asignación de configuración de invitado notificado por última vez. AssignmentReport
vmssVMList Lista de datos de cumplimiento de máquinas virtuales para VMSS VmssvmInfo[]

GuestConfigurationNavigation

Nombre Descripción Valor
assignmentType Especifica el tipo de asignación y la ejecución de la configuración. Los valores posibles son Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect y ApplyAndMonitor. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
"Auditar"
'DeployAndAutoCorrect'
configurationParameter Parámetros de configuración para la configuración de invitado. ConfigurationParameter[]
configurationProtectedParameter Parámetros de configuración protegidos para la configuración de invitado. ConfigurationParameter[]
contentHash Hash combinado del paquete de configuración de invitado y los parámetros de configuración. string
contentUri Uri del almacenamiento donde se carga el paquete de configuración de invitado. string
kind Tipo de configuración de invitado. Por ejemplo:DSC 'DSC'
name Nombre de la configuración de invitado. string
version Versión de la configuración de invitado. string

ConfigurationParameter

Nombre Descripción Value
name Nombre del parámetro de configuración. string
value Valor del parámetro de configuración. string

AssignmentReport

Nombre Descripción Valor
asignación Detalles de configuración de la asignación de configuración de invitado. AssignmentInfo
resources Lista de recursos para los que se comprueba el cumplimiento de la asignación de configuración de invitado. AssignmentReportResource[]
vm Información sobre la máquina virtual. Vminfo

AssignmentInfo

Nombre Descripción Valor
configuración Información sobre la configuración. ConfigurationInfo

ConfigurationInfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

AssignmentReportResource

Nombre Descripción Valor
Razones Motivo de cumplimiento y código de motivo para un recurso. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

Vminfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

VmssvmInfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Máquina virtual Windows con línea base segura de Azure

Implementación en Azure		 La plantilla crea una máquina virtual que ejecuta Windows Server en una nueva red virtual, con una dirección IP pública. Una vez implementada la máquina, se instala la extensión de configuración de invitado y se aplica la línea de base segura de Azure para Windows Server. Si la configuración de las máquinas se desfase, puede volver a aplicar la configuración mediante la implementación de la plantilla de nuevo.

Definición de recursos de plantilla de ARM

El tipo de recurso guestConfigurationAssignments es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la scope propiedad de este recurso para establecer el ámbito de este recurso. Consulte Establecimiento del ámbito en los recursos de extensión en plantillas de ARM.

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, agregue el siguiente json a la plantilla.

{
  "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": [
      {
      }
    ]
  }
}

Valores de propiedades

guestConfigurationAssignments

Nombre Descripción Value
type Tipo de recurso 'Microsoft.GuestConfiguration/guestConfigurationAssignments'
apiVersion La versión de la API de recursos '2022-01-25'
name El nombre del recurso string (obligatorio)
ubicación Región donde se encuentra la máquina virtual. string
scope Use al crear un recurso de extensión en un ámbito diferente del ámbito de implementación. Recurso de destino

En JSON, establezca el valor en el nombre completo del recurso al que se va a aplicar el recurso de extensión .
properties Propiedades de la asignación de configuración de invitado. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Nombre Descripción Valor
context Origen que inició la asignación de configuración de invitado. Por ejemplo: Azure Policy string
guestConfiguration Configuración de invitado que se va a asignar. GuestConfigurationNavigation
latestAssignmentReport Informe de asignación de configuración de invitado notificado por última vez. AssignmentReport
vmssVMList Lista de datos de cumplimiento de máquinas virtuales para VMSS VmssvmInfo[]

GuestConfigurationNavigation

Nombre Descripción Valor
assignmentType Especifica el tipo de asignación y la ejecución de la configuración. Los valores posibles son Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect y ApplyAndMonitor. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
"Auditar"
'DeployAndAutoCorrect'
configurationParameter Parámetros de configuración para la configuración de invitado. ConfigurationParameter[]
configurationProtectedParameter Parámetros de configuración protegidos para la configuración de invitado. ConfigurationParameter[]
contentHash Hash combinado del paquete de configuración de invitado y los parámetros de configuración. string
contentUri Uri del almacenamiento donde se carga el paquete de configuración de invitado. string
kind Tipo de configuración de invitado. Por ejemplo:DSC 'DSC'
name Nombre de la configuración de invitado. string
version Versión de la configuración de invitado. string

ConfigurationParameter

Nombre Descripción Value
name Nombre del parámetro de configuración. string
value Valor del parámetro de configuración. string

AssignmentReport

Nombre Descripción Valor
asignación Detalles de configuración de la asignación de configuración de invitado. AssignmentInfo
resources Lista de recursos para los que se comprueba el cumplimiento de la asignación de configuración de invitado. AssignmentReportResource[]
vm Información sobre la máquina virtual. Vminfo

AssignmentInfo

Nombre Descripción Valor
configuración Información sobre la configuración. ConfigurationInfo

ConfigurationInfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

AssignmentReportResource

Nombre Descripción Valor
Razones Motivo de cumplimiento y código de motivo para un recurso. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

Vminfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

VmssvmInfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

Plantillas de inicio rápido

Las siguientes plantillas de inicio rápido implementan este tipo de recurso.

Plantilla Descripción
Máquina virtual Windows con línea base segura de Azure

Implementación en Azure		 La plantilla crea una máquina virtual que ejecuta Windows Server en una nueva red virtual, con una dirección IP pública. Una vez implementada la máquina, se instala la extensión de configuración de invitado y se aplica la línea de base segura de Azure para Windows Server. Si la configuración de las máquinas se desfase, puede volver a aplicar la configuración mediante la implementación de la plantilla de nuevo.

Definición de recursos de Terraform (proveedor AzAPI)

El tipo de recurso guestConfigurationAssignments es un recurso de extensión, lo que significa que puede aplicarlo a otro recurso.

Use la parent_id propiedad de este recurso para establecer el ámbito de este recurso.

Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios.

Formato de los recursos

Para crear un recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, agregue el siguiente terraform a la plantilla.

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 = [
        {
        }
      ]
    }
  })
}

Valores de propiedades

guestConfigurationAssignments

Nombre Descripción Value
type Tipo de recurso "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25"
name El nombre del recurso string (obligatorio)
ubicación Región donde se encuentra la máquina virtual. string
parent_id Identificador del recurso al que se va a aplicar este recurso de extensión. string (obligatorio)
properties Propiedades de la asignación de configuración de invitado. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Nombre Descripción Valor
context Origen que inició la asignación de configuración de invitado. Por ejemplo: Azure Policy string
guestConfiguration Configuración de invitado que se va a asignar. GuestConfigurationNavigation
latestAssignmentReport Informe de asignación de configuración de invitado notificado por última vez. AssignmentReport
vmssVMList Lista de datos de cumplimiento de máquinas virtuales para VMSS VmssvmInfo[]

GuestConfigurationNavigation

Nombre Descripción Valor
assignmentType Especifica el tipo de asignación y la ejecución de la configuración. Los valores posibles son Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect y ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Auditar"
"DeployAndAutoCorrect"
configurationParameter Parámetros de configuración para la configuración de invitado. ConfigurationParameter[]
configurationProtectedParameter Parámetros de configuración protegidos para la configuración de invitado. ConfigurationParameter[]
contentHash Hash combinado del paquete de configuración de invitado y los parámetros de configuración. string
contentUri URI del almacenamiento donde se carga el paquete de configuración de invitado. string
kind Tipo de configuración de invitado. Por ejemplo: DSC "DSC"
name Nombre de la configuración de invitado. string
version Versión de la configuración de invitado. string

ConfigurationParameter

Nombre Descripción Value
name Nombre del parámetro de configuración. string
value Valor del parámetro de configuración. string

AssignmentReport

Nombre Descripción Valor
asignación Detalles de configuración de la asignación de configuración de invitado. AssignmentInfo
resources Lista de recursos para los que se comprueba el cumplimiento de la asignación de configuración de invitado. AssignmentReportResource[]
vm Información sobre la máquina virtual. Vminfo

AssignmentInfo

Nombre Descripción Valor
configuración Información sobre la configuración. ConfigurationInfo

ConfigurationInfo

Este objeto no contiene ninguna propiedad que se va a establecer durante la implementación. Todas las propiedades son ReadOnly.

AssignmentReportResource

Nombre Descripción Valor
Razones Motivo de cumplimiento y código de motivo de un recurso. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

Vminfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.

VmssvmInfo

Este objeto no contiene ninguna propiedad que se establezca durante la implementación. Todas las propiedades son ReadOnly.