Compartir a través de

Uninstall-SCXAgent

  • Referencia
Módulo:
OperationsManager

Desinstala el agente de administración en los equipos UNIX y Linux administrados especificados.

Sintaxis

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

Description

El cmdlet Uninstall-SCXAgent desinstala el agente de administración en los equipos UNIX y Linux especificados.

El parámetro agente de necesario especifica los equipos UNIX o Linux administrados de destino que se van a desinstalar y requiere un objeto de equipo UNIX o Linux. Para obtener información sobre cómo recuperar equipos UNIX o Linux administrados, consulte el cmdlet Get-SCXAgent. Se puede especificar un parámetro opcional SSHCredential para identificar la credencial con privilegios usada para la desinstalación del agente de administración. Si no se especifica el SSHCredential, el cmdlet intenta usar la cuenta de ejecución con privilegios definida para el agente.

Este cmdlet no devuelve ninguna salida.

Ejemplos

Ejemplo 1: Desinstalar un agente de administración

PS C:\>$Agent01 = Get-SCXAgent -Name "nx1.contoso.com"
PS C:\> $SSHCredential = Get-SCXSSHCredential -UserName "DavidChew" -Key "C:\keys\key21.ppk" -ElevationType sudo
PS C:\> Uninstall-SCXAgent -SSHCredential $SSHCredential -Agent $Agent01

El primer comando obtiene el agente para un equipo Linux o UNIX administrado denominado nx1.contoso.com mediante el cmdlet Get-SCXAgent. El comando lo almacena en la variable $Agent 01.

El segundo comando crea una credencial con privilegios para un usuario mediante el cmdlet Get-SCXSSHCredential. El comando almacena el resultado en la variable $SSHCredential.

El comando final desinstala el agente de administración en $Agent 01 mediante una credencial SSH especificada.

Ejemplo 2: Desinstalación de un agente de administración con la cuenta de ejecución definida

PS C:\>Get-SCXAgent -Name "nx1.contoso.com" | Uninstall-SCXAgent

Este comando obtiene el agente de un equipo Linux o UNIX administrado denominado nx1.contoso.com mediante Get-SCXAgent. El comando pasa el equipo administrado al cmdlet actual. El comando desinstala el agente de administración mediante la cuenta de ejecución definida.

Parámetros

-Agent

Especifica uno o varios objetos de equipo UNIX o Linux administrados. Para obtener información sobre cómo obtener un objeto de equipo UNIX o Linux administrado, escriba Get-Help Get-SCXAgent.

Tipo:IPersistedUnixComputer[]
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-ComputerName

Especifica una matriz de nombres de equipos. El cmdlet establece conexiones temporales con grupos de administración para estos equipos. Puede usar nombres NetBIOS, direcciones IP o nombres de dominio completos (FQDN). Para especificar el equipo local, escriba el nombre del equipo, localhost o un punto (.).

El servicio de acceso a datos de System Center debe estar activo en el equipo. Si no especifica un equipo, el cmdlet usa el equipo para la conexión del grupo de administración actual.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Confirm

Le pide confirmación antes de ejecutar el cmdlet.

Tipo:SwitchParameter
Alias:cf
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Credential

Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración. Especifique un objeto de PSCredential, como el que devuelve el cmdlet get-credential de , para este parámetro. Para obtener más información sobre los objetos de credenciales, escriba Get-Help Get-Credential.

Si especifica un equipo en el parámetro computerName , use una cuenta que tenga acceso a ese equipo. El valor predeterminado es el usuario actual.

Tipo:PSCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SCSession

Especifica una matriz de objetos connection. Para obtener objetos Connection, use el cmdlet Get-SCOMManagementGroupConnection.

Si no se especifica este parámetro, el cmdlet usa la conexión persistente activa a un grupo de administración. Use el parámetro SCSession para especificar una conexión persistente diferente. Puede crear una conexión temporal a un grupo de administración mediante el computerName de y parámetros de Credential. Para obtener más información, escriba Get-Help about_OpsMgr_Connections.

Tipo:Connection[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-SshCredential

Especifica una credencial SSH con privilegios que se usa para realizar las acciones de mantenimiento del agente. Si no se especifica este parámetro, el cmdlet intenta usar la cuenta de ejecución de mantenimiento del agente definida para el agente.

Para obtener información sobre cómo obtener un objeto de credencial SSH, escriba Get-Help Get-SCXSSHCredential.

Tipo:CredentialSet
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-WhatIf

Muestra lo que sucedería si el cmdlet se ejecuta. El cmdlet no se ejecuta.

Tipo:SwitchParameter
Alias:wi
Posición:Named
Valor predeterminado:False
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Salidas

Este cmdlet devuelve resultados, que representan el estado de desinstalación de un equipo. Los resultados contienen la siguiente información:

  • Nombre de host
  • Estado de desinstalación
  • Descripción

La descripción incluye los detalles de por qué se produjo un error de desinstalación.