Udostępnij za pośrednictwem

Microsoft.GuestConfiguration guestConfigurationAssignments

  • Artykuł

Definicja zasobu Bicep

Typ zasobu guestConfigurationAssignments można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.GuestConfiguration/guestConfigurationAssignments, dodaj następujący kod Bicep do szablonu.

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: [
      {}
    ]
  }
}

Wartości właściwości

Informacje o przydziałach

Nazwa Opis Wartość
konfiguracja Informacje o konfiguracji. ConfigurationInfo

Raport przydziału

Nazwa Opis Wartość
przypisanie Szczegóły konfiguracji przypisania konfiguracji gościa. AssignmentInfo
zasoby Lista zasobów, dla których jest sprawdzana zgodność przypisania konfiguracji gościa. AssignmentReportResource[]
Vm Informacje o maszynie wirtualnej. VMInfo

AssignmentReportResource

Nazwa Opis Wartość
Powodów Przyczyna zgodności i kod przyczyny zasobu. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Nazwa Opis Wartość

ConfigurationInfo

Nazwa Opis Wartość

ConfigurationParameter

Nazwa Opis Wartość
nazwa Nazwa parametru konfiguracji. struna
wartość Wartość parametru konfiguracji. struna

GuestConfigurationAssignmentProperties

Nazwa Opis Wartość
kontekst Źródło, które zainicjowało przypisanie konfiguracji gościa. Na przykład: Azure Policy struna
guestConfiguration Konfiguracja gościa do przypisania. GuestConfigurationNavigation
latestAssignmentReport Raport ostatniego zgłoszonego przypisania konfiguracji gościa. AssignmentReport
vmssVMList Lista danych zgodności maszyn wirtualnych dla zestawu skalowania maszyn wirtualnych vmssvmInfo[]

GuestConfigurationNavigation

Nazwa Opis Wartość
assignmentType Określa typ przypisania i wykonywanie konfiguracji. Możliwe wartości to Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect i ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Inspekcja"
"DeployAndAutoCorrect"
configurationParameter Parametry konfiguracji dla konfiguracji gościa. ConfigurationParameter[]
configurationProtectedParameter Parametry konfiguracji chronionej dla konfiguracji gościa. ConfigurationParameter[]
contentHash Połączony skrót pakietu konfiguracji gościa i parametrów konfiguracji. struna
contentManagedIdentity Tożsamość zarządzana z dostępem do magazynu pakietu konfiguracji gościa i parametrów konfiguracji. struna
contentUri Identyfikator URI magazynu, w którym jest przekazywany pakiet konfiguracji gościa. struna
rodzaj Rodzaj konfiguracji gościa. Na przykład:DSC "DSC"
nazwa Nazwa konfiguracji gościa. struna
Wersja Wersja konfiguracji gościa. struna

Microsoft.GuestConfiguration/guestConfigurationAssignments

Nazwa Opis Wartość
lokalizacja Region, w którym znajduje się maszyna wirtualna. struna
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości przypisania konfiguracji gościa. GuestConfigurationAssignmentProperties
zakres Użyj polecenia podczas tworzenia zasobu w zakresie innym niż zakres wdrożenia. Ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia .

VMInfo

Nazwa Opis Wartość

VmssvmInfo

Nazwa Opis Wartość

Przykłady użycia

Przykłady szybkiego startu platformy Azure

Poniższe szablony szybkiego startu platformy Azure zawierają przykłady Bicep na potrzeby wdrażania tego typu zasobu.

Plik Bicep Opis
maszyn wirtualnych usług IIS & maszyn wirtualnych programu SQL Server 2014 Utwórz 1 lub 2 serwery sieci Web usług IIS Windows 2012 R2 i jeden zaplecze programu SQL Server 2014 w sieci wirtualnej.
maszyny wirtualnej z systemem Windows z bezpiecznym punktem odniesienia platformy Azure Szablon tworzy maszynę wirtualną z systemem Windows Server w nowej sieci wirtualnej z publicznym adresem IP. Po wdrożeniu maszyny zostanie zainstalowane rozszerzenie konfiguracji gościa i zostanie zastosowany bezpieczny punkt odniesienia platformy Azure dla systemu Windows Server. Jeśli konfiguracja maszyn dryfuje, możesz ponownie zastosować ustawienia, ponownie wdrażając szablon.

Definicja zasobu szablonu usługi ARM

Typ zasobu guestConfigurationAssignments można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.GuestConfiguration/guestConfigurationAssignments, dodaj następujący kod JSON do szablonu.

{
  "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": [
      {
      }
    ]
  }
}

Wartości właściwości

Informacje o przydziałach

Nazwa Opis Wartość
konfiguracja Informacje o konfiguracji. ConfigurationInfo

Raport przydziału

Nazwa Opis Wartość
przypisanie Szczegóły konfiguracji przypisania konfiguracji gościa. AssignmentInfo
zasoby Lista zasobów, dla których jest sprawdzana zgodność przypisania konfiguracji gościa. AssignmentReportResource[]
Vm Informacje o maszynie wirtualnej. VMInfo

AssignmentReportResource

Nazwa Opis Wartość
Powodów Przyczyna zgodności i kod przyczyny zasobu. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Nazwa Opis Wartość

ConfigurationInfo

Nazwa Opis Wartość

ConfigurationParameter

Nazwa Opis Wartość
nazwa Nazwa parametru konfiguracji. struna
wartość Wartość parametru konfiguracji. struna

GuestConfigurationAssignmentProperties

Nazwa Opis Wartość
kontekst Źródło, które zainicjowało przypisanie konfiguracji gościa. Na przykład: Azure Policy struna
guestConfiguration Konfiguracja gościa do przypisania. GuestConfigurationNavigation
latestAssignmentReport Raport ostatniego zgłoszonego przypisania konfiguracji gościa. AssignmentReport
vmssVMList Lista danych zgodności maszyn wirtualnych dla zestawu skalowania maszyn wirtualnych vmssvmInfo[]

GuestConfigurationNavigation

Nazwa Opis Wartość
assignmentType Określa typ przypisania i wykonywanie konfiguracji. Możliwe wartości to Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect i ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Inspekcja"
"DeployAndAutoCorrect"
configurationParameter Parametry konfiguracji dla konfiguracji gościa. ConfigurationParameter[]
configurationProtectedParameter Parametry konfiguracji chronionej dla konfiguracji gościa. ConfigurationParameter[]
contentHash Połączony skrót pakietu konfiguracji gościa i parametrów konfiguracji. struna
contentManagedIdentity Tożsamość zarządzana z dostępem do magazynu pakietu konfiguracji gościa i parametrów konfiguracji. struna
contentUri Identyfikator URI magazynu, w którym jest przekazywany pakiet konfiguracji gościa. struna
rodzaj Rodzaj konfiguracji gościa. Na przykład:DSC "DSC"
nazwa Nazwa konfiguracji gościa. struna
Wersja Wersja konfiguracji gościa. struna

Microsoft.GuestConfiguration/guestConfigurationAssignments

Nazwa Opis Wartość
apiVersion Wersja interfejsu API '2024-04-05'
lokalizacja Region, w którym znajduje się maszyna wirtualna. struna
nazwa Nazwa zasobu ciąg (wymagany)
Właściwości Właściwości przypisania konfiguracji gościa. GuestConfigurationAssignmentProperties
typ Typ zasobu "Microsoft.GuestConfiguration/guestConfigurationAssignments"

VMInfo

Nazwa Opis Wartość

VmssvmInfo

Nazwa Opis Wartość

Przykłady użycia

Szablony szybkiego startu platformy Azure

Następujące szablony szybkiego startu platformy Azure wdrożyć ten typ zasobu.

Szablon Opis
maszyn wirtualnych usług IIS & maszyn wirtualnych programu SQL Server 2014

wdrażanie w usłudze Azure		 Utwórz 1 lub 2 serwery sieci Web usług IIS Windows 2012 R2 i jeden zaplecze programu SQL Server 2014 w sieci wirtualnej.
maszyny wirtualnej z systemem Windows z bezpiecznym punktem odniesienia platformy Azure

wdrażanie w usłudze Azure		 Szablon tworzy maszynę wirtualną z systemem Windows Server w nowej sieci wirtualnej z publicznym adresem IP. Po wdrożeniu maszyny zostanie zainstalowane rozszerzenie konfiguracji gościa i zostanie zastosowany bezpieczny punkt odniesienia platformy Azure dla systemu Windows Server. Jeśli konfiguracja maszyn dryfuje, możesz ponownie zastosować ustawienia, ponownie wdrażając szablon.

Definicja zasobu narzędzia Terraform (dostawcy AzAPI)

Typ zasobu guestConfigurationAssignments można wdrożyć przy użyciu operacji docelowych:

Aby uzyskać listę zmienionych właściwości w każdej wersji interfejsu API, zobacz dziennika zmian.

Format zasobu

Aby utworzyć zasób Microsoft.GuestConfiguration/guestConfigurationAssignments, dodaj następujący program Terraform do szablonu.

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 = [
        {
        }
      ]
    }
  })
}

Wartości właściwości

Informacje o przydziałach

Nazwa Opis Wartość
konfiguracja Informacje o konfiguracji. ConfigurationInfo

Raport przydziału

Nazwa Opis Wartość
przypisanie Szczegóły konfiguracji przypisania konfiguracji gościa. AssignmentInfo
zasoby Lista zasobów, dla których jest sprawdzana zgodność przypisania konfiguracji gościa. AssignmentReportResource[]
Vm Informacje o maszynie wirtualnej. VMInfo

AssignmentReportResource

Nazwa Opis Wartość
Powodów Przyczyna zgodności i kod przyczyny zasobu. AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Nazwa Opis Wartość

ConfigurationInfo

Nazwa Opis Wartość

ConfigurationParameter

Nazwa Opis Wartość
nazwa Nazwa parametru konfiguracji. struna
wartość Wartość parametru konfiguracji. struna

GuestConfigurationAssignmentProperties

Nazwa Opis Wartość
kontekst Źródło, które zainicjowało przypisanie konfiguracji gościa. Na przykład: Azure Policy struna
guestConfiguration Konfiguracja gościa do przypisania. GuestConfigurationNavigation
latestAssignmentReport Raport ostatniego zgłoszonego przypisania konfiguracji gościa. AssignmentReport
vmssVMList Lista danych zgodności maszyn wirtualnych dla zestawu skalowania maszyn wirtualnych vmssvmInfo[]

GuestConfigurationNavigation

Nazwa Opis Wartość
assignmentType Określa typ przypisania i wykonywanie konfiguracji. Możliwe wartości to Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect i ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Inspekcja"
"DeployAndAutoCorrect"
configurationParameter Parametry konfiguracji dla konfiguracji gościa. ConfigurationParameter[]
configurationProtectedParameter Parametry konfiguracji chronionej dla konfiguracji gościa. ConfigurationParameter[]
contentHash Połączony skrót pakietu konfiguracji gościa i parametrów konfiguracji. struna
contentManagedIdentity Tożsamość zarządzana z dostępem do magazynu pakietu konfiguracji gościa i parametrów konfiguracji. struna
contentUri Identyfikator URI magazynu, w którym jest przekazywany pakiet konfiguracji gościa. struna
rodzaj Rodzaj konfiguracji gościa. Na przykład:DSC "DSC"
nazwa Nazwa konfiguracji gościa. struna
Wersja Wersja konfiguracji gościa. struna

Microsoft.GuestConfiguration/guestConfigurationAssignments

Nazwa Opis Wartość
lokalizacja Region, w którym znajduje się maszyna wirtualna. struna
nazwa Nazwa zasobu ciąg (wymagany)
parent_id Identyfikator zasobu, do który ma być stosowany ten zasób rozszerzenia. ciąg (wymagany)
Właściwości Właściwości przypisania konfiguracji gościa. GuestConfigurationAssignmentProperties
typ Typ zasobu "Microsoft.GuestConfiguration/guestConfigurationAssignments@2024-04-05"

VMInfo

Nazwa Opis Wartość

VmssvmInfo

Nazwa Opis Wartość