Partilhar via

Register-AzAutomationDscNode

  • Referência
Módulo:
Az.Automation

Registra uma máquina virtual do Azure executando 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ó DSC (Configuração de Estado Desejado) do APS em uma conta de Automação do Azure. Este cmdlet registrará apenas VMs que executam o sistema operacional Windows como um nó DSC de automação para uma conta.

Se precisar registrar um nó em uma conta de automação em uma assinatura diferente, você precisará usar um modelo 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"

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 ser reiniciada. Os valores válidos são:

  • ContinueConfiguration
  • StopConfiguration
Tipo:String
Valores aceites:ContinueConfiguration, StopConfiguration
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AllowModuleOverwrite

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

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AutomationAccountName

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

Tipo:String
Position:1
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AzureVMLocation

O local da VM do Azure.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AzureVMName

O nome da máquina virtual do Azure para se registrar para gerenciamento com o Azure Automation DSC.

Tipo:String
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-AzureVMResourceGroup

O nome do grupo de recursos da VM do Azure.

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ConfigurationMode

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

  • ApplyAndMonitor
  • ApplyAndAutocorrect
  • AplicarApenas
Tipo:String
Valores aceites:ApplyAndMonitor, ApplyAndAutocorrect, ApplyOnly
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais: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
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-NodeConfigurationName

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RebootNodeIfNeeded

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

Tipo:Boolean
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-RefreshFrequencyMins

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

Tipo:Int32
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

-ResourceGroupName

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

Tipo:String
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

Entradas

String

Int32

Boolean

Saídas

Void