Microsoft.GuestConfiguration guestConfigurationAssignments 2018-06-30-preview
- più recenti
- 2024-04-05
- 2022-01-25
- 2021-01-25
- 2020-06-25
- 2018-11-20
-
2018-06-30-preview - 2018-01-20-preview
Definizione di risorsa Bicep
Il tipo di risorsa guestConfigurationAssignments può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.GuestConfiguration/guestConfigurationAssignments, aggiungere il bicep seguente al modello.
resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
context: 'string'
guestConfiguration: {
configurationParameter: [
{}
]
configurationSetting: {
actionAfterReboot: 'string'
allowModuleOverwrite: bool
configurationMode: 'string'
configurationModeFrequencyMins: int
rebootIfNeeded: bool
refreshFrequencyMins: int
}
kind: 'string'
name: 'string'
version: 'string'
}
}
}
Valori delle proprietà
ConfigurationParameter
Nome | Descrizione | Valore |
---|
ConfigurationSetting
Nome | Descrizione | Valore |
---|---|---|
actionAfterReboot | Specifica cosa accade dopo un riavvio durante l'applicazione di una configurazione. I valori possibili sono ContinueConfiguration e StopConfiguration | 'ContinueConfiguration' 'StopConfiguration' |
allowModuleOverwrite | Se true: le nuove configurazioni scaricate dal servizio di pull possono sovrascrivere quelle precedenti nel nodo di destinazione. In caso contrario, false | Bool |
configurationMode | Specifica in che modo Gestione configurazione locale applica effettivamente la configurazione ai nodi di destinazione. I valori possibili sono ApplyOnly, ApplyAndMonitor e ApplyAndAutoCorrect. | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'ApplyOnly' |
configurationModeFrequencyMins | Con quale frequenza, in minuti, viene verificata e applicata la configurazione corrente. Questa proprietà viene ignorata se la proprietà ConfigurationMode è impostata su ApplyOnly. Il valore predefinito è 15. | Int |
rebootIfNeeded | Impostare su true per riavviare automaticamente il nodo dopo l'applicazione di una configurazione che richiede il riavvio. In caso contrario, sarà necessario riavviare manualmente il nodo per qualsiasi configurazione che lo richiede. Il valore predefinito è false. Per usare questa impostazione quando viene applicato una condizione di riavvio da un elemento diverso da DSC (ad esempio Windows Installer), combinare questa impostazione con il modulo xPendingReboot. | Bool |
refreshFrequencyMins | Intervallo di tempo, espresso in minuti, in cui Gestione configurazione locale controlla un servizio di pull per ottenere configurazioni aggiornate. Questo valore viene ignorato se Gestione configurazione locale non è configurata in modalità pull. Il valore predefinito è 30. | Int |
GuestConfigurationAssignmentProperties
Nome | Descrizione | Valore |
---|---|---|
contesto | Origine che ha avviato l'assegnazione di configurazione guest. Ad esempio: Criteri di Azure | corda |
guestConfiguration | Configurazione guest da assegnare. | GuestConfigurationNavigation |
GuestConfigurationNavigation
Nome | Descrizione | Valore |
---|---|---|
configurationParameter | Parametri di configurazione per la configurazione guest. | ConfigurationParameter[] |
configurationSetting | Impostazione di configurazione per la configurazione guest. | ConfigurationSetting |
gentile | Tipo di configurazione guest. Ad esempio:DSC | 'DSC' |
nome | Nome della configurazione guest. | corda |
Versione | Versione della configurazione guest. | corda |
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nome | Descrizione | Valore |
---|---|---|
ubicazione | Area in cui si trova la macchina virtuale. | corda |
nome | Nome della risorsa | stringa (obbligatorio) |
proprietà | Proprietà dell'assegnazione di configurazione guest. | GuestConfigurationAssignmentProperties |
portata | Usare quando si crea una risorsa in un ambito diverso dall'ambito di distribuzione. | Impostare questa proprietà sul nome simbolico di una risorsa per applicare la risorsa di estensione . |
Esempi di avvio rapido
Gli esempi di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Bicep File | Descrizione |
---|---|
macchine virtuali IIS & vm di SQL Server 2014 | Creare server Web Windows 2012 R2 IIS 1 o 2 e un back-end di SQL Server 2014 nella rete virtuale. |
macchina virtuale Windows con di base 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 dei computer deriva, è possibile riapplicare le impostazioni distribuendo di nuovo il modello. |
Definizione di risorsa del modello di Resource Manager
Il tipo di risorsa guestConfigurationAssignments può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.GuestConfiguration/guestConfigurationAssignments, aggiungere il codice JSON seguente al modello.
{
"type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
"apiVersion": "2018-06-30-preview",
"name": "string",
"location": "string",
"properties": {
"context": "string",
"guestConfiguration": {
"configurationParameter": [
{
}
],
"configurationSetting": {
"actionAfterReboot": "string",
"allowModuleOverwrite": "bool",
"configurationMode": "string",
"configurationModeFrequencyMins": "int",
"rebootIfNeeded": "bool",
"refreshFrequencyMins": "int"
},
"kind": "string",
"name": "string",
"version": "string"
}
}
}
Valori delle proprietà
ConfigurationParameter
Nome | Descrizione | Valore |
---|
ConfigurationSetting
Nome | Descrizione | Valore |
---|---|---|
actionAfterReboot | Specifica cosa accade dopo un riavvio durante l'applicazione di una configurazione. I valori possibili sono ContinueConfiguration e StopConfiguration | 'ContinueConfiguration' 'StopConfiguration' |
allowModuleOverwrite | Se true: le nuove configurazioni scaricate dal servizio di pull possono sovrascrivere quelle precedenti nel nodo di destinazione. In caso contrario, false | Bool |
configurationMode | Specifica in che modo Gestione configurazione locale applica effettivamente la configurazione ai nodi di destinazione. I valori possibili sono ApplyOnly, ApplyAndMonitor e ApplyAndAutoCorrect. | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'ApplyOnly' |
configurationModeFrequencyMins | Con quale frequenza, in minuti, viene verificata e applicata la configurazione corrente. Questa proprietà viene ignorata se la proprietà ConfigurationMode è impostata su ApplyOnly. Il valore predefinito è 15. | Int |
rebootIfNeeded | Impostare su true per riavviare automaticamente il nodo dopo l'applicazione di una configurazione che richiede il riavvio. In caso contrario, sarà necessario riavviare manualmente il nodo per qualsiasi configurazione che lo richiede. Il valore predefinito è false. Per usare questa impostazione quando viene applicato una condizione di riavvio da un elemento diverso da DSC (ad esempio Windows Installer), combinare questa impostazione con il modulo xPendingReboot. | Bool |
refreshFrequencyMins | Intervallo di tempo, espresso in minuti, in cui Gestione configurazione locale controlla un servizio di pull per ottenere configurazioni aggiornate. Questo valore viene ignorato se Gestione configurazione locale non è configurata in modalità pull. Il valore predefinito è 30. | Int |
GuestConfigurationAssignmentProperties
Nome | Descrizione | Valore |
---|---|---|
contesto | Origine che ha avviato l'assegnazione di configurazione guest. Ad esempio: Criteri di Azure | corda |
guestConfiguration | Configurazione guest da assegnare. | GuestConfigurationNavigation |
GuestConfigurationNavigation
Nome | Descrizione | Valore |
---|---|---|
configurationParameter | Parametri di configurazione per la configurazione guest. | ConfigurationParameter[] |
configurationSetting | Impostazione di configurazione per la configurazione guest. | ConfigurationSetting |
gentile | Tipo di configurazione guest. Ad esempio:DSC | 'DSC' |
nome | Nome della configurazione guest. | corda |
Versione | Versione della configurazione guest. | corda |
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nome | Descrizione | Valore |
---|---|---|
apiVersion | Versione dell'API | '2018-06-30-preview' |
ubicazione | Area in cui si trova la macchina virtuale. | corda |
nome | Nome della risorsa | stringa (obbligatorio) |
proprietà | Proprietà dell'assegnazione di configurazione guest. | GuestConfigurationAssignmentProperties |
digitare | Tipo di risorsa | 'Microsoft.GuestConfiguration/guestConfigurationAssignments' |
Modelli di avvio rapido
I modelli di avvio rapido seguenti distribuiscono questo tipo di risorsa.
Sagoma | Descrizione |
---|---|
macchine virtuali IIS & vm di SQL Server 2014 |
Creare server Web Windows 2012 R2 IIS 1 o 2 e un back-end di SQL Server 2014 nella rete virtuale. |
macchina virtuale Windows con di base 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 dei computer deriva, è possibile riapplicare le impostazioni distribuendo di nuovo il modello. |
Definizione di risorsa Terraform (provider AzAPI)
Il tipo di risorsa guestConfigurationAssignments può essere distribuito con operazioni destinate a:
Per un elenco delle proprietà modificate in ogni versione dell'API, vedere log delle modifiche.
Formato risorsa
Per creare una risorsa Microsoft.GuestConfiguration/guestConfigurationAssignments, aggiungere il codice Terraform seguente al modello.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview"
name = "string"
parent_id = "string"
location = "string"
body = jsonencode({
properties = {
context = "string"
guestConfiguration = {
configurationParameter = [
{
}
]
configurationSetting = {
actionAfterReboot = "string"
allowModuleOverwrite = bool
configurationMode = "string"
configurationModeFrequencyMins = int
rebootIfNeeded = bool
refreshFrequencyMins = int
}
kind = "string"
name = "string"
version = "string"
}
}
})
}
Valori delle proprietà
ConfigurationParameter
Nome | Descrizione | Valore |
---|
ConfigurationSetting
Nome | Descrizione | Valore |
---|---|---|
actionAfterReboot | Specifica cosa accade dopo un riavvio durante l'applicazione di una configurazione. I valori possibili sono ContinueConfiguration e StopConfiguration | 'ContinueConfiguration' 'StopConfiguration' |
allowModuleOverwrite | Se true: le nuove configurazioni scaricate dal servizio di pull possono sovrascrivere quelle precedenti nel nodo di destinazione. In caso contrario, false | Bool |
configurationMode | Specifica in che modo Gestione configurazione locale applica effettivamente la configurazione ai nodi di destinazione. I valori possibili sono ApplyOnly, ApplyAndMonitor e ApplyAndAutoCorrect. | 'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'ApplyOnly' |
configurationModeFrequencyMins | Con quale frequenza, in minuti, viene verificata e applicata la configurazione corrente. Questa proprietà viene ignorata se la proprietà ConfigurationMode è impostata su ApplyOnly. Il valore predefinito è 15. | Int |
rebootIfNeeded | Impostare su true per riavviare automaticamente il nodo dopo l'applicazione di una configurazione che richiede il riavvio. In caso contrario, sarà necessario riavviare manualmente il nodo per qualsiasi configurazione che lo richiede. Il valore predefinito è false. Per usare questa impostazione quando viene applicato una condizione di riavvio da un elemento diverso da DSC (ad esempio Windows Installer), combinare questa impostazione con il modulo xPendingReboot. | Bool |
refreshFrequencyMins | Intervallo di tempo, espresso in minuti, in cui Gestione configurazione locale controlla un servizio di pull per ottenere configurazioni aggiornate. Questo valore viene ignorato se Gestione configurazione locale non è configurata in modalità pull. Il valore predefinito è 30. | Int |
GuestConfigurationAssignmentProperties
Nome | Descrizione | Valore |
---|---|---|
contesto | Origine che ha avviato l'assegnazione di configurazione guest. Ad esempio: Criteri di Azure | corda |
guestConfiguration | Configurazione guest da assegnare. | GuestConfigurationNavigation |
GuestConfigurationNavigation
Nome | Descrizione | Valore |
---|---|---|
configurationParameter | Parametri di configurazione per la configurazione guest. | ConfigurationParameter[] |
configurationSetting | Impostazione di configurazione per la configurazione guest. | ConfigurationSetting |
gentile | Tipo di configurazione guest. Ad esempio:DSC | 'DSC' |
nome | Nome della configurazione guest. | corda |
Versione | Versione della configurazione guest. | corda |
Microsoft.GuestConfiguration/guestConfigurationAssignments
Nome | Descrizione | Valore |
---|---|---|
ubicazione | Area in cui si trova la macchina virtuale. | corda |
nome | Nome della risorsa | stringa (obbligatorio) |
parent_id | ID della risorsa a cui applicare la risorsa di estensione. | stringa (obbligatorio) |
proprietà | Proprietà dell'assegnazione di configurazione guest. | GuestConfigurationAssignmentProperties |
digitare | Tipo di risorsa | "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview" |