Microsoft.GuestConfiguration guestConfigurationAssignments
Artículo 12/21/2024
2 colaboradores
Comentarios
En este artículo
Definición de recursos de Bicep
El tipo de recurso guestConfigurationAssignments se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios .
Para crear un recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, agregue el siguiente bicep a la plantilla.
resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
context: 'string'
guestConfiguration: {
assignmentType: 'string'
configurationParameter: [
{
name: 'string'
value: 'string'
}
]
configurationProtectedParameter: [
{
name: 'string'
value: 'string'
}
]
contentHash: 'string'
contentManagedIdentity: 'string'
contentUri: 'string'
kind: 'string'
name: 'string'
version: 'string'
}
latestAssignmentReport: {
assignment: {
configuration: {}
}
resources: [
{
reasons: [
{}
]
}
]
vm: {}
}
vmssVMList: [
{}
]
}
}
Valores de propiedad
AssignmentInfo
Nombre
Descripción
Valor
configuración
Información sobre la configuración.
ConfigurationInfo
AssignmentReport
Nombre
Descripción
Valor
asignación
Detalles de configuración de la asignación de configuración de invitado.
assignmentInfo de
Recursos
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
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Nombre
Descripción
Valor
nombre
Nombre del parámetro de configuración.
cuerda
valor
Valor del parámetro de configuración.
cuerda
GuestConfigurationAssignmentProperties
Nombre
Descripción
Valor
contexto
Origen que inició la asignación de configuración de invitado. Por ejemplo: Azure Policy
cuerda
guestConfiguration
Configuración de invitado que se va a asignar.
GuestConfigurationNavigation
latestAssignmentReport
Último informe de asignación de configuración de invitado notificado.
AssignmentReport de
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.
cuerda
contentManagedIdentity
Identidad administrada con acceso de almacenamiento del paquete de configuración de invitado y parámetros de configuración.
cuerda
contentUri
Uri del almacenamiento donde se carga el paquete de configuración de invitado.
cuerda
amable
Tipo de configuración de invitado. Por ejemplo: DSC
'DSC'
nombre
Nombre de la configuración de invitado.
cuerda
Versión
Versión de la configuración de invitado.
cuerda
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nombre
Descripción
Valor
ubicación
Región donde se encuentra la máquina virtual.
cuerda
nombre
El nombre del recurso
string (obligatorio)
Propiedades
Propiedades de la asignación de configuración de invitado.
GuestConfigurationAssignmentProperties
alcance
Use al crear un recurso en un ámbito diferente del ámbito de implementación.
Establezca esta propiedad en el nombre simbólico de un recurso para aplicar el recurso de extensión .
VMInfo
VmssvmInfo
Ejemplos de inicio rápido
En los ejemplos de inicio rápido siguientes se implementa este tipo de recurso.
Archivo de Bicep
Descripción
máquinas virtuales de IIS & máquina virtual de SQL Server 2014
Cree 1 o 2 servidores web de Windows 2012 R2 de IIS y un back-end SQL Server 2014 en la red virtual.
máquina virtual Windows con de línea base segura de 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 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 se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios .
Para crear un recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, agregue el siguiente JSON a la plantilla.
{
"type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
"apiVersion": "2024-04-05",
"name": "string",
"location": "string",
"properties": {
"context": "string",
"guestConfiguration": {
"assignmentType": "string",
"configurationParameter": [
{
"name": "string",
"value": "string"
}
],
"configurationProtectedParameter": [
{
"name": "string",
"value": "string"
}
],
"contentHash": "string",
"contentManagedIdentity": "string",
"contentUri": "string",
"kind": "string",
"name": "string",
"version": "string"
},
"latestAssignmentReport": {
"assignment": {
"configuration": {
}
},
"resources": [
{
"reasons": [
{
}
]
}
],
"vm": {
}
},
"vmssVMList": [
{
}
]
}
}
Valores de propiedad
AssignmentInfo
Nombre
Descripción
Valor
configuración
Información sobre la configuración.
ConfigurationInfo
AssignmentReport
Nombre
Descripción
Valor
asignación
Detalles de configuración de la asignación de configuración de invitado.
assignmentInfo de
Recursos
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
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Nombre
Descripción
Valor
nombre
Nombre del parámetro de configuración.
cuerda
valor
Valor del parámetro de configuración.
cuerda
GuestConfigurationAssignmentProperties
Nombre
Descripción
Valor
contexto
Origen que inició la asignación de configuración de invitado. Por ejemplo: Azure Policy
cuerda
guestConfiguration
Configuración de invitado que se va a asignar.
GuestConfigurationNavigation
latestAssignmentReport
Último informe de asignación de configuración de invitado notificado.
AssignmentReport de
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.
cuerda
contentManagedIdentity
Identidad administrada con acceso de almacenamiento del paquete de configuración de invitado y parámetros de configuración.
cuerda
contentUri
Uri del almacenamiento donde se carga el paquete de configuración de invitado.
cuerda
amable
Tipo de configuración de invitado. Por ejemplo: DSC
'DSC'
nombre
Nombre de la configuración de invitado.
cuerda
Versión
Versión de la configuración de invitado.
cuerda
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nombre
Descripción
Valor
apiVersion
La versión de api
'2024-04-05'
ubicación
Región donde se encuentra la máquina virtual.
cuerda
nombre
El nombre del recurso
string (obligatorio)
Propiedades
Propiedades de la asignación de configuración de invitado.
GuestConfigurationAssignmentProperties
tipo
El tipo de recurso
'Microsoft.GuestConfiguration/guestConfigurationAssignments'
VMInfo
VmssvmInfo
Plantillas de inicio rápido
Las siguientes plantillas de inicio rápido implementan este tipo de recurso.
Plantilla
Descripción
máquinas virtuales de IIS & máquina virtual de SQL Server 2014
Cree 1 o 2 servidores web de Windows 2012 R2 de IIS y un back-end SQL Server 2014 en la red virtual.
máquina virtual Windows con de línea base segura de 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 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.
El tipo de recurso guestConfigurationAssignments se puede implementar con operaciones destinadas a:
Para obtener una lista de las propiedades modificadas en cada versión de API, consulte registro de cambios .
Para crear un recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, agregue el siguiente terraform a la plantilla.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05"
name = "string"
parent_id = "string"
location = "string"
body = jsonencode({
properties = {
context = "string"
guestConfiguration = {
assignmentType = "string"
configurationParameter = [
{
name = "string"
value = "string"
}
]
configurationProtectedParameter = [
{
name = "string"
value = "string"
}
]
contentHash = "string"
contentManagedIdentity = "string"
contentUri = "string"
kind = "string"
name = "string"
version = "string"
}
latestAssignmentReport = {
assignment = {
configuration = {
}
}
resources = [
{
reasons = [
{
}
]
}
]
vm = {
}
}
vmssVMList = [
{
}
]
}
})
}
Valores de propiedad
AssignmentInfo
Nombre
Descripción
Valor
configuración
Información sobre la configuración.
ConfigurationInfo
AssignmentReport
Nombre
Descripción
Valor
asignación
Detalles de configuración de la asignación de configuración de invitado.
assignmentInfo de
Recursos
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
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Nombre
Descripción
Valor
nombre
Nombre del parámetro de configuración.
cuerda
valor
Valor del parámetro de configuración.
cuerda
GuestConfigurationAssignmentProperties
Nombre
Descripción
Valor
contexto
Origen que inició la asignación de configuración de invitado. Por ejemplo: Azure Policy
cuerda
guestConfiguration
Configuración de invitado que se va a asignar.
GuestConfigurationNavigation
latestAssignmentReport
Último informe de asignación de configuración de invitado notificado.
AssignmentReport de
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.
cuerda
contentManagedIdentity
Identidad administrada con acceso de almacenamiento del paquete de configuración de invitado y parámetros de configuración.
cuerda
contentUri
Uri del almacenamiento donde se carga el paquete de configuración de invitado.
cuerda
amable
Tipo de configuración de invitado. Por ejemplo: DSC
'DSC'
nombre
Nombre de la configuración de invitado.
cuerda
Versión
Versión de la configuración de invitado.
cuerda
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nombre
Descripción
Valor
ubicación
Región donde se encuentra la máquina virtual.
cuerda
nombre
El nombre del recurso
string (obligatorio)
parent_id
Identificador del recurso al que se va a aplicar este recurso de extensión.
string (obligatorio)
Propiedades
Propiedades de la asignación de configuración de invitado.
GuestConfigurationAssignmentProperties
tipo
El tipo de recurso
"Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05"
VMInfo
VmssvmInfo