Bicep-resourcedefinitie
Het resourcetype guestConfigurationAssignments kan worden geïmplementeerd met bewerkingen die zijn gericht op:
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Als u een Resource Microsoft.GuestConfiguration/guestConfigurationAssignments wilt maken, voegt u de volgende Bicep toe aan uw sjabloon.
resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2020-06-25' = {
scope: resourceSymbolicName or scope
location: 'string'
name: 'string'
properties: {
context: 'string'
guestConfiguration: {
assignmentType: 'string'
configurationParameter: [
{
name: 'string'
value: 'string'
}
]
configurationProtectedParameter: [
{
name: 'string'
value: 'string'
}
]
configurationSetting: {
actionAfterReboot: 'string'
allowModuleOverwrite: bool
configurationMode: 'string'
configurationModeFrequencyMins: int
rebootIfNeeded: bool
refreshFrequencyMins: int
}
contentHash: 'string'
contentUri: 'string'
kind: 'string'
name: 'string'
version: 'string'
}
latestAssignmentReport: {
assignment: {
configuration: {}
}
resources: [
{
reasons: [
{}
]
}
]
vm: {}
}
vmssVMList: [
{}
]
}
}
Eigenschapswaarden
Microsoft.GuestConfiguration/guestConfigurationAssignments
| Naam |
Beschrijving |
Waarde |
| plaats |
Regio waar de VIRTUELE machine zich bevindt. |
snaar |
| naam |
De resourcenaam |
tekenreeks (vereist) |
| Eigenschappen |
Eigenschappen van de toewijzing van de gastconfiguratie. |
GuestConfigurationAssignmentProperties- |
| draagwijdte |
Gebruik deze functie bij het maken van een resource in een bereik dat anders is dan het implementatiebereik. |
Stel deze eigenschap in op de symbolische naam van een resource om de extensieresource toe te passen. |
Opdracht Info
Toewijzingsrapport
| Naam |
Beschrijving |
Waarde |
| taak |
Configuratiedetails van de toewijzing van de gastconfiguratie. |
AssignmentInfo- |
| weg |
De lijst met resources waarvoor naleving van gastconfiguratietoewijzingen is gecontroleerd. |
AssignmentReportResource |
| Vm |
Informatie over de VIRTUELE machine. |
VMInfo- |
AssignmentReportResource
AssignmentReportResourceComplianceReason
Configuratie-info
ConfigurationParameter
| Naam |
Beschrijving |
Waarde |
| naam |
Naam van de configuratieparameter. |
snaar |
| waarde |
Waarde van de configuratieparameter. |
snaar |
Configuratie-instelling
| Naam |
Beschrijving |
Waarde |
| actieNaOpnieuw opstarten |
Hiermee geeft u op wat er gebeurt na het opnieuw opstarten tijdens de toepassing van een configuratie. De mogelijke waarden zijn ContinueConfiguration en StopConfiguration |
ContinueConfiguration
'StopConfiguratie' |
| allowModuleOverwrite |
Indien waar: nieuwe configuraties die zijn gedownload van de pull-service, mogen de oude configuraties op het doelknooppunt overschrijven. Anders, onwaar |
Bool |
| configuratieModus |
Hiermee geeft u op hoe de LCM (Local Configuration Manager) de configuratie daadwerkelijk toepast op de doelknooppunten. Mogelijke waarden zijn ApplyOnly, ApplyAndMonitor en ApplyAndAutoCorrect. |
'Toepassen en AutoCorrigeren'
'Toepassen en monitoren'
'Alleen toepassen' |
| configuratieModeFrequencyMins |
Hoe vaak, in minuten, de huidige configuratie wordt gecontroleerd en toegepast. Deze eigenschap wordt genegeerd als de eigenschap ConfigurationMode is ingesteld op ApplyOnly. De standaardwaarde is 15. |
Int |
| opnieuw opstarten indien nodig |
Stel dit in op True om het knooppunt automatisch opnieuw op te starten nadat een configuratie waarvoor opnieuw opstarten is vereist, is toegepast. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie die dit vereist. De standaardwaarde is onwaar. Als u deze instelling wilt gebruiken wanneer een voorwaarde voor opnieuw opstarten wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de xPendingReboot-module. |
Bool |
| vernieuwenFrequentieMins |
Het tijdsinterval, in minuten, waarmee de LCM een pull-service controleert om bijgewerkte configuraties op te halen. Deze waarde wordt genegeerd als de LCM niet is geconfigureerd in de pull-modus. De standaardwaarde is 30. |
Int |
GuestConfigurationAssignmentProperties
| Naam |
Beschrijving |
Waarde |
| context |
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy |
snaar |
| guestConfiguratie |
De gastconfiguratie die moet worden toegewezen. |
GastConfiguratieNavigatie |
| laatsteOpdrachtRapport |
Rapport over de laatste gerapporteerde gastconfiguratietoewijzing. |
AssignmentReport- |
| vmssVMList |
De lijst met VM-nalevingsgegevens voor VMSS |
VmssvmInfo |
GastConfiguratieNavigatie
| Naam |
Beschrijving |
Waarde |
| opdrachtType |
Hiermee geeft u het toewijzingstype en de uitvoering van de configuratie. Mogelijke waarden zijn Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect en ApplyAndMonitor. |
'Toepassen en AutoCorrigeren'
'Toepassen en monitoren'
'Controle'
'Implementeren en AutoCorrigeren' |
| configuratieParameter |
De configuratieparameters voor de gastconfiguratie. |
ConfiguratieParameter |
| configurationProtectedParameter |
De beveiligde configuratieparameters voor de gastconfiguratie. |
ConfiguratieParameter |
| configuratieInstelling |
De configuratie-instelling voor de gastconfiguratie. |
ConfigurationSetting- |
| inhoud Hasj |
Gecombineerde hash van het gastconfiguratiepakket en configuratieparameters. |
snaar |
| inhoudUri |
Uri van de opslag waar het gastconfiguratiepakket wordt geüpload. |
snaar |
| soort |
Soort gastconfiguratie. Bijvoorbeeld: DSC |
DSC |
| naam |
Naam van de gastconfiguratie. |
snaar |
| Versie |
Versie van de gastconfiguratie. |
snaar |
VMInfo
VmssvmInfo
Gebruiksvoorbeelden
Azure-snelstartvoorbeelden
De volgende Azure-quickstartsjablonen bicep-voorbeelden bevatten voor het implementeren van dit resourcetype.
| Bicep-bestand |
Beschrijving |
|
VIRTUELE IIS-machines & SQL Server 2014-VM's |
Maak 1 of 2 IIS Windows 2012 R2 Webservers en één back-end SQL Server 2014 in VNET. |
|
Windows-VM met beveiligde basislijn van Azure |
De sjabloon maakt een virtuele machine met Windows Server in een nieuw virtueel netwerk, met een openbaar IP-adres. Zodra de machine is geïmplementeerd, wordt de gastconfiguratie-extensie geïnstalleerd en wordt de beveiligde basislijn van Azure voor Windows Server toegepast. Als de configuratie van de machines afdrijdt, kunt u de instellingen opnieuw toepassen door de sjabloon opnieuw te implementeren. |
Resourcedefinitie van ARM-sjabloon
Het resourcetype guestConfigurationAssignments kan worden geïmplementeerd met bewerkingen die zijn gericht op:
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Als u een Microsoft.GuestConfiguration/guestConfigurationAssignments-resource wilt maken, voegt u de volgende JSON toe aan uw sjabloon.
{
"type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
"apiVersion": "2020-06-25",
"name": "string",
"location": "string",
"properties": {
"context": "string",
"guestConfiguration": {
"assignmentType": "string",
"configurationParameter": [
{
"name": "string",
"value": "string"
}
],
"configurationProtectedParameter": [
{
"name": "string",
"value": "string"
}
],
"configurationSetting": {
"actionAfterReboot": "string",
"allowModuleOverwrite": "bool",
"configurationMode": "string",
"configurationModeFrequencyMins": "int",
"rebootIfNeeded": "bool",
"refreshFrequencyMins": "int"
},
"contentHash": "string",
"contentUri": "string",
"kind": "string",
"name": "string",
"version": "string"
},
"latestAssignmentReport": {
"assignment": {
"configuration": {
}
},
"resources": [
{
"reasons": [
{
}
]
}
],
"vm": {
}
},
"vmssVMList": [
{
}
]
}
}
Eigenschapswaarden
Microsoft.GuestConfiguration/guestConfigurationAssignments
| Naam |
Beschrijving |
Waarde |
| apiVersion |
De API-versie |
'2020-06-25' |
| plaats |
Regio waar de VIRTUELE machine zich bevindt. |
snaar |
| naam |
De resourcenaam |
tekenreeks (vereist) |
| Eigenschappen |
Eigenschappen van de toewijzing van de gastconfiguratie. |
GuestConfigurationAssignmentProperties- |
| soort |
Het resourcetype |
'Microsoft.GuestConfiguration/guestConfigurationAssignments' |
Opdracht Info
Toewijzingsrapport
| Naam |
Beschrijving |
Waarde |
| taak |
Configuratiedetails van de toewijzing van de gastconfiguratie. |
AssignmentInfo- |
| weg |
De lijst met resources waarvoor naleving van gastconfiguratietoewijzingen is gecontroleerd. |
AssignmentReportResource |
| Vm |
Informatie over de VIRTUELE machine. |
VMInfo- |
AssignmentReportResource
AssignmentReportResourceComplianceReason
Configuratie-info
ConfigurationParameter
| Naam |
Beschrijving |
Waarde |
| naam |
Naam van de configuratieparameter. |
snaar |
| waarde |
Waarde van de configuratieparameter. |
snaar |
Configuratie-instelling
| Naam |
Beschrijving |
Waarde |
| actieNaOpnieuw opstarten |
Hiermee geeft u op wat er gebeurt na het opnieuw opstarten tijdens de toepassing van een configuratie. De mogelijke waarden zijn ContinueConfiguration en StopConfiguration |
ContinueConfiguration
'StopConfiguratie' |
| allowModuleOverwrite |
Indien waar: nieuwe configuraties die zijn gedownload van de pull-service, mogen de oude configuraties op het doelknooppunt overschrijven. Anders, onwaar |
Bool |
| configuratieModus |
Hiermee geeft u op hoe de LCM (Local Configuration Manager) de configuratie daadwerkelijk toepast op de doelknooppunten. Mogelijke waarden zijn ApplyOnly, ApplyAndMonitor en ApplyAndAutoCorrect. |
'Toepassen en AutoCorrigeren'
'Toepassen en monitoren'
'Alleen toepassen' |
| configuratieModeFrequencyMins |
Hoe vaak, in minuten, de huidige configuratie wordt gecontroleerd en toegepast. Deze eigenschap wordt genegeerd als de eigenschap ConfigurationMode is ingesteld op ApplyOnly. De standaardwaarde is 15. |
Int |
| opnieuw opstarten indien nodig |
Stel dit in op True om het knooppunt automatisch opnieuw op te starten nadat een configuratie waarvoor opnieuw opstarten is vereist, is toegepast. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie die dit vereist. De standaardwaarde is onwaar. Als u deze instelling wilt gebruiken wanneer een voorwaarde voor opnieuw opstarten wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de xPendingReboot-module. |
Bool |
| vernieuwenFrequentieMins |
Het tijdsinterval, in minuten, waarmee de LCM een pull-service controleert om bijgewerkte configuraties op te halen. Deze waarde wordt genegeerd als de LCM niet is geconfigureerd in de pull-modus. De standaardwaarde is 30. |
Int |
GuestConfigurationAssignmentProperties
| Naam |
Beschrijving |
Waarde |
| context |
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy |
snaar |
| guestConfiguratie |
De gastconfiguratie die moet worden toegewezen. |
GastConfiguratieNavigatie |
| laatsteOpdrachtRapport |
Rapport over de laatste gerapporteerde gastconfiguratietoewijzing. |
AssignmentReport- |
| vmssVMList |
De lijst met VM-nalevingsgegevens voor VMSS |
VmssvmInfo |
GastConfiguratieNavigatie
| Naam |
Beschrijving |
Waarde |
| opdrachtType |
Hiermee geeft u het toewijzingstype en de uitvoering van de configuratie. Mogelijke waarden zijn Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect en ApplyAndMonitor. |
'Toepassen en AutoCorrigeren'
'Toepassen en monitoren'
'Controle'
'Implementeren en AutoCorrigeren' |
| configuratieParameter |
De configuratieparameters voor de gastconfiguratie. |
ConfiguratieParameter |
| configurationProtectedParameter |
De beveiligde configuratieparameters voor de gastconfiguratie. |
ConfiguratieParameter |
| configuratieInstelling |
De configuratie-instelling voor de gastconfiguratie. |
ConfigurationSetting- |
| inhoud Hasj |
Gecombineerde hash van het gastconfiguratiepakket en configuratieparameters. |
snaar |
| inhoudUri |
Uri van de opslag waar het gastconfiguratiepakket wordt geüpload. |
snaar |
| soort |
Soort gastconfiguratie. Bijvoorbeeld: DSC |
DSC |
| naam |
Naam van de gastconfiguratie. |
snaar |
| Versie |
Versie van de gastconfiguratie. |
snaar |
VMInfo
VmssvmInfo
Gebruiksvoorbeelden
Azure-snelstartsjablonen
De volgende Azure-quickstartsjablonen dit resourcetype implementeren.
| Sjabloon |
Beschrijving |
VIRTUELE IIS-machines & SQL Server 2014-VM's
|
Maak 1 of 2 IIS Windows 2012 R2 Webservers en één back-end SQL Server 2014 in VNET. |
Windows-VM met beveiligde basislijn van Azure
|
De sjabloon maakt een virtuele machine met Windows Server in een nieuw virtueel netwerk, met een openbaar IP-adres. Zodra de machine is geïmplementeerd, wordt de gastconfiguratie-extensie geïnstalleerd en wordt de beveiligde basislijn van Azure voor Windows Server toegepast. Als de configuratie van de machines afdrijdt, kunt u de instellingen opnieuw toepassen door de sjabloon opnieuw te implementeren. |
Het resourcetype guestConfigurationAssignments kan worden geïmplementeerd met bewerkingen die zijn gericht op:
Zie logboek wijzigenvoor een lijst met gewijzigde eigenschappen in elke API-versie.
Als u een Microsoft.GuestConfiguration/guestConfigurationAssignments-resource wilt maken, voegt u de volgende Terraform toe aan uw sjabloon.
resource "azapi_resource" "symbolicname" {
type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2020-06-25"
name = "string"
parent_id = "string"
location = "string"
body = {
properties = {
context = "string"
guestConfiguration = {
assignmentType = "string"
configurationParameter = [
{
name = "string"
value = "string"
}
]
configurationProtectedParameter = [
{
name = "string"
value = "string"
}
]
configurationSetting = {
actionAfterReboot = "string"
allowModuleOverwrite = bool
configurationMode = "string"
configurationModeFrequencyMins = int
rebootIfNeeded = bool
refreshFrequencyMins = int
}
contentHash = "string"
contentUri = "string"
kind = "string"
name = "string"
version = "string"
}
latestAssignmentReport = {
assignment = {
configuration = {
}
}
resources = [
{
reasons = [
{
}
]
}
]
vm = {
}
}
vmssVMList = [
{
}
]
}
}
}
Eigenschapswaarden
Microsoft.GuestConfiguration/guestConfigurationAssignments
| Naam |
Beschrijving |
Waarde |
| plaats |
Regio waar de VIRTUELE machine zich bevindt. |
snaar |
| naam |
De resourcenaam |
tekenreeks (vereist) |
| ouder_id |
De id van de resource waar deze extensieresource op moet worden toegepast. |
tekenreeks (vereist) |
| Eigenschappen |
Eigenschappen van de toewijzing van de gastconfiguratie. |
GuestConfigurationAssignmentProperties- |
| soort |
Het resourcetype |
"Microsoft.GuestConfiguration/guestConfigurationAssignments@2020-06-25" |
Opdracht Info
Toewijzingsrapport
| Naam |
Beschrijving |
Waarde |
| taak |
Configuratiedetails van de toewijzing van de gastconfiguratie. |
AssignmentInfo- |
| weg |
De lijst met resources waarvoor naleving van gastconfiguratietoewijzingen is gecontroleerd. |
AssignmentReportResource |
| Vm |
Informatie over de VIRTUELE machine. |
VMInfo- |
AssignmentReportResource
AssignmentReportResourceComplianceReason
Configuratie-info
ConfigurationParameter
| Naam |
Beschrijving |
Waarde |
| naam |
Naam van de configuratieparameter. |
snaar |
| waarde |
Waarde van de configuratieparameter. |
snaar |
Configuratie-instelling
| Naam |
Beschrijving |
Waarde |
| actieNaOpnieuw opstarten |
Hiermee geeft u op wat er gebeurt na het opnieuw opstarten tijdens de toepassing van een configuratie. De mogelijke waarden zijn ContinueConfiguration en StopConfiguration |
ContinueConfiguration
'StopConfiguratie' |
| allowModuleOverwrite |
Indien waar: nieuwe configuraties die zijn gedownload van de pull-service, mogen de oude configuraties op het doelknooppunt overschrijven. Anders, onwaar |
Bool |
| configuratieModus |
Hiermee geeft u op hoe de LCM (Local Configuration Manager) de configuratie daadwerkelijk toepast op de doelknooppunten. Mogelijke waarden zijn ApplyOnly, ApplyAndMonitor en ApplyAndAutoCorrect. |
'Toepassen en AutoCorrigeren'
'Toepassen en monitoren'
'Alleen toepassen' |
| configuratieModeFrequencyMins |
Hoe vaak, in minuten, de huidige configuratie wordt gecontroleerd en toegepast. Deze eigenschap wordt genegeerd als de eigenschap ConfigurationMode is ingesteld op ApplyOnly. De standaardwaarde is 15. |
Int |
| opnieuw opstarten indien nodig |
Stel dit in op True om het knooppunt automatisch opnieuw op te starten nadat een configuratie waarvoor opnieuw opstarten is vereist, is toegepast. Anders moet u het knooppunt handmatig opnieuw opstarten voor elke configuratie die dit vereist. De standaardwaarde is onwaar. Als u deze instelling wilt gebruiken wanneer een voorwaarde voor opnieuw opstarten wordt uitgevoerd door iets anders dan DSC (zoals Windows Installer), combineert u deze instelling met de xPendingReboot-module. |
Bool |
| vernieuwenFrequentieMins |
Het tijdsinterval, in minuten, waarmee de LCM een pull-service controleert om bijgewerkte configuraties op te halen. Deze waarde wordt genegeerd als de LCM niet is geconfigureerd in de pull-modus. De standaardwaarde is 30. |
Int |
GuestConfigurationAssignmentProperties
| Naam |
Beschrijving |
Waarde |
| context |
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy |
snaar |
| guestConfiguratie |
De gastconfiguratie die moet worden toegewezen. |
GastConfiguratieNavigatie |
| laatsteOpdrachtRapport |
Rapport over de laatste gerapporteerde gastconfiguratietoewijzing. |
AssignmentReport- |
| vmssVMList |
De lijst met VM-nalevingsgegevens voor VMSS |
VmssvmInfo |
GastConfiguratieNavigatie
| Naam |
Beschrijving |
Waarde |
| opdrachtType |
Hiermee geeft u het toewijzingstype en de uitvoering van de configuratie. Mogelijke waarden zijn Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect en ApplyAndMonitor. |
'Toepassen en AutoCorrigeren'
'Toepassen en monitoren'
'Controle'
'Implementeren en AutoCorrigeren' |
| configuratieParameter |
De configuratieparameters voor de gastconfiguratie. |
ConfiguratieParameter |
| configurationProtectedParameter |
De beveiligde configuratieparameters voor de gastconfiguratie. |
ConfiguratieParameter |
| configuratieInstelling |
De configuratie-instelling voor de gastconfiguratie. |
ConfigurationSetting- |
| inhoud Hasj |
Gecombineerde hash van het gastconfiguratiepakket en configuratieparameters. |
snaar |
| inhoudUri |
Uri van de opslag waar het gastconfiguratiepakket wordt geüpload. |
snaar |
| soort |
Soort gastconfiguratie. Bijvoorbeeld: DSC |
DSC |
| naam |
Naam van de gastconfiguratie. |
snaar |
| Versie |
Versie van de gastconfiguratie. |
snaar |
VMInfo
VmssvmInfo