Share via

Uninstall-SCOMAgent

  • Referencia
Módulo:
OperationsManager

Desinstala los agentes de los equipos administrados por agente.

Syntax

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 agente de Servicios de dominio de Active Directory (AD DS) del grupo de administración. Puede usar el cmdet Remove-SCOMADAgentAssignment 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: Desinstalar 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 PSCredential . Este parámetro especifica las credenciales que Operations Manager usa para ejecutar la tarea de implementación. Si no especifica este parámetro o especifica un valor NULL, Operations Manager usa la cuenta de acción predeterminada del servidor de administración para el agente.

Para obtener un objeto PSCredential, use el cmdlet Get-Credential. Para obtener más información, escriba Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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 , use el cmdlet Get-SCOMADAgent .

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-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 ningún resultado.

Type:SwitchParameter
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

Entradas

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Salidas

Microsoft.EnterpriseManagement.Administration.AgentTaskResult