Uninstall-SCOMAgent
Desinstala los agentes de los equipos administrados por agente.
Sintaxis
Default (Es el valor predeterminado).
Uninstall-SCOMAgent
[-ActionAccount <PSCredential>]
-Agent <AgentManagedComputer[]>
[-PassThru]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
El cmdlet Uninstall-SCOMAgent desinstala los agentes de los equipos administrados por agente. Antes de desinstalar un agente, debe quitar las asignaciones de agentes de Active Directory Domain Services (AD DS) del grupo de administración. Puede usar el remove-SCOMADAgentAssignment cmdet para quitar las asignaciones de agente de AD DS del grupo de administración.
Ejemplos
Ejemplo 1: Desinstalar un agente
PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent
El primer comando obtiene el objeto del agente de Operations Manager denominado server01.contoso.com y lo pasa al cmdlet Uninstall-SCOMAgent mediante el operador de canalización. El segundo comando desinstala el agente denominado server01.contoso.com.
Ejemplo 2: Desinstalación de un agente mediante una variable de objeto
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent
En este ejemplo se desinstala el agente de Operations Manager en un equipo administrado por agente.
El primer comando obtiene el objeto de equipo administrado por el agente denominado server01.contoso.com y almacena el objeto en la variable $Agent.
El segundo comando desinstala el agente almacenado en $Agent.
Ejemplo 3: Desinstalar un agente mediante una cuenta de acción
PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)
En este ejemplo se desinstala el agente de Operations Manager en un equipo administrado por agente después de que el usuario escriba las credenciales que Operations Manager necesita para desinstalar el agente.
El primer comando obtiene el objeto del agente denominado server01.contoso.com y almacena el objeto en la variable $Agent.
El segundo comando solicita al usuario que escriba las credenciales que Operations Manager usa para desinstalar un agente. A continuación, el comando desinstala el agente almacenado en $Agent.
Parámetros
-ActionAccount
Especifica un objeto de de
Para obtener un objeto de de Get-Help Get-Credential.
Propiedades del parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Agent
Especifica una matriz de objetos AgentManagedComputer.
Este parámetro especifica los agentes de Operations Manager que se van a desinstalar.
Para obtener un objeto AgentManagedComputer de
Propiedades del parámetro
| Tipo: | AgentManagedComputer[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Confirm
Le pide confirmación antes de ejecutar el cmdlet.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | cf |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-PassThru
Indica que el cmdlet crea o modifica un objeto que un comando puede usar en la canalización. De forma predeterminada, este cmdlet no genera ninguna salida.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-WhatIf
Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.
Propiedades del parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | Wi |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Mandatory: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.