Microsoft.GuestConfiguration guestConfigurationAssignments 2020-06-25

Článek
12/21/2024

Definice prostředku Bicep

Typ prostředku guestConfigurationAssignments je možné nasadit s operacemi, které cílí:

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@2020-06-25' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: '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: 'string'
      name: 'string'
      version: 'string'
    }
    latestAssignmentReport: {
      assignment: {
        configuration: {}
      }
      resources: [
        {
          reasons: [
            {}
          ]
        }
      ]
      vm: {}
    }
    vmssVMList: [
      {}
    ]
  }
}

Hodnoty vlastností

AssignmentInfo

Jméno	Popis	Hodnota
konfigurace	Informace o konfiguraci	ConfigurationInfo

AssignmentReport

Jméno	Popis	Hodnota
přiřazení	Podrobnosti o konfiguraci hosta	AssignmentInfo
prostředky	Seznam prostředků, pro které je zaškrtnuto dodržování předpisů pro přiřazení konfigurace hosta.	AssignmentReportResource[]
Vm	Informace o virtuálním počítači	VMInfo

AssignmentReportResource

Jméno	Popis	Hodnota
důvody	Důvod dodržování předpisů a kód důvodu prostředku	AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Jméno	Popis	Hodnota

Informace o konfiguraci

Jméno	Popis	Hodnota

ConfigurationParameter

Jméno	Popis	Hodnota
Jméno	Název parametru konfigurace.	řetězec
hodnota	Hodnota parametru konfigurace.	řetězec

ConfigurationSetting

Jméno	Popis	Hodnota
actionAfterReboot	Určuje, co se stane po restartování během aplikace konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration.	ContinueConfiguration StopConfiguration
allowModuleOverwrite	Pokud je hodnota 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ě nepravda	Bool
configurationMode	Určuje, jak LCM(Local 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
rebootIfNeeded	Nastavte tuto hodnotu na hodnotu True, aby se uzel po použití konfigurace, která vyžaduje restartování, automaticky restartuje. Jinak budete muset ručně restartovat uzel pro všechny konfigurace, které ho vyžadují. Výchozí hodnota je false. Chcete-li toto nastavení použít, pokud je podmínka restartování přijata 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žádané replikace, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud není LCM nakonfigurovaný v režimu vyžádání obsahu. Výchozí hodnota je 30.	Int

GuestConfigurationAssignmentProperties

Jméno	Popis	Hodnota
kontext	Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy	řetězec
guestConfiguration	Konfigurace hosta, která se má přiřadit.	GuestConfigurationNavigation
latestAssignmentReport	Poslední nahlášená sestava přiřazení konfigurace hosta	AssignmentReport
vmssVMList	Seznam dat dodržování předpisů virtuálních počítačů pro VMSS	VmssvmInfo[]

GuestConfigurationNavigation

Jméno	Popis	Hodnota
assignmentType	Určuje typ přiřazení a spuštění konfigurace. Možné hodnoty jsou Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect a ApplyAndMonitor.	ApplyAndAutoCorrect ApplyAndMonitor Audit DeployAndAutoCorrect
configurationParameter	Parametry konfigurace pro konfiguraci hosta.	ConfigurationParameter[]
configurationProtectedParameter	Parametry chráněné konfigurace pro konfiguraci hosta.	ConfigurationParameter[]
configurationSetting	Nastavení konfigurace pro konfiguraci hosta.	ConfigurationSetting
contentHash	Kombinovaná hodnota hash konfiguračního balíčku hosta a parametrů konfigurace	řetězec
contentUri	Identifikátor URI úložiště, kde se nahraje konfigurační balíček hosta.	řetězec
laskavý	Druh konfigurace hosta. Příklad:DSC	DSC
Jméno	Název konfigurace hosta	řetězec
verze	Verze konfigurace hosta	řetězec

Microsoft.GuestConfiguration/guestConfigurationAssignments

Jméno	Popis	Hodnota
umístění	Oblast, kde se nachází virtuální počítač	řetězec
Jméno	Název prostředku	string (povinné)
vlastnosti	Vlastnosti přiřazení konfigurace hosta	GuestConfigurationAssignmentProperties
rozsah	Slouží k vytvoření prostředku v oboru, který se liší od oboru nasazení.	Nastavte tuto vlastnost na symbolický název prostředku, který použijeprostředku rozšíření .

VMInfo

Jméno	Popis	Hodnota

VmssvmInfo

Jméno	Popis	Hodnota

Ukázky rychlého startu

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

Soubor Bicep	Popis
virtuální počítače služby IIS & virtuálního počítače s SQL Serverem 2014	Ve virtuální síti vytvořte webové servery se systémem Windows 2012 R2 1 nebo 2 IIS a jeden back-end SQL Server 2014.
virtuální počítač s Windows se zabezpečenými standardními hodnotami Azure	Šablona vytvoří virtuální počítač se systémem Windows Server 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 možné nasadit s operacemi, které cílí:

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": "2020-06-25",
  "name": "string",
  "location": "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": "string",
      "name": "string",
      "version": "string"
    },
    "latestAssignmentReport": {
      "assignment": {
        "configuration": {
        }
      },
      "resources": [
        {
          "reasons": [
            {
            }
          ]
        }
      ],
      "vm": {
      }
    },
    "vmssVMList": [
      {
      }
    ]
  }
}

Hodnoty vlastností

AssignmentInfo

Jméno	Popis	Hodnota
konfigurace	Informace o konfiguraci	ConfigurationInfo

AssignmentReport

Jméno	Popis	Hodnota
přiřazení	Podrobnosti o konfiguraci hosta	AssignmentInfo
prostředky	Seznam prostředků, pro které je zaškrtnuto dodržování předpisů pro přiřazení konfigurace hosta.	AssignmentReportResource[]
Vm	Informace o virtuálním počítači	VMInfo

AssignmentReportResource

Jméno	Popis	Hodnota
důvody	Důvod dodržování předpisů a kód důvodu prostředku	AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Jméno	Popis	Hodnota

Informace o konfiguraci

Jméno	Popis	Hodnota

ConfigurationParameter

Jméno	Popis	Hodnota
Jméno	Název parametru konfigurace.	řetězec
hodnota	Hodnota parametru konfigurace.	řetězec

ConfigurationSetting

Jméno	Popis	Hodnota
actionAfterReboot	Určuje, co se stane po restartování během aplikace konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration.	ContinueConfiguration StopConfiguration
allowModuleOverwrite	Pokud je hodnota 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ě nepravda	Bool
configurationMode	Určuje, jak LCM(Local 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
rebootIfNeeded	Nastavte tuto hodnotu na hodnotu True, aby se uzel po použití konfigurace, která vyžaduje restartování, automaticky restartuje. Jinak budete muset ručně restartovat uzel pro všechny konfigurace, které ho vyžadují. Výchozí hodnota je false. Chcete-li toto nastavení použít, pokud je podmínka restartování přijata 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žádané replikace, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud není LCM nakonfigurovaný v režimu vyžádání obsahu. Výchozí hodnota je 30.	Int

GuestConfigurationAssignmentProperties

Jméno	Popis	Hodnota
kontext	Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy	řetězec
guestConfiguration	Konfigurace hosta, která se má přiřadit.	GuestConfigurationNavigation
latestAssignmentReport	Poslední nahlášená sestava přiřazení konfigurace hosta	AssignmentReport
vmssVMList	Seznam dat dodržování předpisů virtuálních počítačů pro VMSS	VmssvmInfo[]

GuestConfigurationNavigation

Jméno	Popis	Hodnota
assignmentType	Určuje typ přiřazení a spuštění konfigurace. Možné hodnoty jsou Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect a ApplyAndMonitor.	ApplyAndAutoCorrect ApplyAndMonitor Audit DeployAndAutoCorrect
configurationParameter	Parametry konfigurace pro konfiguraci hosta.	ConfigurationParameter[]
configurationProtectedParameter	Parametry chráněné konfigurace pro konfiguraci hosta.	ConfigurationParameter[]
configurationSetting	Nastavení konfigurace pro konfiguraci hosta.	ConfigurationSetting
contentHash	Kombinovaná hodnota hash konfiguračního balíčku hosta a parametrů konfigurace	řetězec
contentUri	Identifikátor URI úložiště, kde se nahraje konfigurační balíček hosta.	řetězec
laskavý	Druh konfigurace hosta. Příklad:DSC	DSC
Jméno	Název konfigurace hosta	řetězec
verze	Verze konfigurace hosta	řetězec

Microsoft.GuestConfiguration/guestConfigurationAssignments

Jméno	Popis	Hodnota
apiVersion	Verze rozhraní API	'2020-06-25'
umístění	Oblast, kde se nachází virtuální počítač	řetězec
Jméno	Název prostředku	string (povinné)
vlastnosti	Vlastnosti přiřazení konfigurace hosta	GuestConfigurationAssignmentProperties
typ	Typ prostředku	Microsoft.GuestConfiguration/guestConfigurationAssignments

VMInfo

Jméno	Popis	Hodnota

VmssvmInfo

Jméno	Popis	Hodnota

Šablony pro rychlý start

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

Šablona	Popis
virtuální počítače služby IIS & virtuálního počítače s SQL Serverem 2014 nasazení	Ve virtuální síti vytvořte webové servery se systémem Windows 2012 R2 1 nebo 2 IIS a jeden back-end SQL Server 2014.
virtuální počítač s Windows se zabezpečenými standardními hodnotami Azure nasazení	Šablona vytvoří virtuální počítač se systémem Windows Server 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 Terraformu (poskytovatel AzAPI)

Typ prostředku guestConfigurationAssignments je možné nasadit s operacemi, které cílí:

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@2020-06-25"
  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"
          }
        ]
        configurationSetting = {
          actionAfterReboot = "string"
          allowModuleOverwrite = bool
          configurationMode = "string"
          configurationModeFrequencyMins = int
          rebootIfNeeded = bool
          refreshFrequencyMins = int
        }
        contentHash = "string"
        contentUri = "string"
        kind = "string"
        name = "string"
        version = "string"
      }
      latestAssignmentReport = {
        assignment = {
          configuration = {
          }
        }
        resources = [
          {
            reasons = [
              {
              }
            ]
          }
        ]
        vm = {
        }
      }
      vmssVMList = [
        {
        }
      ]
    }
  })
}

Hodnoty vlastností

AssignmentInfo

Jméno	Popis	Hodnota
konfigurace	Informace o konfiguraci	ConfigurationInfo

AssignmentReport

Jméno	Popis	Hodnota
přiřazení	Podrobnosti o konfiguraci hosta	AssignmentInfo
prostředky	Seznam prostředků, pro které je zaškrtnuto dodržování předpisů pro přiřazení konfigurace hosta.	AssignmentReportResource[]
Vm	Informace o virtuálním počítači	VMInfo

AssignmentReportResource

Jméno	Popis	Hodnota
důvody	Důvod dodržování předpisů a kód důvodu prostředku	AssignmentReportResourceComplianceReason[]

AssignmentReportResourceComplianceReason

Jméno	Popis	Hodnota

Informace o konfiguraci

Jméno	Popis	Hodnota

ConfigurationParameter

Jméno	Popis	Hodnota
Jméno	Název parametru konfigurace.	řetězec
hodnota	Hodnota parametru konfigurace.	řetězec

ConfigurationSetting

Jméno	Popis	Hodnota
actionAfterReboot	Určuje, co se stane po restartování během aplikace konfigurace. Možné hodnoty jsou ContinueConfiguration a StopConfiguration.	ContinueConfiguration StopConfiguration
allowModuleOverwrite	Pokud je hodnota 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ě nepravda	Bool
configurationMode	Určuje, jak LCM(Local 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
rebootIfNeeded	Nastavte tuto hodnotu na hodnotu True, aby se uzel po použití konfigurace, která vyžaduje restartování, automaticky restartuje. Jinak budete muset ručně restartovat uzel pro všechny konfigurace, které ho vyžadují. Výchozí hodnota je false. Chcete-li toto nastavení použít, pokud je podmínka restartování přijata 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žádané replikace, aby získala aktualizované konfigurace. Tato hodnota se ignoruje, pokud není LCM nakonfigurovaný v režimu vyžádání obsahu. Výchozí hodnota je 30.	Int

GuestConfigurationAssignmentProperties

Jméno	Popis	Hodnota
kontext	Zdroj, který inicioval přiřazení konfigurace hosta. Příklad: Azure Policy	řetězec
guestConfiguration	Konfigurace hosta, která se má přiřadit.	GuestConfigurationNavigation
latestAssignmentReport	Poslední nahlášená sestava přiřazení konfigurace hosta	AssignmentReport
vmssVMList	Seznam dat dodržování předpisů virtuálních počítačů pro VMSS	VmssvmInfo[]

GuestConfigurationNavigation

Jméno	Popis	Hodnota
assignmentType	Určuje typ přiřazení a spuštění konfigurace. Možné hodnoty jsou Audit, DeployAndAutoCorrect, ApplyAndAutoCorrect a ApplyAndMonitor.	ApplyAndAutoCorrect ApplyAndMonitor Audit DeployAndAutoCorrect
configurationParameter	Parametry konfigurace pro konfiguraci hosta.	ConfigurationParameter[]
configurationProtectedParameter	Parametry chráněné konfigurace pro konfiguraci hosta.	ConfigurationParameter[]
configurationSetting	Nastavení konfigurace pro konfiguraci hosta.	ConfigurationSetting
contentHash	Kombinovaná hodnota hash konfiguračního balíčku hosta a parametrů konfigurace	řetězec
contentUri	Identifikátor URI úložiště, kde se nahraje konfigurační balíček hosta.	řetězec
laskavý	Druh konfigurace hosta. Příklad:DSC	DSC
Jméno	Název konfigurace hosta	řetězec
verze	Verze konfigurace hosta	řetězec

Microsoft.GuestConfiguration/guestConfigurationAssignments

Jméno	Popis	Hodnota
umístění	Oblast, kde se nachází virtuální počítač	řetězec
Jméno	Název prostředku	string (povinné)
parent_id	ID prostředku, na který se má tento prostředek rozšíření použít.	string (povinné)
vlastnosti	Vlastnosti přiřazení konfigurace hosta	GuestConfigurationAssignmentProperties
typ	Typ prostředku	Microsoft.GuestConfiguration/guestConfigurationAssignments@2020-06-25

VMInfo

Jméno	Popis	Hodnota

VmssvmInfo

Jméno	Popis	Hodnota

Sdílet prostřednictvím

Microsoft.GuestConfiguration guestConfigurationAssignments 2020-06-25

Definice prostředku Bicep

Formát prostředku

Hodnoty vlastností

AssignmentInfo

AssignmentReport

AssignmentReportResource

AssignmentReportResourceComplianceReason

Informace o konfiguraci

ConfigurationParameter

ConfigurationSetting

GuestConfigurationAssignmentProperties

GuestConfigurationNavigation

Microsoft.GuestConfiguration/guestConfigurationAssignments

VMInfo

VmssvmInfo

Ukázky rychlého startu

Definice prostředku šablony ARM

Formát prostředku

Hodnoty vlastností

AssignmentInfo

AssignmentReport

AssignmentReportResource

AssignmentReportResourceComplianceReason

Informace o konfiguraci

ConfigurationParameter

ConfigurationSetting

GuestConfigurationAssignmentProperties

GuestConfigurationNavigation

Microsoft.GuestConfiguration/guestConfigurationAssignments

VMInfo

VmssvmInfo

Šablony pro rychlý start

Definice prostředku Terraformu (poskytovatel AzAPI)

Formát prostředku

Hodnoty vlastností

AssignmentInfo

AssignmentReport

AssignmentReportResource

AssignmentReportResourceComplianceReason

Informace o konfiguraci

ConfigurationParameter

ConfigurationSetting

GuestConfigurationAssignmentProperties

GuestConfigurationNavigation

Microsoft.GuestConfiguration/guestConfigurationAssignments

VMInfo

VmssvmInfo

Váš názor

Další materiály