Freigeben über


Microsoft.GuestConfiguration guestConfigurationAssignments

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.

Ressourcenformat

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

Name Beschreibung Wert
Konfiguration Informationen zur Konfiguration. ConfigurationInfo-

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

Name Beschreibung Wert
Begründungen Compliancegrund und Grundcode für eine Ressource. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Name Beschreibung Wert

ConfigurationInfo

Name Beschreibung Wert

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 Erweiterungsressourceanzuwenden.

VMInfo

Name Beschreibung Wert

VmssvmInfo

Name Beschreibung Wert

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.

Ressourcenformat

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

Name Beschreibung Wert
Konfiguration Informationen zur Konfiguration. ConfigurationInfo-

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

Name Beschreibung Wert
Begründungen Compliancegrund und Grundcode für eine Ressource. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Name Beschreibung Wert

ConfigurationInfo

Name Beschreibung Wert

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

Name Beschreibung Wert

VmssvmInfo

Name Beschreibung Wert

Schnellstartvorlagen

Die folgenden Schnellstartvorlagen stellen diesen Ressourcentyp bereit.

Schablone Beschreibung
IIS-VMs & SQL Server 2014-VM-

Bereitstellen in Azure
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

Bereitstellen in Azure
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.

Terraform -Ressourcendefinition (AzAPI-Anbieter)

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.

Ressourcenformat

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

Name Beschreibung Wert
Konfiguration Informationen zur Konfiguration. ConfigurationInfo-

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

Name Beschreibung Wert
Begründungen Compliancegrund und Grundcode für eine Ressource. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Name Beschreibung Wert

ConfigurationInfo

Name Beschreibung Wert

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

Name Beschreibung Wert

VmssvmInfo

Name Beschreibung Wert