Remove-SCXAgent
Remove os computadores UNIX e Linux gerenciados de destino do grupo de gerenciamento.
Sintaxe
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
Para obter informações sobre como recuperar computadores UNIX e Linux gerenciados, consulte o cmdlet Get-SCXAgent.
Esse 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
.
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 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
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 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 |
-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 não gera nenhuma saída.
Não há nenhum caso de falha para o cmdlet Remove-SCXAgent do