Microsoft.GuestConfiguration guestConfigurationAssignments
Artikel 12/21/2024
2 inzenders
Feedback
In dit artikel
Bicep-resourcedefinitie
Het resourcetype guestConfigurationAssignments kan worden geïmplementeerd met bewerkingen die zijn gericht op:
Zie logboek wijzigen voor 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@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: [
{}
]
}
}
Eigenschapswaarden
AssignmentInfo
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
ConfigurationInfo
ConfigurationParameter
Naam
Beschrijving
Waarde
naam
Naam van de configuratieparameter.
snaar
waarde
Waarde van de configuratieparameter.
snaar
GuestConfigurationAssignmentProperties
Naam
Beschrijving
Waarde
context
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy
snaar
guestConfiguration
De gastconfiguratie die moet worden toegewezen.
GuestConfigurationNavigation
latestAssignmentReport
Rapport over de laatste gerapporteerde gastconfiguratietoewijzing.
AssignmentReport-
vmssVMList
De lijst met VM-nalevingsgegevens voor VMSS
VmssvmInfo []
GuestConfigurationNavigation
Naam
Beschrijving
Waarde
assignmentType
Hiermee geeft u het toewijzingstype en de uitvoering van de configuratie. Mogelijke waarden zijn Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect en ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Controle' 'DeployAndAutoCorrect'
configurationParameter
De configuratieparameters voor de gastconfiguratie.
ConfigurationParameter []
configurationProtectedParameter
De beveiligde configuratieparameters voor de gastconfiguratie.
ConfigurationParameter []
contentHash
Gecombineerde hash van het gastconfiguratiepakket en configuratieparameters.
snaar
contentManagedIdentity
Beheerde identiteit met opslagtoegang tot het gastconfiguratiepakket en configuratieparameters.
snaar
contentUri
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
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 .
VMInfo
VmssvmInfo
Quickstart-voorbeelden
In de volgende quickstartvoorbeelden wordt dit resourcetype geïmplementeerd.
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 wijzigen voor 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": "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": [
{
}
]
}
}
Eigenschapswaarden
AssignmentInfo
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
ConfigurationInfo
ConfigurationParameter
Naam
Beschrijving
Waarde
naam
Naam van de configuratieparameter.
snaar
waarde
Waarde van de configuratieparameter.
snaar
GuestConfigurationAssignmentProperties
Naam
Beschrijving
Waarde
context
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy
snaar
guestConfiguration
De gastconfiguratie die moet worden toegewezen.
GuestConfigurationNavigation
latestAssignmentReport
Rapport over de laatste gerapporteerde gastconfiguratietoewijzing.
AssignmentReport-
vmssVMList
De lijst met VM-nalevingsgegevens voor VMSS
VmssvmInfo []
GuestConfigurationNavigation
Naam
Beschrijving
Waarde
assignmentType
Hiermee geeft u het toewijzingstype en de uitvoering van de configuratie. Mogelijke waarden zijn Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect en ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Controle' 'DeployAndAutoCorrect'
configurationParameter
De configuratieparameters voor de gastconfiguratie.
ConfigurationParameter []
configurationProtectedParameter
De beveiligde configuratieparameters voor de gastconfiguratie.
ConfigurationParameter []
contentHash
Gecombineerde hash van het gastconfiguratiepakket en configuratieparameters.
snaar
contentManagedIdentity
Beheerde identiteit met opslagtoegang tot het gastconfiguratiepakket en configuratieparameters.
snaar
contentUri
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
Microsoft.GuestConfiguration/guestConfigurationAssignments
Naam
Beschrijving
Waarde
apiVersion
De API-versie
'2024-04-05'
plaats
Regio waar de VIRTUELE machine zich bevindt.
snaar
naam
De resourcenaam
tekenreeks (vereist)
Eigenschappen
Eigenschappen van de toewijzing van de gastconfiguratie.
GuestConfigurationAssignmentProperties-
type
Het resourcetype
'Microsoft.GuestConfiguration/guestConfigurationAssignments'
VMInfo
VmssvmInfo
Quickstart-sjablonen
Met de volgende quickstart-sjablonen wordt dit resourcetype geïmplementeerd.
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 wijzigen voor 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@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 = [
{
}
]
}
})
}
Eigenschapswaarden
AssignmentInfo
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
ConfigurationInfo
ConfigurationParameter
Naam
Beschrijving
Waarde
naam
Naam van de configuratieparameter.
snaar
waarde
Waarde van de configuratieparameter.
snaar
GuestConfigurationAssignmentProperties
Naam
Beschrijving
Waarde
context
De bron waarmee de toewijzing van de gastconfiguratie is gestart. Bijvoorbeeld: Azure Policy
snaar
guestConfiguration
De gastconfiguratie die moet worden toegewezen.
GuestConfigurationNavigation
latestAssignmentReport
Rapport over de laatste gerapporteerde gastconfiguratietoewijzing.
AssignmentReport-
vmssVMList
De lijst met VM-nalevingsgegevens voor VMSS
VmssvmInfo []
GuestConfigurationNavigation
Naam
Beschrijving
Waarde
assignmentType
Hiermee geeft u het toewijzingstype en de uitvoering van de configuratie. Mogelijke waarden zijn Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect en ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'Controle' 'DeployAndAutoCorrect'
configurationParameter
De configuratieparameters voor de gastconfiguratie.
ConfigurationParameter []
configurationProtectedParameter
De beveiligde configuratieparameters voor de gastconfiguratie.
ConfigurationParameter []
contentHash
Gecombineerde hash van het gastconfiguratiepakket en configuratieparameters.
snaar
contentManagedIdentity
Beheerde identiteit met opslagtoegang tot het gastconfiguratiepakket en configuratieparameters.
snaar
contentUri
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
Microsoft.GuestConfiguration/guestConfigurationAssignments
Naam
Beschrijving
Waarde
plaats
Regio waar de VIRTUELE machine zich bevindt.
snaar
naam
De resourcenaam
tekenreeks (vereist)
parent_id
De id van de resource waar deze extensieresource op moet worden toegepast.
tekenreeks (vereist)
Eigenschappen
Eigenschappen van de toewijzing van de gastconfiguratie.
GuestConfigurationAssignmentProperties-
type
Het resourcetype
"Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05"
VMInfo
VmssvmInfo