Microsoft.GuestConfiguration guestConfigurationAssignments
Artigo 12/20/2024
2 colaboradores
Comentários
Neste artigo
Definição de recurso do Bicep
O tipo de recurso guestConfigurationAssignments pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Para criar um recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, adicione o seguinte Bicep ao modelo.
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 propriedade
AssignmentInfo
Nome
Descrição
Valor
configuração
Informações sobre a configuração.
ConfigurationInfo
AssignmentReport
Nome
Descrição
Valor
designação
Detalhes de configuração da atribuição de configuração de convidado.
AssignmentInfo
Recursos
A lista de recursos para os quais a conformidade da atribuição de configuração de convidado é verificada.
AssignmentReportResource []
Vm
Informações sobre a VM.
VMInfo
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Nome
Descrição
Valor
nome
Nome do parâmetro de configuração.
corda
valor
Valor do parâmetro de configuração.
corda
GuestConfigurationAssignmentProperties
Nome
Descrição
Valor
contexto
A origem que iniciou a atribuição de configuração de convidado. Ex: Azure Policy
corda
guestConfiguration
A configuração de convidado a ser atribuída.
GuestConfigurationNavigation
latestAssignmentReport
Último relatório de atribuição de configuração de convidado relatado.
AssignmentReport
vmssVMList
A lista de dados de conformidade da VM para VMSS
VmssvmInfo []
GuestConfigurationNavigation
Nome
Descrição
Valor
assignmentType
Especifica o tipo de atribuição e a execução da configuração. Os valores possíveis são Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect e ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Auditoria' 'DeployAndAutoCorrect'
configurationParameter
Os parâmetros de configuração para a configuração de convidado.
ConfigurationParameter []
configurationProtectedParameter
Os parâmetros de configuração protegidos para a configuração de convidado.
ConfigurationParameter []
contentHash
Hash combinado do pacote de configuração de convidado e dos parâmetros de configuração.
corda
contentManagedIdentity
Identidade gerenciada com acesso de armazenamento dos parâmetros de configuração e pacote de configuração de convidado.
corda
contentUri
Uri do armazenamento em que o pacote de configuração de convidado é carregado.
corda
tipo
Tipo de configuração de convidado. Por exemplo:DSC
'DSC'
nome
Nome da configuração de convidado.
corda
Versão
Versão da configuração de convidado.
corda
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nome
Descrição
Valor
localização
Região em que a VM está localizada.
corda
nome
O nome do recurso
cadeia de caracteres (obrigatório)
Propriedades
Propriedades da atribuição de configuração de convidado.
GuestConfigurationAssignmentProperties
âmbito
Use ao criar um recurso em um escopo diferente do escopo de implantação.
Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .
VMInfo
VmssvmInfo
Exemplos de início rápido
Os exemplos de início rápido a seguir implantam esse tipo de recurso.
Arquivo Bicep
Descrição
VMs do IIS & de VM do SQL Server 2014
Crie 1 ou 2 Servidores Web do Windows 2012 R2 do IIS e um SQL Server 2014 de back-end na VNET.
VM do Windows com de linha de base segura do Azure
O modelo cria uma máquina virtual executando o Windows Server em uma nova rede virtual, com um endereço IP público. Depois que o computador for implantado, a extensão de configuração de convidado será instalada e a linha de base segura do Azure para Windows Server será aplicada. Se a configuração dos computadores descompassar, você poderá aplicar novamente as configurações implantando o modelo novamente.
Definição de recurso de modelo do ARM
O tipo de recurso guestConfigurationAssignments pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Para criar um recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, adicione o JSON a seguir ao modelo.
{
"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 propriedade
AssignmentInfo
Nome
Descrição
Valor
configuração
Informações sobre a configuração.
ConfigurationInfo
AssignmentReport
Nome
Descrição
Valor
designação
Detalhes de configuração da atribuição de configuração de convidado.
AssignmentInfo
Recursos
A lista de recursos para os quais a conformidade da atribuição de configuração de convidado é verificada.
AssignmentReportResource []
Vm
Informações sobre a VM.
VMInfo
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Nome
Descrição
Valor
nome
Nome do parâmetro de configuração.
corda
valor
Valor do parâmetro de configuração.
corda
GuestConfigurationAssignmentProperties
Nome
Descrição
Valor
contexto
A origem que iniciou a atribuição de configuração de convidado. Ex: Azure Policy
corda
guestConfiguration
A configuração de convidado a ser atribuída.
GuestConfigurationNavigation
latestAssignmentReport
Último relatório de atribuição de configuração de convidado relatado.
AssignmentReport
vmssVMList
A lista de dados de conformidade da VM para VMSS
VmssvmInfo []
GuestConfigurationNavigation
Nome
Descrição
Valor
assignmentType
Especifica o tipo de atribuição e a execução da configuração. Os valores possíveis são Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect e ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Auditoria' 'DeployAndAutoCorrect'
configurationParameter
Os parâmetros de configuração para a configuração de convidado.
ConfigurationParameter []
configurationProtectedParameter
Os parâmetros de configuração protegidos para a configuração de convidado.
ConfigurationParameter []
contentHash
Hash combinado do pacote de configuração de convidado e dos parâmetros de configuração.
corda
contentManagedIdentity
Identidade gerenciada com acesso de armazenamento dos parâmetros de configuração e pacote de configuração de convidado.
corda
contentUri
Uri do armazenamento em que o pacote de configuração de convidado é carregado.
corda
tipo
Tipo de configuração de convidado. Por exemplo:DSC
'DSC'
nome
Nome da configuração de convidado.
corda
Versão
Versão da configuração de convidado.
corda
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nome
Descrição
Valor
apiVersion
A versão da API
'2024-04-05'
localização
Região em que a VM está localizada.
corda
nome
O nome do recurso
cadeia de caracteres (obrigatório)
Propriedades
Propriedades da atribuição de configuração de convidado.
GuestConfigurationAssignmentProperties
tipo
O tipo de recurso
'Microsoft.GuestConfiguration/guestConfigurationAssignments'
VMInfo
VmssvmInfo
Modelos de início rápido
Os modelos de início rápido a seguir implantam esse tipo de recurso.
Modelo
Descrição
VMs do IIS & de VM do SQL Server 2014
Crie 1 ou 2 Servidores Web do Windows 2012 R2 do IIS e um SQL Server 2014 de back-end na VNET.
VM do Windows com de linha de base segura do Azure
O modelo cria uma máquina virtual executando o Windows Server em uma nova rede virtual, com um endereço IP público. Depois que o computador for implantado, a extensão de configuração de convidado será instalada e a linha de base segura do Azure para Windows Server será aplicada. Se a configuração dos computadores descompassar, você poderá aplicar novamente as configurações implantando o modelo novamente.
O tipo de recurso guestConfigurationAssignments pode ser implantado com operações direcionadas:
Para obter uma lista de propriedades alteradas em cada versão da API, consulte de log de alterações.
Para criar um recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, adicione o Terraform a seguir ao modelo.
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 propriedade
AssignmentInfo
Nome
Descrição
Valor
configuração
Informações sobre a configuração.
ConfigurationInfo
AssignmentReport
Nome
Descrição
Valor
designação
Detalhes de configuração da atribuição de configuração de convidado.
AssignmentInfo
Recursos
A lista de recursos para os quais a conformidade da atribuição de configuração de convidado é verificada.
AssignmentReportResource []
Vm
Informações sobre a VM.
VMInfo
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Nome
Descrição
Valor
nome
Nome do parâmetro de configuração.
corda
valor
Valor do parâmetro de configuração.
corda
GuestConfigurationAssignmentProperties
Nome
Descrição
Valor
contexto
A origem que iniciou a atribuição de configuração de convidado. Ex: Azure Policy
corda
guestConfiguration
A configuração de convidado a ser atribuída.
GuestConfigurationNavigation
latestAssignmentReport
Último relatório de atribuição de configuração de convidado relatado.
AssignmentReport
vmssVMList
A lista de dados de conformidade da VM para VMSS
VmssvmInfo []
GuestConfigurationNavigation
Nome
Descrição
Valor
assignmentType
Especifica o tipo de atribuição e a execução da configuração. Os valores possíveis são Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect e ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Auditoria' 'DeployAndAutoCorrect'
configurationParameter
Os parâmetros de configuração para a configuração de convidado.
ConfigurationParameter []
configurationProtectedParameter
Os parâmetros de configuração protegidos para a configuração de convidado.
ConfigurationParameter []
contentHash
Hash combinado do pacote de configuração de convidado e dos parâmetros de configuração.
corda
contentManagedIdentity
Identidade gerenciada com acesso de armazenamento dos parâmetros de configuração e pacote de configuração de convidado.
corda
contentUri
Uri do armazenamento em que o pacote de configuração de convidado é carregado.
corda
tipo
Tipo de configuração de convidado. Por exemplo:DSC
'DSC'
nome
Nome da configuração de convidado.
corda
Versão
Versão da configuração de convidado.
corda
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nome
Descrição
Valor
localização
Região em que a VM está localizada.
corda
nome
O nome do recurso
cadeia de caracteres (obrigatório)
parent_id
A ID do recurso ao qual aplicar esse recurso de extensão.
cadeia de caracteres (obrigatório)
Propriedades
Propriedades da atribuição de configuração de convidado.
GuestConfigurationAssignmentProperties
tipo
O tipo de recurso
"Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05"
VMInfo
VmssvmInfo