Remove-SCXAgent

  • Referencia
Módulo:
OperationsManager

Quita los equipos UNIX y Linux administrados de destino del grupo de administración.

Sintaxis

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

Description

El cmdlet Remove-SCXAgent quita los equipos UNIX y Linux administrados de destino del grupo de administración. Los equipos UNIX y Linux administrados se pasan al cmdlet remove-SCXAgent de como una matriz de objetos de equipo UNIX y Linux.

Para obtener información sobre cómo recuperar equipos UNIX y Linux administrados, consulte el cmdlet Get-SCXAgent.

Este cmdlet no devuelve ninguna salida.

Ejemplos

Ejemplo 1: Eliminación de agentes de administración

PS C:\>$Agents = Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com"
PS C:\> Remove-SCXAgent -Agent $Agents

El primer comando obtiene agentes para equipos Linux o UNIX administrados que coinciden con los nombres especificados mediante el cmdlet Get-SCXAgent. El comando almacena los resultados en la variable de matriz $Agents.

El comando final quita los agentes de $Agents.

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

PS C:\>Get-SCXAgent -Name "scxserver1.contoso.com","scxserver2*","*.development.contoso.com" | Remove-SCXAgent

Este comando obtiene agentes para equipos Linux o UNIX administrados que coinciden con los nombres especificados mediante Get-SCXAgent. El comando pasa los agentes al cmdlet actual. El comando quita los agentes de administración.

Parámetros

-Agent

Especifica uno o varios objetos de equipo UNIX y 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

-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 no genera ninguna salida. No hay ningún caso de error para el cmdlet de Remove-SCXAgent.