Udostępnij za pośrednictwem


Microsoft.GuestConfiguration guestConfigurationAssignments

Definicja zasobu Bicep

Typ zasobu guestConfigurationAssignments to zasób rozszerzenia , co oznacza, że można zastosować go do innego zasobu.

Użyj właściwości scope dla tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń wBicep.

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@2022-01-25' = {
  name: 'string'
  location: 'string'
  scope: resourceSymbolicName
  properties: {
    context: 'string'
    guestConfiguration: {
      assignmentType: 'string'
      configurationParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationProtectedParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      contentHash: 'string'
      contentUri: 'string'
      kind: 'DSC'
      name: 'string'
      version: 'string'
    }
    latestAssignmentReport: {
      assignment: {
        configuration: {}
      }
      resources: [
        {
          reasons: [
            {
            }
          ]
        }
      ]
      vm: {}
    }
    vmssVMList: [
      {
      }
    ]
  }
}

Wartości właściwości

guestConfigurationAssignments

Nazwa Opis Wartość
nazwa Nazwa zasobu ciąg (wymagany)
lokalizacja Region, w którym znajduje się maszyna wirtualna. struna
zakres Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

Dla Bicep ustaw tę właściwość na symboliczną nazwę zasobu, aby zastosować zasób rozszerzenia .
Właściwości Właściwości przypisania konfiguracji gościa. GuestConfigurationAssignmentProperties

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

ConfigurationParameter

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

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

Informacje o przydziałach

Nazwa Opis Wartość
konfiguracja Informacje o konfiguracji. ConfigurationInfo

ConfigurationInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

AssignmentReportResource

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

AssignmentReportResourceComplianceReason

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

VMInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

VmssvmInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają 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 szablonu usługi ARM

Typ zasobu guestConfigurationAssignments to zasób rozszerzenia , co oznacza, że można zastosować go do innego zasobu.

Użyj właściwości scope dla tego zasobu, aby ustawić zakres dla tego zasobu. Zobacz Ustawianie zakresu dla zasobów rozszerzeń w szablonach usługi ARM.

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": "2022-01-25",
  "name": "string",
  "location": "string",
  "scope": "string",
  "properties": {
    "context": "string",
    "guestConfiguration": {
      "assignmentType": "string",
      "configurationParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationProtectedParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "contentHash": "string",
      "contentUri": "string",
      "kind": "DSC",
      "name": "string",
      "version": "string"
    },
    "latestAssignmentReport": {
      "assignment": {
        "configuration": {}
      },
      "resources": [
        {
          "reasons": [
            {
            }
          ]
        }
      ],
      "vm": {}
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

Wartości właściwości

guestConfigurationAssignments

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.GuestConfiguration/guestConfigurationAssignments"
apiVersion Wersja interfejsu API zasobów '2022-01-25'
nazwa Nazwa zasobu ciąg (wymagany)
lokalizacja Region, w którym znajduje się maszyna wirtualna. struna
zakres Użyj polecenia podczas tworzenia zasobu rozszerzenia w zakresie innym niż zakres wdrożenia. Zasób docelowy

W przypadku formatu JSON ustaw wartość na pełną nazwę zasobu, aby zastosować zasobu rozszerzenia .
Właściwości Właściwości przypisania konfiguracji gościa. GuestConfigurationAssignmentProperties

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

ConfigurationParameter

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

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

Informacje o przydziałach

Nazwa Opis Wartość
konfiguracja Informacje o konfiguracji. ConfigurationInfo

ConfigurationInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

AssignmentReportResource

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

AssignmentReportResourceComplianceReason

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

VMInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

VmssvmInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

Szablony szybkiego startu

Następujące szablony szybkiego startu wdrażają 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 to zasób rozszerzenia , co oznacza, że można zastosować go do innego zasobu.

Użyj właściwości parent_id dla tego zasobu, aby ustawić zakres dla tego zasobu.

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@2022-01-25"
  name = "string"
  location = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      context = "string"
      guestConfiguration = {
        assignmentType = "string"
        configurationParameter = [
          {
            name = "string"
            value = "string"
          }
        ]
        configurationProtectedParameter = [
          {
            name = "string"
            value = "string"
          }
        ]
        contentHash = "string"
        contentUri = "string"
        kind = "DSC"
        name = "string"
        version = "string"
      }
      latestAssignmentReport = {
        assignment = {
          configuration = {}
        }
        resources = [
          {
            reasons = [
              {
              }
            ]
          }
        ]
        vm = {}
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

Wartości właściwości

guestConfigurationAssignments

Nazwa Opis Wartość
typ Typ zasobu "Microsoft.GuestConfiguration/guestConfigurationAssignments@2022-01-25"
nazwa Nazwa zasobu ciąg (wymagany)
lokalizacja Region, w którym znajduje się maszyna wirtualna. struna
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

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

ConfigurationParameter

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

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

Informacje o przydziałach

Nazwa Opis Wartość
konfiguracja Informacje o konfiguracji. ConfigurationInfo

ConfigurationInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

AssignmentReportResource

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

AssignmentReportResourceComplianceReason

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

VMInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.

VmssvmInfo

Ten obiekt nie zawiera żadnych właściwości do ustawienia podczas wdrażania. Wszystkie właściwości to ReadOnly.