Compartilhar via

Register-AzAutomationDscNode

  • Referência
Módulo:
Az.Automation

Registra uma máquina virtual do Azure que executa o sistema operacional Windows como um nó DSC para uma conta de Automação.

Sintaxe

Register-AzAutomationDscNode
        -AzureVMName <String>
        [-NodeConfigurationName <String>]
        [-ConfigurationMode <String>]
        [-ConfigurationModeFrequencyMins <Int32>]
        [-RefreshFrequencyMins <Int32>]
        [-RebootNodeIfNeeded <Boolean>]
        [-ActionAfterReboot <String>]
        [-AllowModuleOverwrite <Boolean>]
        [-AzureVMResourceGroup <String>]
        [-AzureVMLocation <String>]
        [-ResourceGroupName] <String>
        [-AutomationAccountName] <String>
        [-DefaultProfile <IAzureContextContainer>]
        [<CommonParameters>]

Description

O cmdlet Register-AzAutomationDscNode registra uma máquina virtual do Azure como um nó APS Desired State Configuration (DSC) em uma conta de Automação do Azure. Esse cmdlet registrará apenas VMs que executam o sistema operacional Windows como um nó DSC de automação para uma conta.

Se você precisar registrar um nó em uma conta de automação em uma assinatura diferente, precisará usar um modelo do ARM em vez de cmdlets. Consulte a documentação da Automação do Azure para obter mais detalhes.

Exemplos

Exemplo 1: Registrar uma máquina virtual do Azure como um nó DSC do Azure

Register-AzAutomationDscNode -AutomationAccountName "Contoso17" -AzureVMName "VirtualMachine01" -ResourceGroupName "ResourceGroup01"-NodeConfigurationName "ContosoConfiguration.webserver"

Esse comando registra a máquina virtual do Azure chamada VirtualMachine01 como um nó DSC na conta de Automação chamada Contoso17.

Parâmetros

-ActionAfterReboot

Especifica a ação que a máquina virtual executa após a reinicialização. Os valores válidos são:

  • ContinueConfiguration
  • StopConfiguration
Tipo:String
Valores aceitos:ContinueConfiguration, StopConfiguration
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AllowModuleOverwrite

Especifica se as novas configurações que esse nó DSC baixa do servidor de pull DSC de Automação do Azure substituem os módulos existentes já no nó de destino.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AutomationAccountName

Especifica o nome de uma conta de Automação na qual esse cmdlet registra uma máquina virtual.

Tipo:String
Cargo:1
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AzureVMLocation

O local da VM do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AzureVMName

O nome da máquina virtual do Azure para se registrar para gerenciamento com o DSC de Automação do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-AzureVMResourceGroup

O nome do grupo de recursos de VM do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConfigurationMode

Especifica o modo de configuração de DSC. Os valores válidos são:

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • ApplyOnly
Tipo:String
Valores aceitos:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ConfigurationModeFrequencyMins

Especifica a frequência, em minutos, na qual o aplicativo em segundo plano da DSC tenta implementar a configuração atual no nó de destino.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-NodeConfigurationName

Especifica o nome da configuração do nó que esse cmdlet configura a máquina virtual para efetuar pull do DSC de Automação do Azure.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RebootNodeIfNeeded

Especifica se a máquina virtual deve ser reiniciada, se necessário.

Tipo:Boolean
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-RefreshFrequencyMins

Especifica a frequência, em minutos, na qual o Configuration Manager local entra em contato com o servidor de pull do DSC de Automação do Azure para baixar a configuração de nó mais recente.

Tipo:Int32
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

-ResourceGroupName

Especifica o nome de um grupo de recursos. A conta de Automação com a qual esse cmdlet registra uma máquina virtual pertence ao grupo de recursos especificado por esse parâmetro.

Tipo:String
Cargo:0
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:True
Aceitar caracteres curinga:False

Entradas

String

Int32

Boolean

Saídas

Void