Compartilhar via

Uninstall-SCXAgent

  • Referência
Módulo:
OperationsManager

Desinstala o agente de gerenciamento nos computadores UNIX e Linux gerenciados especificados.

Sintaxe

Uninstall-SCXAgent
         -Agent <IPersistedUnixComputer[]>
         [-SshCredential <CredentialSet>]
         [-SCSession <Connection[]>]
         [-ComputerName <String[]>]
         [-Credential <PSCredential>]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

O cmdlet Uninstall-SCXAgent desinstala o agente de gerenciamento nos computadores UNIX e Linux especificados.

O parâmetro Agent necessário especifica os computadores UNIX ou Linux gerenciados de destino para desinstalar e requer um objeto de computador UNIX ou Linux. Para obter informações sobre como recuperar computadores UNIX ou Linux gerenciados, consulte o cmdlet Get-SCXAgent. Um parâmetro SSHCredential opcional pode ser especificado para identificar a credencial privilegiada usada para desinstalação do agente de gerenciamento. Se o SSHCredential não for especificado, o cmdlet tentará usar a conta Executar como privilegiada definida para o agente.

Esse cmdlet não retorna nenhuma saída.

Exemplos

Exemplo 1: Desinstalar um agente de gerenciamento

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01

O primeiro comando obtém o agente de um computador Linux ou UNIX gerenciado chamado nx1.contoso.com usando o cmdlet Get-SCXAgent. O comando o armazena na variável $Agent 01.

O segundo comando cria uma credencial privilegiada para um usuário usando o cmdlet Get-SCXSSHCredential. O comando armazena o resultado na variável $SSHCredential.

O comando final desinstala o agente de gerenciamento no $Agent 01 usando uma credencial SSH especificada.

Exemplo 2: desinstalar um agente de gerenciamento com a conta Executar como definida

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-SCXAgent

Esse comando obtém o agente de um computador Linux ou UNIX gerenciado chamado nx1.contoso.com usando Get-SCXAgent. O comando passa o computador gerenciado para o cmdlet atual. O comando desinstala o agente de gerenciamento usando a conta Executar como definida.

Parâmetros

-Agent

Especifica um ou mais objetos de computador UNIX ou Linux gerenciados. Para obter informações sobre como obter um objeto de computador UNIX ou Linux gerenciado, digite Get-Help Get-SCXAgent.

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

-ComputerName

Especifica uma matriz de nomes de computadores. O cmdlet estabelece conexões temporárias com grupos de gerenciamento para esses computadores. Você pode usar nomes NetBIOS, endereços IP ou FQDNs (nomes de domínio totalmente qualificados). Para especificar o computador local, digite o nome do computador, localhost ou um ponto (.).

O serviço de Acesso a Dados do System Center deve estar ativo no computador. Se você não especificar um computador, o cmdlet usará o computador para a conexão do grupo de gerenciamento atual.

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

-Confirm

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

Tipo:SwitchParameter
Aliases:cf
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Credential

Especifica a conta de usuário na qual a conexão do grupo de gerenciamento é executada. Especifique um objeto PSCredential, como um que o cmdlet Get-Credential retorna para esse parâmetro. Para obter mais informações sobre objetos de credencial, digite Get-Help Get-Credential.

Se você especificar um computador no parâmetro ComputerName, use uma conta que tenha acesso a esse computador. O padrão é o usuário atual.

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

-SCSession

Especifica uma matriz de objetos Connection. Para obter objetos Connection, use o cmdlet Get-SCOMManagementGroupConnection .

Se esse parâmetro não for especificado, o cmdlet usará a conexão persistente ativa com um grupo de gerenciamento. Use o parâmetro SCSession para especificar uma conexão persistente diferente. Você pode criar uma conexão temporária com um grupo de gerenciamento usando os parâmetros ComputerName e Credential. Para obter mais informações, digite Get-Help about_OpsMgr_Connections.

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

-SshCredential

Especifica uma credencial SSH privilegiada usada para executar as ações de manutenção do agente. Se esse parâmetro não for especificado, o cmdlet tentará usar a conta Executar como de manutenção do agente definida para o agente.

Para obter informações sobre como obter um objeto de credencial SSH, digite Get-Help Get-SCXSSHCredential.

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

-WhatIf

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

Tipo:SwitchParameter
Aliases:wi
Cargo:Named
Valor padrão:False
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Saídas

Esse cmdlet retorna resultados, que representam o status de desinstalação de um computador. Os resultados contêm as seguintes informações:

  • Nome do host
  • Desinstalar status
  • Descrição

A descrição inclui os detalhes de por que uma desinstalação falhou.