Compartilhar via

Uninstall-SCOMAgent

  • Referência
Módulo:
OperationsManager

Desinstala agentes de computadores gerenciados por agente.

Syntax

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

O cmdlet Uninstall-SCOMAgent desinstala agentes de computadores gerenciados por agente. Antes de desinstalar um agente, você deve remover as atribuições de agente do Active Directory Domain Services (AD DS) do grupo de gerenciamento. Você pode usar o cmdet Remove-SCOMADAgentAssignment para remover atribuições de agente do AD DS do grupo de gerenciamento.

Exemplos

Exemplo 1: Desinstalar um agente

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

O primeiro comando obtém o objeto do agente do Operations Manager chamado server01.contoso.com e o passa para o cmdlet Uninstall-SCOMAgent usando o operador de pipeline. O segundo comando desinstala o agente chamado server01.contoso.com.

Exemplo 2: Desinstalar um agente usando uma variável de objeto

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

Este exemplo desinstala o agente do Operations Manager em um computador gerenciado por agente.

O primeiro comando obtém o objeto de computador gerenciado pelo agente chamado server01.contoso.com e armazena o objeto na variável $Agent.

O segundo comando desinstala o agente armazenado em $Agent.

Exemplo 3: Desinstalar um agente usando uma conta de ação

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

Este exemplo desinstala o agente do Operations Manager em um computador gerenciado por agente depois que o usuário insere as credenciais necessárias pelo Operations Manager para desinstalar o agente.

O primeiro comando obtém o objeto do agente chamado server01.contoso.com e armazena o objeto na variável $Agent.

O segundo comando solicita que o usuário insira as credenciais que o Operations Manager usa para desinstalar um agente. Em seguida, o comando desinstala o agente armazenado em $Agent.

Parâmetros

-ActionAccount

Especifica um objeto PSCredential . Esse parâmetro especifica as credenciais que o Operations Manager usa para executar a tarefa de implantação. Se você não especificar esse parâmetro ou especificar um valor nulo, o Operations Manager usará a conta de ação padrão do servidor de gerenciamento para o agente.

Para obter um objeto PSCredential, use o cmdlet Get-Credential. Para obter mais informações, digite Get-Help Get-Credential.

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

-Agent

Especifica uma matriz de objetos AgentManagedComputer . Esse parâmetro especifica os agentes do Operations Manager para desinstalar. Para obter um objeto AgentManagedComputer , use o cmdlet Get-SCOMADAgent .

Type:AgentManagedComputer[]
Position:Named
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

-PassThru

Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, este cmdlet não gera saída.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Saídas

Microsoft.EnterpriseManagement.Administration.AgentTaskResult