Microsoft.GuestConfiguration guestConfigurationAssignments 2018-06-30-preview

• Últimas
• 2024-04-05
• 2022-01-25
• 2021-01-25
• 2020-06-25
• 2018-11-20
• 2018-06-30-visualização
• 2018-01-20-pré-visualização

Definição de recursos do bíceps

O tipo de recurso guestConfigurationAssignments pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, adicione o seguinte Bíceps ao seu modelo.

resource symbolicname 'Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview' = {
  scope: resourceSymbolicName or scope
  location: 'string'
  name: 'string'
  properties: {
    context: 'string'
    guestConfiguration: {
      configurationParameter: [
        {}
      ]
      configurationSetting: {
        actionAfterReboot: 'string'
        allowModuleOverwrite: bool
        configurationMode: 'string'
        configurationModeFrequencyMins: int
        rebootIfNeeded: bool
        refreshFrequencyMins: int
      }
      kind: 'string'
      name: 'string'
      version: 'string'
    }
  }
}

Valores de propriedade

Microsoft.GuestConfiguration/guestConfigurationAssignments

Designação	Descrição	Valor
Localização	Região onde a VM está localizada.	corda
Designação	O nome do recurso	string (obrigatório)
propriedades	Propriedades da atribuição de configuração de convidado.	GuestConfigurationAssignmentProperties
Âmbito de aplicação	Use ao criar um recurso em um escopo diferente do escopo de implantação.	Defina essa propriedade como o nome simbólico de um recurso para aplicar o recurso de extensão .

ConfigurationParameter

Designação	Descrição	Valor

ConfiguraçãoDefinição

Designação	Descrição	Valor
actionAfterReboot	Especifica o que acontece após uma reinicialização durante a aplicação de uma configuração. Os valores possíveis são ContinueConfiguration e StopConfiguration	'ContinuarConfiguração' 'StopConfiguration'
allowModuleOverwrite	Se verdadeiro - novas configurações baixadas do serviço pull têm permissão para substituir as antigas no nó de destino. Caso contrário, falso	Bool
configurationMode	Especifica como o LCM (Local Configuration Manager) realmente aplica a configuração aos nós de destino. Os valores possíveis são ApplyOnly, ApplyAndMonitor e ApplyAndAutoCorrect.	'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'ApplyOnly'
configuraçãoModeFrequencyMins	Com que frequência, em minutos, a configuração atual é verificada e aplicada. Essa propriedade será ignorada se a propriedade ConfigurationMode estiver definida como ApplyOnly. O valor padrão é 15.	Int
rebootIfNeeded	Defina isso como true para reinicializar automaticamente o nó depois que uma configuração que requer reinicialização for aplicada. Caso contrário, você terá que reinicializar manualmente o nó para qualquer configuração que o exija. O valor padrão é false. Para usar essa configuração quando uma condição de reinicialização for decretada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot.	Bool
refreshFrequencyMins	O intervalo de tempo, em minutos, no qual o LCM verifica um serviço pull para obter configurações atualizadas. Esse valor será ignorado se o LCM não estiver configurado no modo de receção. O valor padrão é 30.	Int

GuestConfigurationAssignmentProperties

Designação	Descrição	Valor
Contexto	A origem que iniciou a atribuição de configuração de convidado. Ex: Política do Azure	corda
guestConfiguration	A configuração de convidado a ser atribuída.	GuestConfigurationNavigation

GuestConfigurationNavigation

Designação	Descrição	Valor
configurationParâmetro	Os parâmetros de configuração para a configuração do convidado.	ConfigurationParameter[]
configuraçãoDefinição	A definição de configuração para a configuração do convidado.	ConfiguraçãoDefinição
tipo	Tipo de configuração de convidado. Por exemplo:DSC	«DSC»
Designação	Nome da configuração do convidado.	corda
Versão	Versão da configuração do convidado.	corda

Exemplos de uso

Exemplos de início rápido do Azure

Os seguintes modelos início rápido do Azure contêm exemplos de Bicep para implantar esse tipo de recurso.

Arquivo Bicep	Descrição
VMs do IIS & de VM do SQL Server 2014	Crie 1 ou 2 servidores Web IIS Windows 2012 R2 e um SQL Server 2014 back-end na VNET.
VM do Windows com de linha de base segura do Azure	O modelo cria uma máquina virtual executando o Windows Server em uma nova rede virtual, com um endereço IP público. Depois que a máquina for implantada, a extensão de configuração de convidado será instalada e a linha de base segura do Azure para Windows Server será aplicada. Se a configuração das máquinas se desviar, você poderá reaplicar as configurações implantando o modelo novamente.

Definição de recurso de modelo ARM

O tipo de recurso guestConfigurationAssignments pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, adicione o seguinte JSON ao seu modelo.

{
  "type": "Microsoft.GuestConfiguration/guestConfigurationAssignments",
  "apiVersion": "2018-06-30-preview",
  "name": "string",
  "location": "string",
  "properties": {
    "context": "string",
    "guestConfiguration": {
      "configurationParameter": [
        {
        }
      ],
      "configurationSetting": {
        "actionAfterReboot": "string",
        "allowModuleOverwrite": "bool",
        "configurationMode": "string",
        "configurationModeFrequencyMins": "int",
        "rebootIfNeeded": "bool",
        "refreshFrequencyMins": "int"
      },
      "kind": "string",
      "name": "string",
      "version": "string"
    }
  }
}

Valores de propriedade

Microsoft.GuestConfiguration/guestConfigurationAssignments

Designação	Descrição	Valor
Versão da API	A versão api	'2018-06-30-pré-visualização'
Localização	Região onde a VM está localizada.	corda
Designação	O nome do recurso	string (obrigatório)
propriedades	Propriedades da atribuição de configuração de convidado.	GuestConfigurationAssignmentProperties
tipo	O tipo de recurso	'Microsoft.GuestConfiguration/guestConfigurationAssignments'

ConfigurationParameter

Designação	Descrição	Valor

ConfiguraçãoDefinição

Designação	Descrição	Valor
actionAfterReboot	Especifica o que acontece após uma reinicialização durante a aplicação de uma configuração. Os valores possíveis são ContinueConfiguration e StopConfiguration	'ContinuarConfiguração' 'StopConfiguration'
allowModuleOverwrite	Se verdadeiro - novas configurações baixadas do serviço pull têm permissão para substituir as antigas no nó de destino. Caso contrário, falso	Bool
configurationMode	Especifica como o LCM (Local Configuration Manager) realmente aplica a configuração aos nós de destino. Os valores possíveis são ApplyOnly, ApplyAndMonitor e ApplyAndAutoCorrect.	'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'ApplyOnly'
configuraçãoModeFrequencyMins	Com que frequência, em minutos, a configuração atual é verificada e aplicada. Essa propriedade será ignorada se a propriedade ConfigurationMode estiver definida como ApplyOnly. O valor padrão é 15.	Int
rebootIfNeeded	Defina isso como true para reinicializar automaticamente o nó depois que uma configuração que requer reinicialização for aplicada. Caso contrário, você terá que reinicializar manualmente o nó para qualquer configuração que o exija. O valor padrão é false. Para usar essa configuração quando uma condição de reinicialização for decretada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot.	Bool
refreshFrequencyMins	O intervalo de tempo, em minutos, no qual o LCM verifica um serviço pull para obter configurações atualizadas. Esse valor será ignorado se o LCM não estiver configurado no modo de receção. O valor padrão é 30.	Int

GuestConfigurationAssignmentProperties

Designação	Descrição	Valor
Contexto	A origem que iniciou a atribuição de configuração de convidado. Ex: Política do Azure	corda
guestConfiguration	A configuração de convidado a ser atribuída.	GuestConfigurationNavigation

GuestConfigurationNavigation

Designação	Descrição	Valor
configurationParâmetro	Os parâmetros de configuração para a configuração do convidado.	ConfigurationParameter[]
configuraçãoDefinição	A definição de configuração para a configuração do convidado.	ConfiguraçãoDefinição
tipo	Tipo de configuração de convidado. Por exemplo:DSC	«DSC»
Designação	Nome da configuração do convidado.	corda
Versão	Versão da configuração do convidado.	corda

Exemplos de uso

Modelos de início rápido do Azure

Os seguintes modelos de início rápido do Azure implantar esse tipo de recurso.

Modelo	Descrição
VMs do IIS & de VM do SQL Server 2014	Crie 1 ou 2 servidores Web IIS Windows 2012 R2 e um SQL Server 2014 back-end na VNET.
VM do Windows com de linha de base segura do Azure	O modelo cria uma máquina virtual executando o Windows Server em uma nova rede virtual, com um endereço IP público. Depois que a máquina for implantada, a extensão de configuração de convidado será instalada e a linha de base segura do Azure para Windows Server será aplicada. Se a configuração das máquinas se desviar, você poderá reaplicar as configurações implantando o modelo novamente.

Definição de recursos Terraform (provedor AzAPI)

O tipo de recurso guestConfigurationAssignments pode ser implantado com operações que visam:

Para obter uma lista de propriedades alteradas em cada versão da API, consulte log de alterações.

Formato do recurso

Para criar um recurso Microsoft.GuestConfiguration/guestConfigurationAssignments, adicione o seguinte Terraform ao seu modelo.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-preview"
  name = "string"
  parent_id = "string"
  location = "string"
  body = {
    properties = {
      context = "string"
      guestConfiguration = {
        configurationParameter = [
          {
          }
        ]
        configurationSetting = {
          actionAfterReboot = "string"
          allowModuleOverwrite = bool
          configurationMode = "string"
          configurationModeFrequencyMins = int
          rebootIfNeeded = bool
          refreshFrequencyMins = int
        }
        kind = "string"
        name = "string"
        version = "string"
      }
    }
  }
}

Valores de propriedade

Microsoft.GuestConfiguration/guestConfigurationAssignments

Designação	Descrição	Valor
Localização	Região onde a VM está localizada.	corda
Designação	O nome do recurso	string (obrigatório)
parent_id	A ID do recurso ao qual aplicar esse recurso de extensão.	string (obrigatório)
propriedades	Propriedades da atribuição de configuração de convidado.	GuestConfigurationAssignmentProperties
tipo	O tipo de recurso	"Microsoft.GuestConfiguration/guestConfigurationAssignments@2018-06-30-pré-visualização"

ConfigurationParameter

Designação	Descrição	Valor

ConfiguraçãoDefinição

Designação	Descrição	Valor
actionAfterReboot	Especifica o que acontece após uma reinicialização durante a aplicação de uma configuração. Os valores possíveis são ContinueConfiguration e StopConfiguration	'ContinuarConfiguração' 'StopConfiguration'
allowModuleOverwrite	Se verdadeiro - novas configurações baixadas do serviço pull têm permissão para substituir as antigas no nó de destino. Caso contrário, falso	Bool
configurationMode	Especifica como o LCM (Local Configuration Manager) realmente aplica a configuração aos nós de destino. Os valores possíveis são ApplyOnly, ApplyAndMonitor e ApplyAndAutoCorrect.	'ApplyAndAutoCorrect' 'ApplyAndMonitor' 'ApplyOnly'
configuraçãoModeFrequencyMins	Com que frequência, em minutos, a configuração atual é verificada e aplicada. Essa propriedade será ignorada se a propriedade ConfigurationMode estiver definida como ApplyOnly. O valor padrão é 15.	Int
rebootIfNeeded	Defina isso como true para reinicializar automaticamente o nó depois que uma configuração que requer reinicialização for aplicada. Caso contrário, você terá que reinicializar manualmente o nó para qualquer configuração que o exija. O valor padrão é false. Para usar essa configuração quando uma condição de reinicialização for decretada por algo diferente do DSC (como o Windows Installer), combine essa configuração com o módulo xPendingReboot.	Bool
refreshFrequencyMins	O intervalo de tempo, em minutos, no qual o LCM verifica um serviço pull para obter configurações atualizadas. Esse valor será ignorado se o LCM não estiver configurado no modo de receção. O valor padrão é 30.	Int

GuestConfigurationAssignmentProperties

Designação	Descrição	Valor
Contexto	A origem que iniciou a atribuição de configuração de convidado. Ex: Política do Azure	corda
guestConfiguration	A configuração de convidado a ser atribuída.	GuestConfigurationNavigation

GuestConfigurationNavigation

Designação	Descrição	Valor
configurationParâmetro	Os parâmetros de configuração para a configuração do convidado.	ConfigurationParameter[]
configuraçãoDefinição	A definição de configuração para a configuração do convidado.	ConfiguraçãoDefinição
tipo	Tipo de configuração de convidado. Por exemplo:DSC	«DSC»
Designação	Nome da configuração do convidado.	corda
Versão	Versão da configuração do convidado.	corda