Sdílet prostřednictvím

Microsoft.GuestConfiguration guestConfigurationAssignments 2018-11-2018-11-2018

  • Článek

Definice prostředku Bicep

Typ prostředku guestConfigurationAssignments je prostředek rozšíření, což znamená, že ho můžete použít na jiný prostředek.

scope Pomocí vlastnosti tohoto prostředku nastavte obor tohoto prostředku. Viz Nastavení oboru pro prostředky rozšíření v Bicep.

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.GuestConfiguration/guestConfigurationAssignments, přidejte do šablony následující bicep.

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20' = {
  name: 'string'
  location: 'string'
  scope: resourceSymbolicName
  properties: {
    context: 'string'
    guestConfiguration: {
      assignmentType: 'string'
      configurationParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationProtectedParameter: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      configurationSetting: {
        actionAfterReboot: 'string'
        allowModuleOverwrite: bool
        configurationMode: 'string'
        configurationModeFrequencyMins: int
        rebootIfNeeded: bool
        refreshFrequencyMins: int
      }
      contentHash: 'string'
      contentUri: 'string'
      kind: 'DSC'
      name: 'string'
      version: 'string'
    }
    vmssVMList: [
      {
      }
    ]
  }
}

Hodnoty vlastností

guestConfigurationAssignments

Název Description Hodnota
name Název prostředku string (povinné)
location Oblast, ve které se virtuální počítač nachází. řetězec
scope Použijte při vytváření prostředku rozšíření v oboru, který se liší od oboru nasazení. Cílový prostředek

Pro Bicep nastavte tuto vlastnost na symbolický název prostředku, aby se použil prostředek rozšíření.
properties Vlastnosti přiřazení konfigurace hosta. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Název Description Hodnota
kontext Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy řetězec
konfigurace hosta Konfigurace hosta, která se má přiřadit. GuestConfigurationNavigation
seznam virtuálních počítačů vmssVMList Seznam dat o dodržování předpisů virtuálních počítačů pro škálovací sadu virtuálních počítačů VmssvmInfo[]

GuestConfigurationNavigation

Název Description Hodnota
typ přiřazení Určuje typ přiřazení a spuštění konfigurace. Možné hodnoty jsou Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect a ApplyAndMonitor. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'Audit'
'DeployAndAutoCorrect'
parametr konfigurace Parametry konfigurace hosta. ConfigurationParameter[]
configurationProtectedParameter Parametry chráněné konfigurace pro konfiguraci hosta. ConfigurationParameter[]
nastavení konfigurace Nastavení konfigurace pro konfiguraci hosta. Nastavení konfigurace
contentHash Kombinovaná hodnota hash konfiguračního balíčku hosta a konfiguračních parametrů řetězec
identifikátor URI obsahu Identifikátor URI úložiště, do kterého se nahraje konfigurační balíček hosta. řetězec
Druhu Druh konfigurace hosta. Příklad:DSC DSC
name Název konfigurace hosta. řetězec
verze Verze konfigurace hosta. řetězec

Parametr konfigurace

Název Description Hodnota
name Název parametru konfigurace. řetězec
hodnota Hodnota konfiguračního parametru řetězec

Nastavení konfigurace

Název Description Hodnota
actionAfterReboot Určuje, co se stane po restartování během použití konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration. Pokračovat v konfiguraci
'StopConfiguration'
allowModuleOverwrite Pokud je hodnota true, nové konfigurace stažené ze služby pull můžou přepsat staré konfigurace na cílovém uzlu. V opačném případě nepravda bool
configurationMode Určuje, jak LCM (místní Configuration Manager) skutečně použije konfiguraci na cílové uzly. Možné hodnoty jsou ApplyOnly, ApplyAndMonitor a ApplyAndAutoCorrect. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins Jak často se v minutách kontroluje a používá aktuální konfigurace. Tato vlastnost se ignoruje, pokud je vlastnost ConfigurationMode nastavena na ApplyOnly. Výchozí hodnota je 15. int
rebootIfNeed Tuto možnost nastavte na hodnotu true, aby se uzel po použití konfigurace, která vyžaduje restartování, automaticky restartuje. V opačném případě budete muset ručně restartovat uzel pro každou konfiguraci, která to vyžaduje. Výchozí hodnota je False. Pokud chcete toto nastavení použít, když je podmínka restartování provedena něčím jiným než DSC (například Instalační služba systému Windows), zkombinujte toto nastavení s modulem xPendingReboot. bool
refreshFrequencyMins Časový interval v minutách, ve kterém LCM kontroluje službu vyžádání, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud LCM není nakonfigurovaný v režimu vyžádání. Výchozí hodnota je 30. int

VmssvmInfo

Tento objekt neobsahuje žádné vlastnosti, které by se nastavily během nasazování. Všechny vlastnosti jsou Jen pro čtení.

Šablony pro rychlý start

Následující šablony rychlého startu nasadí tento typ prostředku.

Template (Šablona) Description
Virtuální počítač s Windows se standardními hodnotami zabezpečení Azure

Nasazení do Azure		 Šablona vytvoří virtuální počítač s Windows Serverem v nové virtuální síti s veřejnou IP adresou. Po nasazení počítače se nainstaluje rozšíření konfigurace hosta a použije se standardní hodnoty zabezpečení Azure pro Windows Server. Pokud se konfigurace počítačů posune, můžete nastavení znovu použít opětovným nasazením šablony.

Definice prostředku šablony ARM

Typ prostředku guestConfigurationAssignments je prostředek rozšíření, což znamená, že ho můžete použít na jiný prostředek.

scope Pomocí vlastnosti tohoto prostředku nastavte obor tohoto prostředku. Viz Nastavení oboru u prostředků rozšíření v šablonách ARM.

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.GuestConfiguration/guestConfigurationAssignments, přidejte do šablony následující kód JSON.

{
  "type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
  "apiVersion": "2018-11-20",
  "name": "string",
  "location": "string",
  "scope": "string",
  "properties": {
    "context": "string",
    "guestConfiguration": {
      "assignmentType": "string",
      "configurationParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationProtectedParameter": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "configurationSetting": {
        "actionAfterReboot": "string",
        "allowModuleOverwrite": "bool",
        "configurationMode": "string",
        "configurationModeFrequencyMins": "int",
        "rebootIfNeeded": "bool",
        "refreshFrequencyMins": "int"
      },
      "contentHash": "string",
      "contentUri": "string",
      "kind": "DSC",
      "name": "string",
      "version": "string"
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

Hodnoty vlastností

guestConfigurationAssignments

Název Description Hodnota
typ Typ prostředku Microsoft.GuestConfiguration/guestConfigurationAssignments
apiVersion Verze rozhraní API prostředků '2018-11-20'
name Název prostředku string (povinné)
location Oblast, ve které se virtuální počítač nachází. řetězec
scope Použijte při vytváření prostředku rozšíření v oboru, který se liší od oboru nasazení. Cílový prostředek

Pro JSON nastavte hodnotu na úplný název prostředku, na který chcete prostředek rozšíření použít.
properties Vlastnosti přiřazení konfigurace hosta. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Název Description Hodnota
kontext Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy řetězec
hostConfiguration Konfigurace hosta, která se má přiřadit. HostaConfigurationNavigation
vmssVMList Seznam dat o dodržování předpisů virtuálních počítačů pro VMSS VmssvmInfo[]

HostaConfigurationNavigation

Název Description Hodnota
assignmentType Určuje typ přiřazení a provedení konfigurace. Možné hodnoty jsou Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect a ApplyAndMonitor. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
Audit
'DeployAndAutoCorrect'
configurationParameter Parametry konfigurace hosta. ConfigurationParameter[]
configurationProtectedParameter Parametry chráněné konfigurace pro konfiguraci hosta. ConfigurationParameter[]
nastavení konfigurace Nastavení konfigurace pro konfiguraci hosta. Nastavení konfigurace
contentHash Kombinovaná hodnota hash konfiguračního balíčku hosta a konfiguračních parametrů řetězec
identifikátor URI obsahu Identifikátor URI úložiště, do kterého se nahraje konfigurační balíček hosta. řetězec
Druhu Druh konfigurace hosta. Příklad:DSC DSC
name Název konfigurace hosta. řetězec
verze Verze konfigurace hosta. řetězec

Parametr konfigurace

Název Description Hodnota
name Název parametru konfigurace. řetězec
hodnota Hodnota konfiguračního parametru řetězec

Nastavení konfigurace

Název Description Hodnota
actionAfterReboot Určuje, co se stane po restartování během použití konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration. 'ContinueConfiguration'
'StopConfiguration'
allowModuleOverwrite Pokud je true , nové konfigurace stažené ze služby vyžádané replikace můžou přepsat staré konfigurace na cílovém uzlu. V opačném případě false bool
configurationMode Určuje, jak LCM (místní Configuration Manager) skutečně použije konfiguraci na cílové uzly. Možné hodnoty jsou ApplyOnly, ApplyAndMonitor a ApplyAndAutoCorrect. 'ApplyAndAutoCorrect'
'ApplyAndMonitor'
'ApplyOnly'
configurationModeFrequencyMins Jak často se v minutách kontroluje a používá aktuální konfigurace. Tato vlastnost je ignorována, pokud ConfigurationMode vlastnost je nastavena na ApplyOnly. Výchozí hodnota je 15. int
rebootIfNeeded Nastavte tuto hodnotu na true, pokud chcete uzel automaticky restartovat po použití konfigurace, která vyžaduje restartování. V opačném případě budete muset uzel restartovat ručně u jakékoli konfigurace, která to vyžaduje. Výchozí hodnota je False. Chcete-li toto nastavení použít, když je podmínka restartování přijata něčím jiným než DSC (například Instalační službou systému Windows), zkombinujte toto nastavení s modulem xPendingReboot. bool
refreshFrequencyMins Časový interval v minutách, ve kterém LCM kontroluje službu vyžádané replikace, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud LCM není nakonfigurovaný v režimu vyžádání. Výchozí hodnota je 30. int

VmssvmInfo

Tento objekt neobsahuje žádné vlastnosti, které by se nastavily během nasazování. Všechny vlastnosti jsou jen pro čtení.

Šablony pro rychlý start

Následující šablony pro rychlý start nasadí tento typ prostředku.

Template (Šablona) Description
Virtuální počítač s Windows se zabezpečenými standardními hodnotami Azure

Nasazení do Azure		 Šablona vytvoří virtuální počítač s Windows Serverem v nové virtuální síti s veřejnou IP adresou. Po nasazení počítače se nainstaluje rozšíření konfigurace hosta a použije se standardní hodnoty zabezpečení Azure pro Windows Server. Pokud se konfigurace počítačů posune, můžete nastavení znovu použít tak, že šablonu nasadíte znovu.

Definice prostředku Terraform (poskytovatel AzAPI)

Typ prostředku guestConfigurationAssignments je prostředek rozšíření, což znamená, že ho můžete použít na jiný prostředek.

parent_id Pomocí vlastnosti tohoto prostředku nastavte obor tohoto prostředku.

Seznam změněných vlastností v jednotlivých verzích rozhraní API najdete v protokolu změn.

Formát prostředku

Pokud chcete vytvořit prostředek Microsoft.GuestConfiguration/guestConfigurationAssignments, přidejte do šablony následující Terraform.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20"
  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"
          }
        ]
        configurationSetting = {
          actionAfterReboot = "string"
          allowModuleOverwrite = bool
          configurationMode = "string"
          configurationModeFrequencyMins = int
          rebootIfNeeded = bool
          refreshFrequencyMins = int
        }
        contentHash = "string"
        contentUri = "string"
        kind = "DSC"
        name = "string"
        version = "string"
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

Hodnoty vlastností

guestConfigurationAssignments

Název Description Hodnota
typ Typ prostředku "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-11-20"
name Název prostředku string (povinné)
location Oblast, ve které se virtuální počítač nachází. řetězec
parent_id ID prostředku, na který se má tento prostředek rozšíření použít. string (povinné)
properties Vlastnosti přiřazení konfigurace hosta. GuestConfigurationAssignmentProperties

GuestConfigurationAssignmentProperties

Název Description Hodnota
kontext Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy řetězec
hostConfiguration Konfigurace hosta, která se má přiřadit. HostaConfigurationNavigation
vmssVMList Seznam dat o dodržování předpisů virtuálních počítačů pro VMSS VmssvmInfo[]

HostaConfigurationNavigation

Název Description Hodnota
assignmentType Určuje typ přiřazení a provedení konfigurace. Možné hodnoty jsou Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect a ApplyAndMonitor. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"Audit"
"DeployAndAutoCorrect"
configurationParameter Parametry konfigurace hosta. ConfigurationParameter[]
configurationProtectedParameter Parametry chráněné konfigurace pro konfiguraci hosta. ConfigurationParameter[]
nastavení konfigurace Nastavení konfigurace pro konfiguraci hosta. Nastavení konfigurace
contentHash Kombinovaná hodnota hash konfiguračního balíčku hosta a konfiguračních parametrů. řetězec
contentUri Identifikátor URI úložiště, do kterého se nahraje konfigurační balíček hosta. řetězec
Druhu Druh konfigurace hosta. Příklad:DSC "DSC"
name Název konfigurace hosta. řetězec
verze Verze konfigurace hosta. řetězec

ConfigurationParameter

Název Description Hodnota
name Název konfiguračního parametru. řetězec
hodnota Hodnota konfiguračního parametru. řetězec

Nastavení konfigurace

Název Description Hodnota
actionAfterReboot Určuje, co se stane po restartování během použití konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration. "ContinueConfiguration"
"StopConfiguration"
allowModuleOverwrite Pokud je hodnota true, nové konfigurace stažené ze služby pull můžou přepsat staré konfigurace na cílovém uzlu. V opačném případě nepravda bool
configurationMode Určuje, jak LCM (místní Configuration Manager) skutečně použije konfiguraci na cílové uzly. Možné hodnoty jsou ApplyOnly, ApplyAndMonitor a ApplyAndAutoCorrect. "ApplyAndAutoCorrect"
"ApplyAndMonitor"
"ApplyOnly"
configurationModeFrequencyMins Jak často se v minutách kontroluje a používá aktuální konfigurace. Tato vlastnost se ignoruje, pokud je vlastnost ConfigurationMode nastavena na ApplyOnly. Výchozí hodnota je 15. int
rebootIfNeed Tuto možnost nastavte na hodnotu true, aby se uzel po použití konfigurace, která vyžaduje restartování, automaticky restartuje. V opačném případě budete muset ručně restartovat uzel pro každou konfiguraci, která to vyžaduje. Výchozí hodnota je False. Pokud chcete toto nastavení použít, když je podmínka restartování provedena něčím jiným než DSC (například Instalační služba systému Windows), zkombinujte toto nastavení s modulem xPendingReboot. bool
refreshFrequencyMins Časový interval v minutách, ve kterém LCM kontroluje službu vyžádání, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud LCM není nakonfigurovaný v režimu vyžádání. Výchozí hodnota je 30. int

VmssvmInfo

Tento objekt neobsahuje žádné vlastnosti, které by se nastavily během nasazování. Všechny vlastnosti jsou jen pro čtení.