Microsoft.GuestConfiguration guestConfigurationAssignments
Definizione di risorsa Bicep
Il tipo di risorsa guestConfigurationAssignments è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.
Utilizzare la proprietà in questa risorsa per impostare l'ambito scope
per questa risorsa. Vedere Impostare l'ambito sulle risorse di estensione in Bicep.
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.GuestConfiguration/guestConfigurationAssignments, aggiungere il bicep seguente al modello.
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: [
{
}
]
}
}
Valori delle proprietà
guestConfigurationAssignments
Nome | Descrizione | valore |
---|---|---|
name | Nome della risorsa | stringa (obbligatoria) |
posizione | Area in cui si trova la macchina virtuale. | string |
ambito | Usare quando si crea una risorsa di estensione in un ambito diverso dall'ambito di distribuzione. | Risorsa di destinazione Per Bicep, impostare questa proprietà sul nome simbolico della risorsa per applicare la risorsa di estensione. |
properties | Proprietà dell'assegnazione di configurazione guest. | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
Nome | Descrizione | valore |
---|---|---|
contesto | Origine che ha avviato l'assegnazione di configurazione guest. Ad esempio: Criteri di Azure | string |
guestConfiguration | Configurazione guest da assegnare. | GuestConfigurationNavigation |
latestAssignmentReport | Ultimo report sull'assegnazione di configurazione guest segnalata. | AssignmentReport |
vmssVMList | Elenco dei dati di conformità della macchina virtuale per VMSS | VmssvmInfo[] |
GuestConfigurationNavigation
Nome | Descrizione | valore |
---|---|---|
assignmentType | Specifica il tipo di assegnazione e l'esecuzione della configurazione. I valori possibili sono Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect e ApplyAndMonitor. | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Audit' 'DeployAndAutoCorrect' |
configurationParameter | Parametri di configurazione per la configurazione guest. | ConfigurationParameter[] |
configurationProtectedParameter | Parametri di configurazione protetti per la configurazione guest. | ConfigurationParameter[] |
contentHash | Hash combinato dei parametri di configurazione guest e configurazione. | string |
contentUri | Uri dell'archivio in cui viene caricato il pacchetto di configurazione guest. | string |
kind | Tipo di configurazione guest. Ad esempio:DSC | 'DSC' |
name | Nome della configurazione guest. | string |
version | Versione della configurazione guest. | string |
ConfigurationParameter
Nome | Descrizione | valore |
---|---|---|
name | Nome del parametro di configurazione. | string |
Valore | Valore del parametro di configurazione. | string |
AssignmentReport
Nome | Descrizione | valore |
---|---|---|
Assegnazione | Dettagli di configurazione dell'assegnazione della configurazione guest. | AssignmentInfo |
resources | Elenco di risorse per cui viene verificata la conformità dell'assegnazione della configurazione guest. | AssignmentReportResource[] |
vm | Informazioni sulla macchina virtuale. | VMInfo |
AssignmentInfo
Nome | Descrizione | valore |
---|---|---|
configurazione | Informazioni sulla configurazione. | ConfigurationInfo |
ConfigurationInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
AssignmentReportResource
Nome | Descrizione | valore |
---|---|---|
Motivi | Motivo di conformità e codice motivo per una risorsa. | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
VMInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
VmssvmInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Modello | Descrizione |
---|---|
Vm Windows con baseline sicura di Azure |
Il modello crea una macchina virtuale che esegue Windows Server in una nuova rete virtuale, con un indirizzo IP pubblico. Dopo aver distribuito il computer, viene installata l'estensione di configurazione guest e viene applicata la baseline sicura di Azure per Windows Server. Se la configurazione delle macchine si sposta, è possibile applicare nuovamente le impostazioni distribuendo di nuovo il modello. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa guestConfigurationAssignments è una risorsa di estensione, il che significa che è possibile applicarlo a un'altra risorsa.
Usare la scope
proprietà in questa risorsa per impostare l'ambito per questa risorsa. Vedere Impostare l'ambito sulle risorse di estensione nei modelli di Resource Manager.
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere Log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.GuestConfiguration/guestConfigurationAssignments, aggiungere il codice JSON seguente al modello.
{
"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": [
{
}
]
}
}
Valori delle proprietà
guestConfigurationAssignments
Nome | Descrizione | valore |
---|---|---|
tipo | Tipo di risorsa | 'Microsoft.GuestConfiguration/guestConfigurationAssignments' |
apiVersion | Versione dell'API della risorsa | '2022-01-25' |
name | Nome della risorsa | stringa (obbligatorio) |
posizione | Area in cui si trova la macchina virtuale. | string |
ambito | Usare quando si crea una risorsa di estensione in un ambito diverso dall'ambito di distribuzione. | Risorsa di destinazione Per JSON, impostare il valore sul nome completo della risorsa a cui applicare la risorsa di estensione . |
properties | Proprietà dell'assegnazione di configurazione guest. | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
Nome | Descrizione | valore |
---|---|---|
contesto | Origine che ha avviato l'assegnazione di configurazione guest. Ad esempio: Criteri di Azure | string |
guestConfiguration | Configurazione guest da assegnare. | GuestConfigurationNavigation |
latestAssignmentReport | Ultimo report sull'assegnazione della configurazione guest segnalata. | AssignmentReport |
vmssVMList | Elenco dei dati di conformità delle macchine virtuali per il set di scalabilità di macchine virtuali | VmssvmInfo[] |
GuestConfigurationNavigation
Nome | Descrizione | valore |
---|---|---|
assignmentType | Specifica il tipo di assegnazione e l'esecuzione della configurazione. I valori possibili sono Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect e ApplyAndMonitor. | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Audit' 'DeployAndAutoCorrect' |
configurationParameter | Parametri di configurazione per la configurazione guest. | ConfigurationParameter[] |
configurationProtectedParameter | Parametri di configurazione protetti per la configurazione guest. | ConfigurationParameter[] |
contentHash | Hash combinato dei parametri di configurazione guest e configurazione. | string |
contentUri | Uri dell'archivio in cui viene caricato il pacchetto di configurazione guest. | string |
kind | Tipo di configurazione guest. Ad esempio:DSC | 'DSC' |
name | Nome della configurazione guest. | string |
version | Versione della configurazione guest. | string |
ConfigurationParameter
Nome | Descrizione | valore |
---|---|---|
name | Nome del parametro di configurazione. | string |
Valore | Valore del parametro di configurazione. | string |
AssignmentReport
Nome | Descrizione | valore |
---|---|---|
Assegnazione | Dettagli di configurazione dell'assegnazione di configurazione guest. | AssignmentInfo |
resources | Elenco delle risorse per cui viene controllata la conformità dell'assegnazione di configurazione guest. | AssignmentReportResource[] |
vm | Informazioni sulla macchina virtuale. | VMInfo |
AssignmentInfo
Nome | Descrizione | valore |
---|---|---|
configurazione | Informazioni sulla configurazione. | ConfigurationInfo |
ConfigurationInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
AssignmentReportResource
Nome | Descrizione | valore |
---|---|---|
Motivi | Motivo di conformità e codice motivo per una risorsa. | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
VMInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
VmssvmInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Modello | Descrizione |
---|---|
Vm Windows con baseline sicura di Azure |
Il modello crea una macchina virtuale che esegue Windows Server in una nuova rete virtuale, con un indirizzo IP pubblico. Dopo aver distribuito il computer, l'estensione di configurazione guest viene installata e viene applicata la baseline sicura di Azure per Windows Server. Se la configurazione dei computer deriva, è possibile riapplicare le impostazioni distribuendo di nuovo il modello. |
Definizione della risorsa Terraform (provider AzAPI)
Il tipo di risorsa guestConfigurationAssignments è una risorsa di estensione, che significa che è possibile applicarla a un'altra risorsa.
Utilizzare la proprietà in questa risorsa per impostare l'ambito parent_id
per questa risorsa.
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato di risorsa
Per creare una risorsa Microsoft.GuestConfiguration/guestConfigurationAssignments, aggiungere il codice Terraform seguente al modello.
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 = [
{
}
]
}
})
}
Valori delle proprietà
guestConfigurationAssignments
Nome | Descrizione | valore |
---|---|---|
tipo | Tipo di risorsa | "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25" |
name | Nome della risorsa | stringa (obbligatoria) |
posizione | Area in cui si trova la macchina virtuale. | string |
parent_id | ID della risorsa a cui applicare questa risorsa di estensione. | stringa (obbligatoria) |
properties | Proprietà dell'assegnazione di configurazione guest. | GuestConfigurationAssignmentProperties |
GuestConfigurationAssignmentProperties
Nome | Descrizione | valore |
---|---|---|
contesto | Origine che ha avviato l'assegnazione di configurazione guest. Ad esempio: Criteri di Azure | string |
guestConfiguration | Configurazione guest da assegnare. | GuestConfigurationNavigation |
latestAssignmentReport | Ultimo report sull'assegnazione di configurazione guest segnalata. | AssignmentReport |
vmssVMList | Elenco dei dati di conformità della macchina virtuale per VMSS | VmssvmInfo[] |
GuestConfigurationNavigation
Nome | Descrizione | valore |
---|---|---|
assignmentType | Specifica il tipo di assegnazione e l'esecuzione della configurazione. I valori possibili sono Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect e ApplyAndMonitor. | "ApplyAndAutoCorrect" "ApplyAndMonitor" "Audit" "DeployAndAutoCorrect" |
configurationParameter | Parametri di configurazione per la configurazione guest. | ConfigurationParameter[] |
configurationProtectedParameter | Parametri di configurazione protetti per la configurazione guest. | ConfigurationParameter[] |
contentHash | Hash combinato dei parametri di configurazione guest e configurazione. | string |
contentUri | Uri dell'archivio in cui viene caricato il pacchetto di configurazione guest. | string |
kind | Tipo di configurazione guest. Ad esempio:DSC | "DSC" |
name | Nome della configurazione guest. | string |
version | Versione della configurazione guest. | string |
ConfigurationParameter
Nome | Descrizione | valore |
---|---|---|
name | Nome del parametro di configurazione. | string |
Valore | Valore del parametro di configurazione. | string |
AssignmentReport
Nome | Descrizione | valore |
---|---|---|
Assegnazione | Dettagli di configurazione dell'assegnazione di configurazione guest. | AssignmentInfo |
resources | Elenco delle risorse per cui viene controllata la conformità dell'assegnazione di configurazione guest. | AssignmentReportResource[] |
vm | Informazioni sulla macchina virtuale. | VMInfo |
AssignmentInfo
Nome | Descrizione | valore |
---|---|---|
configurazione | Informazioni sulla configurazione. | ConfigurationInfo |
ConfigurationInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
AssignmentReportResource
Nome | Descrizione | valore |
---|---|---|
Motivi | Motivo di conformità e codice motivo per una risorsa. | AssignmentReportResourceComplianceReason[] |
AssignmentReportResourceComplianceReason
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
VMInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.
VmssvmInfo
Questo oggetto non contiene proprietà da impostare durante la distribuzione. Tutte le proprietà sono ReadOnly.