Partilhar via

Uninstall-SCOMAgent

  • Referência
Módulo:
OperationsManager

Desinstala agentes de computadores geridos por agentes.

Syntax

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

Description

O cmdlet Uninstall-SCOMAgent desinstala agentes de computadores geridos por agentes. Antes de desinstalar um agente, deve remover as atribuições de agente Ative Directory Domain Services (DS DS) do grupo de gestão. Pode utilizar o cmdet remove-SCOMADAgentAssignment para remover as atribuições de agentes AD DS do grupo de gestão.

Exemplos

Exemplo 1: Desinstalar um agente

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

O primeiro comando recebe o objeto do agente gestor de operações nomeado server01.contoso.com e passa-o para o cmdlet Uninstall-SCOMAgent utilizando o operador do gasoduto. O segundo comando desinstala o agente chamado server01.contoso.com.

Exemplo 2: Desinstale um agente utilizando 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 Gestor de Operações num computador gerido por agentes.

O primeiro comando obtém o objeto de computador gerido 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 utilizando 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 Gestor de Operações num computador gerido por agente depois de o utilizador introduzir as credenciais que o Gestor de Operações necessita para desinstalar o agente.

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

O segundo comando solicita ao utilizador que introduza as credenciais que o Gestor de Operações utiliza para desinstalar um agente. Em seguida, o comando desinstala o agente armazenado em $Agent.

Parâmetros

-ActionAccount

Especifica um objeto PSCredential . Este parâmetro especifica as credenciais que o Gestor de Operações utiliza para executar a tarefa de implantação. Se não especificar este parâmetro ou especificar um valor nulo, o Gestor de Operações utiliza a conta de ação padrão do servidor de gestão para o agente.

Para obter um objeto PSCredential , utilize o cmdlet Get-Credential . Para mais informações, insira 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 . Este parâmetro especifica os agentes do Gestor de Operações para desinstalar. Para obter um objeto AgentManagedComputer , utilize o cmdlet Get-SCOMADAgent .

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Solicita a 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 na tubagem. Por predefinição, este cmdlet não gera quaisquer dados.

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

-WhatIf

Apresenta o que aconteceria mediante a execução do cmdlet. 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