Uninstall-SCOMAgent
Desinstala agentes de computadores gerenciados por agente.
Sintaxe
Default (Padrão)
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 AD DS (Active Directory Domain Services) do grupo de gerenciamento. Você pode usar o cmdet Remove-SCOMADAgentAssignment para remover as 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
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 no $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 para o Operations Manager desinstalar o agente.
O primeiro comando obtém o objeto de 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 no $Agent.
Parâmetros
-ActionAccount
Especifica um objeto PSCredential
Para obter um objeto Get-Help Get-Credential.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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.
Propriedades do parâmetro
| Tipo: | AgentManagedComputer[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-Confirm
Solicita a confirmação antes de executar o cmdlet.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | cf |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-PassThru
Indica que o cmdlet cria ou modifica um objeto que um comando pode usar no pipeline. Por padrão, esse cmdlet não gera nenhuma saída.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | wi |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.