Remove-SCXAgent
Quita los equipos UNIX y Linux administrados de destino del grupo de administración.
Syntax
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 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 genera resultados de ningún tipo.
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 $AgentsEl 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-SCXAgentEste 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.
| Type: | IPersistedUnixComputer[] |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | 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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Le solicita su confirmación antes de ejecutar el cmdlet.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Especifica la cuenta de usuario en la que se ejecuta la conexión del grupo de administración.
Especifique un objeto PSCredential , como el que devuelve el cmdlet Get-Credential , 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.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 los parámetros ComputerName y Credential .
Para obtener más información, escriba Get-Help about_OpsMgr_Connections.
| Type: | Connection[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Muestra lo que sucedería si se ejecutara el cmdlet. El cmdlet no se ejecuta.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Salidas
Este cmdlet no genera ningún resultado. No hay ningún caso de error para el cmdlet Remove-SCXAgent .