Share via

Unregister-AzAutomationDscNode

  • Referência
Módulo:
Az.Automation

Remove um nó DSC do gerenciamento por uma conta de automação.

Syntax

Unregister-AzAutomationDscNode
          -Id <Guid>
          [-Force]
          [-ResourceGroupName] <String>
          [-AutomationAccountName] <String>
          [-DefaultProfile <IAzureContextContainer>]
          [-WhatIf]
          [-Confirm]
          [<CommonParameters>]

Description

O cmdlet Unregister-AzAutomationDscNode remove um nó DSC (Configuração de Estado Desejado) do gerenciamento por uma conta de Automação do Azure.

Exemplos

Exemplo 1: Remover um nó do Azure DSC do gerenciamento por uma conta de automação

Unregister-AzAutomationDscNode -AutomationAccountName "Contoso17" -ResourceGroupName "ResourceGroup01" -Id 064a8929-c98b-25e4-80hh-111ca86067j8

Este comando remove o nó DSC que tem o GUID especificado do gerenciamento pela conta de automação chamada Contoso17.

Exemplo 2: Remover um nó DSC do Azure do gerenciamento por uma conta de Automação especificando o nome do nó DSC

$dscNodeNameToRemove = "MyMachine1"
$automationAccountName = "Contoso17"
$resourceGroupName = "ResourceGroup01"
$nodeToRemove = Get-AzAutomationDscNode -Name $dscNodeNameToRemove -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName
$nodeToRemove | Unregister-AzAutomationDscNode -AutomationAccountName $automationAccountName -ResourceGroupName $resourceGroupName

Esse comando remove o nó DSC que tem o nome "MyMachine1" do gerenciamento pela conta de automação chamada Contoso17.

Parâmetros

-AutomationAccountName

Especifica o nome da conta de automação da qual esse cmdlet remove um nó DSC.

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita sua confirmação antes de executar o cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

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

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

ps_force

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Id

Especifica a ID exclusiva do nó DSC que esse cmdlet remove.

Type:Guid
Aliases:NodeId
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ResourceGroupName

Especifica o nome de um grupo de recursos no qual esse cmdlet cancela o registro de um nó DSC.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entradas

Guid

String

Saídas

DscNode