Compartilhar via

Get-AzureRmAutomationDscNode

  • Referência
Módulo:
AzureRM.Automation

Obtém nós DSC da Automação.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Get-AzureRmAutomationDscNode
   [-Status <DscNodeStatus>]
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   -Id <Guid>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   [-Status <DscNodeStatus>]
   -Name <String>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   [-Status <DscNodeStatus>]
   -NodeConfigurationName <String>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]
Get-AzureRmAutomationDscNode
   -ConfigurationName <String>
   [-ResourceGroupName] <String>
   [-AutomationAccountName] <String>
   [-DefaultProfile <IAzureContextContainer>]
   [<CommonParameters>]

Description

O cmdlet Get-AzureRmAutomationDscNode obtém nós de DSC (Configuração de Estado Desejado) do APS da Automação do Azure.

Exemplos

Exemplo 1: Obter todos os nós de DSC

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17"

Esse comando obtém metadados para todos os nós DSC na conta de Automação chamada Contoso17.

Exemplo 2: Obter todos os nós de DSC para uma configuração de DSC

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -ConfigurationName "ContosoConfiguration"

Esse comando obtém metadados para todos os nós de DSC na conta de Automação chamada Contoso17 que são mapeados para uma configuração de nó de DSC que foi gerada pela configuração de DSC ContosoConfiguration.

Exemplo 3: Obter um nó DSC por ID

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Id c0a1718e-d8be-4fa3-91b6-82e1d3a36298

Esse comando obtém metadados em um nó DSC com a ID especificada na conta de Automação chamada Contoso17.

Exemplo 4: Obter um nó DSC por nome

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -Name "Computer14"

Esse comando obtém metadados em um nó DSC com o nome Computer14 na conta de Automação chamada Contoso17.

Exemplo 5: Obter todos os nós de DSC mapeados para uma configuração de nó de DSC

PS C:\>Get-AzureRmAutomationDscNode -ResourceGroupName "ResourceGroup03" -AutomationAccountName "Contoso17" -NodeConfigurationName "ContosoConfiguration.webserver"

Esse comando obtém metadados em todos os nós DSC na conta de Automação chamada Contoso17 que são mapeados para uma configuração de nó DSC chamada ContosoConfiguration.webserver.

Parâmetros

-AutomationAccountName

Especifica o nome da conta de Automação que contém os nós DSC que esse cmdlet obtém.

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

-ConfigurationName

Especifica o nome de uma configuração de DSC. Esse cmdlet obtém nós DSC que correspondem às configurações de nó geradas a partir da configuração especificada por esse parâmetro.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:True
Aceitar a entrada de pipeline:False
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:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Id

Especifica a ID exclusiva do nó DSC que esse cmdlet obtém.

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

-Name

Especifica o nome de um nó DSC que esse cmdlet obtém.

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

-NodeConfigurationName

Especifica o nome de uma configuração de nó que esse cmdlet obtém.

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

-ResourceGroupName

Especifica o nome de um grupo de recursos no qual esse cmdlet obtém nós DSC.

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

-Status

Especifica o status dos nós DSC que esse cmdlet obtém. Os valores válidos são:

  • Em conformidade
  • Não compatível
  • Com falha
  • Pendente
  • Recebida
  • Sem resposta
Tipo:DscNodeStatus
Valores aceitos:Compliant, NotCompliant, Failed, Pending, Received, Unresponsive
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

Guid

String

Saídas

DscNode