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.

Syntax

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ó DSC (Configuração de Estado Desejado) do APS 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 ARM em vez de cmdlets. Consulte a documentação de 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"

Este 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
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-AllowModuleOverwrite

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

Tipo:Boolean
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-AutomationAccountName

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

Tipo:String
Position:1
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMLocation

O local da VM do Azure.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMName

O nome da máquina virtual do Azure a ser registrada para gerenciamento com o Azure Automation DSC.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

-AzureVMResourceGroup

O nome do grupo de recursos da VM do Azure.

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationMode

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

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • ApplyOnly
Tipo:String
valores aceitos:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-ConfigurationModeFrequencyMins

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

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-DefaultProfile

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

Tipo:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:False
Accept wildcard characters:False

-NodeConfigurationName

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

Tipo:String
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-RebootNodeIfNeeded

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

Tipo:Boolean
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters:False

-RefreshFrequencyMins

Especifica a frequência, em minutos, na qual o Gerenciador de Configurações local entra em contato com o servidor de recebimento do DSC de Automação do Azure para baixar a configuração de nó mais recente.

Tipo:Int32
Position:Named
valor padrão:None
Obrigatório:False
Accept pipeline input:True
Accept wildcard characters: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
Position:0
valor padrão:None
Obrigatório:True
Accept pipeline input:True
Accept wildcard characters:False

Entradas

String

Int32

Boolean

Saídas

Void