Microsoft.GuestConfiguration guestConfigurationAssignments
Artikel 12/20/2024
2 Mitwirkende
Feedback
In diesem Artikel
Bicep-Ressourcendefinition
Der Ressourcentyp "guestConfigurationAssignments" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll .
Um eine Microsoft.GuestConfiguration/guestConfigurationAssignments-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.
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: [
{}
]
}
}
Eigenschaftswerte
AssignmentInfo
AssignmentReport
Name
Beschreibung
Wert
Zuweisung
Konfigurationsdetails der Gastkonfigurationszuweisung.
AssignmentInfo-
Betriebsmittel
Die Liste der Ressourcen, für die die Kompatibilität der Gastkonfigurationszuweisung überprüft wird.
AssignmentReportResource- []
vm
Informationen über den virtuellen Computer.
VMInfo-
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Name
Beschreibung
Wert
Name
Name des Konfigurationsparameters.
Schnur
Wert
Wert des Konfigurationsparameters.
Schnur
GuestConfigurationAssignmentProperties
Name
Beschreibung
Wert
Zusammenhang
Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie
Schnur
guestConfiguration
Die zuzuweisende Gastkonfiguration.
GuestConfigurationNavigation
latestAssignmentReport
Zuletzt gemeldeter Bericht zur Gastkonfigurationszuweisung.
AssignmentReport-
vmssVMList
Die Liste der VM-Compliancedaten für VMSS
VmssvmInfo []
GuestConfigurationNavigation
Name
Beschreibung
Wert
assignmentType
Gibt den Zuordnungstyp und die Ausführung der Konfiguration an. Mögliche Werte sind Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect und ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' "Überwachung" 'DeployAndAutoCorrect'
configurationParameter
Die Konfigurationsparameter für die Gastkonfiguration.
ConfigurationParameter- []
configurationProtectedParameter
Die geschützten Konfigurationsparameter für die Gastkonfiguration.
ConfigurationParameter- []
contentHash
Kombinierter Hash des Gastkonfigurationspakets und der Konfigurationsparameter.
Schnur
contentManagedIdentity
Verwaltete Identität mit Speicherzugriff auf das Gastkonfigurationspaket und Konfigurationsparameter.
Schnur
contentUri
URI des Speichers, in den das Gastkonfigurationspaket hochgeladen wird.
Schnur
Art
Art der Gastkonfiguration. Beispiel:DSC
"DSC"
Name
Name der Gastkonfiguration.
Schnur
Version
Version der Gastkonfiguration.
Schnur
Microsoft.GuestConfiguration/guestConfigurationAssignments
Name
Beschreibung
Wert
Ort
Region, in der sich der virtuelle Computer befindet.
Schnur
Name
Der Ressourcenname
Zeichenfolge (erforderlich)
Eigenschaften
Eigenschaften der Gastkonfigurationszuweisung.
GuestConfigurationAssignmentProperties
Umfang
Verwenden Sie diese Verwendung beim Erstellen einer Ressource in einem Bereich, der sich von dem Bereitstellungsbereich unterscheidet.
Legen Sie diese Eigenschaft auf den symbolischen Namen einer Ressource fest, um die Erweiterungsressource anzuwenden.
VMInfo
VmssvmInfo
Schnellstartbeispiele
Die folgenden Schnellstartbeispiele stellen diesen Ressourcentyp bereit.
Bicep-Datei
Beschreibung
IIS-VMs & SQL Server 2014-VM-
Erstellen Sie 1 oder 2 IIS Windows 2012 R2-Webserver und ein Back-End SQL Server 2014 in VNET.
Windows-VM mit azure secure baseline
Die Vorlage erstellt einen virtuellen Computer mit Windows Server in einem neuen virtuellen Netzwerk mit einer öffentlichen IP-Adresse. Sobald der Computer bereitgestellt wurde, wird die Gastkonfigurationserweiterung installiert, und die azure secure baseline für Windows Server wird angewendet. Wenn sich die Konfiguration der Computer bewegt, können Sie die Einstellungen erneut anwenden, indem Sie die Vorlage erneut bereitstellen.
ARM-Vorlagenressourcendefinition
Der Ressourcentyp "guestConfigurationAssignments" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll .
Um eine Microsoft.GuestConfiguration/guestConfigurationAssignments-Ressource zu erstellen, fügen Sie Der Vorlage den folgenden JSON-Code hinzu.
{
"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": [
{
}
]
}
}
Eigenschaftswerte
AssignmentInfo
AssignmentReport
Name
Beschreibung
Wert
Zuweisung
Konfigurationsdetails der Gastkonfigurationszuweisung.
AssignmentInfo-
Betriebsmittel
Die Liste der Ressourcen, für die die Kompatibilität der Gastkonfigurationszuweisung überprüft wird.
AssignmentReportResource- []
vm
Informationen über den virtuellen Computer.
VMInfo-
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Name
Beschreibung
Wert
Name
Name des Konfigurationsparameters.
Schnur
Wert
Wert des Konfigurationsparameters.
Schnur
GuestConfigurationAssignmentProperties
Name
Beschreibung
Wert
Zusammenhang
Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie
Schnur
guestConfiguration
Die zuzuweisende Gastkonfiguration.
GuestConfigurationNavigation
latestAssignmentReport
Zuletzt gemeldeter Bericht zur Gastkonfigurationszuweisung.
AssignmentReport-
vmssVMList
Die Liste der VM-Compliancedaten für VMSS
VmssvmInfo []
GuestConfigurationNavigation
Name
Beschreibung
Wert
assignmentType
Gibt den Zuordnungstyp und die Ausführung der Konfiguration an. Mögliche Werte sind Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect und ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' "Überwachung" 'DeployAndAutoCorrect'
configurationParameter
Die Konfigurationsparameter für die Gastkonfiguration.
ConfigurationParameter- []
configurationProtectedParameter
Die geschützten Konfigurationsparameter für die Gastkonfiguration.
ConfigurationParameter- []
contentHash
Kombinierter Hash des Gastkonfigurationspakets und der Konfigurationsparameter.
Schnur
contentManagedIdentity
Verwaltete Identität mit Speicherzugriff auf das Gastkonfigurationspaket und Konfigurationsparameter.
Schnur
contentUri
URI des Speichers, in den das Gastkonfigurationspaket hochgeladen wird.
Schnur
Art
Art der Gastkonfiguration. Beispiel:DSC
"DSC"
Name
Name der Gastkonfiguration.
Schnur
Version
Version der Gastkonfiguration.
Schnur
Microsoft.GuestConfiguration/guestConfigurationAssignments
Name
Beschreibung
Wert
apiVersion
Die API-Version
'2024-04-05'
Ort
Region, in der sich der virtuelle Computer befindet.
Schnur
Name
Der Ressourcenname
Zeichenfolge (erforderlich)
Eigenschaften
Eigenschaften der Gastkonfigurationszuweisung.
GuestConfigurationAssignmentProperties
Art
Der Ressourcentyp
'Microsoft.GuestConfiguration/guestConfigurationAssignments'
VMInfo
VmssvmInfo
Schnellstartvorlagen
Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.
Schablone
Beschreibung
IIS-VMs & SQL Server 2014-VM-
Erstellen Sie 1 oder 2 IIS Windows 2012 R2-Webserver und ein Back-End SQL Server 2014 in VNET.
Windows-VM mit azure secure baseline
Die Vorlage erstellt einen virtuellen Computer mit Windows Server in einem neuen virtuellen Netzwerk mit einer öffentlichen IP-Adresse. Sobald der Computer bereitgestellt wurde, wird die Gastkonfigurationserweiterung installiert, und die azure secure baseline für Windows Server wird angewendet. Wenn sich die Konfiguration der Computer bewegt, können Sie die Einstellungen erneut anwenden, indem Sie die Vorlage erneut bereitstellen.
Der Ressourcentyp "guestConfigurationAssignments" kann mit Vorgängen bereitgestellt werden, die auf Folgendes abzielen:
Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll .
Um eine Microsoft.GuestConfiguration/guestConfigurationAssignments-Ressource zu erstellen, fügen Sie Ihrer Vorlage die folgende Terraform hinzu.
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 = [
{
}
]
}
})
}
Eigenschaftswerte
AssignmentInfo
AssignmentReport
Name
Beschreibung
Wert
Zuweisung
Konfigurationsdetails der Gastkonfigurationszuweisung.
AssignmentInfo-
Betriebsmittel
Die Liste der Ressourcen, für die die Kompatibilität der Gastkonfigurationszuweisung überprüft wird.
AssignmentReportResource- []
vm
Informationen über den virtuellen Computer.
VMInfo-
AssignmentReportResource
AssignmentReportResourceComplianceReason
ConfigurationInfo
ConfigurationParameter
Name
Beschreibung
Wert
Name
Name des Konfigurationsparameters.
Schnur
Wert
Wert des Konfigurationsparameters.
Schnur
GuestConfigurationAssignmentProperties
Name
Beschreibung
Wert
Zusammenhang
Die Quelle, die die Gastkonfigurationszuweisung initiiert hat. Beispiel: Azure-Richtlinie
Schnur
guestConfiguration
Die zuzuweisende Gastkonfiguration.
GuestConfigurationNavigation
latestAssignmentReport
Zuletzt gemeldeter Bericht zur Gastkonfigurationszuweisung.
AssignmentReport-
vmssVMList
Die Liste der VM-Compliancedaten für VMSS
VmssvmInfo []
GuestConfigurationNavigation
Name
Beschreibung
Wert
assignmentType
Gibt den Zuordnungstyp und die Ausführung der Konfiguration an. Mögliche Werte sind Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect und ApplyAndMonitor.
'ApplyAndAutoCorrect' 'ApplyAndMonitor' "Überwachung" 'DeployAndAutoCorrect'
configurationParameter
Die Konfigurationsparameter für die Gastkonfiguration.
ConfigurationParameter- []
configurationProtectedParameter
Die geschützten Konfigurationsparameter für die Gastkonfiguration.
ConfigurationParameter- []
contentHash
Kombinierter Hash des Gastkonfigurationspakets und der Konfigurationsparameter.
Schnur
contentManagedIdentity
Verwaltete Identität mit Speicherzugriff auf das Gastkonfigurationspaket und Konfigurationsparameter.
Schnur
contentUri
URI des Speichers, in den das Gastkonfigurationspaket hochgeladen wird.
Schnur
Art
Art der Gastkonfiguration. Beispiel:DSC
"DSC"
Name
Name der Gastkonfiguration.
Schnur
Version
Version der Gastkonfiguration.
Schnur
Microsoft.GuestConfiguration/guestConfigurationAssignments
Name
Beschreibung
Wert
Ort
Region, in der sich der virtuelle Computer befindet.
Schnur
Name
Der Ressourcenname
Zeichenfolge (erforderlich)
parent_id
Die ID der Ressource, auf die diese Erweiterungsressource angewendet werden soll.
Zeichenfolge (erforderlich)
Eigenschaften
Eigenschaften der Gastkonfigurationszuweisung.
GuestConfigurationAssignmentProperties
Art
Der Ressourcentyp
"Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05"
VMInfo
VmssvmInfo