Compartilhar via

Remove-SCXAgent

  • Referência
Módulo:
OperationsManager

Remove os computadores UNIX e Linux gerenciados de destino do grupo de gerenciamento.

Syntax

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

Description

O cmdlet Remove-SCXAgent remove os computadores UNIX e Linux gerenciados de destino do grupo de gerenciamento. Computadores UNIX e Linux gerenciados são passados para o cmdlet Remove-SCXAgent como uma matriz de objetos de computador UNIX e Linux.

Para obter informações sobre como recuperar computadores UNIX e Linux gerenciados, consulte o cmdlet Get-SCXAgent.

Este cmdlet não retorna nenhuma saída.

Exemplos

Exemplo 1: remover agentes de gerenciamento

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

O primeiro comando obtém agentes para computadores Linux ou UNIX gerenciados que correspondem aos nomes especificados usando o cmdlet Get-SCXAgent. O comando armazena os resultados na variável de matriz $Agents.

O comando final remove os agentes em $Agents.

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

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

Esse comando obtém agentes para o computador Linux ou UNIX gerenciado que correspondem aos nomes especificados usando Get-SCXAgent. O comando passa os agentes para o cmdlet atual. O comando remove os agentes de gerenciamento.

Parâmetros

-Agent

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

Type:IPersistedUnixComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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.

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

-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.

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

Type:Connection[]
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

Saídas

Este cmdlet não gera saída. Não há nenhum caso de falha para o cmdlet Remove-SCXAgent .