Uninstall-SCOMAgent
Desinstala agentes de computadores gerenciados por agente.
Sintaxe
Default (Predefiniçã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 dos Serviços de Domínio Ative Directory (AD DS) do grupo de gerenciamento. Você pode usar o Remove-SCOMADAgentAssignment cmdet para remover 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 de 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 por 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 ao Operations Manager para 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. Este parâmetro especifica as credenciais que o Operations Manager usa para executar a tarefa de implantação. Se você não especificar esse parâmetro ou especificar um valor nulo, o Operations Manager usará a conta de ação padrão do servidor de gerenciamento para o agente.
Para obter um objeto PSCredential Get-Help Get-Credential.
Propriedades dos parâmetros
| Tipo: | PSCredential |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Agent
Especifica uma matriz de objetos AgentManagedComputer.
Este parâmetro especifica os agentes do Operations Manager a serem desinstalados.
Para obter um objeto
Propriedades dos parâmetros
| Tipo: | AgentManagedComputer[] |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-Confirm
Solicita confirmação antes de executar o cmdlet.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Cf. |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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 dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | None |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | False |
-WhatIf
Mostra o que aconteceria se o cmdlet fosse executado. O cmdlet não é executado.
Propriedades dos parâmetros
| Tipo: | SwitchParameter |
| Default value: | False |
| Suporta carateres universais: | False |
| NãoMostrar: | False |
| Aliases: | Wi |
Conjuntos de parâmetros
(All)
| Position: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline por nome de propriedade: | False |
| Valor dos restantes argumentos: | 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.