Partager via

Uninstall-SCOMAgent

  • Référence
Module:
OperationsManager

Désinstalle les agents des ordinateurs gérés par l’agent.

Syntax

Uninstall-SCOMAgent
         [-ActionAccount <PSCredential>]
         -Agent <AgentManagedComputer[]>
         [-PassThru]
         [-WhatIf]
         [-Confirm]
         [<CommonParameters>]

Description

L’applet de commande Uninstall-SCOMAgent désinstalle les agents des ordinateurs gérés par l’agent. Avant de désinstaller un agent, vous devez supprimer les affectations de l’agent services de domaine Active Directory (AD DS) du groupe d’administration. Vous pouvez utiliser le cmdet Remove-SCOMADAgentAssignment pour supprimer les affectations d’agent AD DS du groupe d’administration.

Exemples

Exemple 1 : Désinstaller un agent

PS C:\>Get-SCOMAgent -DNSHostName "server01.contoso.com" | Uninstall-SCOMAgent

La première commande obtient l’objet agent Operations Manager nommé server01.contoso.com et le transmet à l’applet de commande Uninstall-SCOMAgent à l’aide de l’opérateur de pipeline. La deuxième commande désinstalle l’agent nommé server01.contoso.com.

Exemple 2 : Désinstaller un agent à l’aide d’une variable objet

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent

Cet exemple désinstalle l’agent Operations Manager sur un ordinateur géré par l’agent.

La première commande obtient l’objet ordinateur géré par l’agent nommé server01.contoso.com et stocke l’objet dans la variable $Agent.

La deuxième commande désinstalle l’agent stocké dans $Agent.

Exemple 3 : Désinstaller un agent à l’aide d’un compte d’action

PS C:\>$Agent = Get-SCOMAgent -DNSHostName "server01.contoso.com"
PS C:\> Uninstall-SCOMAgent -Agent $Agent -ActionAccount (Get-Credential)

Cet exemple désinstalle l’agent Operations Manager sur un ordinateur géré par l’agent une fois que l’utilisateur a entré les informations d’identification requises par Operations Manager pour désinstaller l’agent.

La première commande obtient l’objet agent nommé server01.contoso.com et stocke l’objet dans la variable $Agent.

La deuxième commande invite l’utilisateur à entrer les informations d’identification que Operations Manager utilise pour désinstaller un agent. La commande désinstalle ensuite l’agent stocké dans $Agent.

Paramètres

-ActionAccount

Spécifie un objet PSCredential . Ce paramètre spécifie les informations d’identification que Operations Manager utilise pour exécuter la tâche de déploiement. Si vous ne spécifiez pas ce paramètre ou si vous spécifiez une valeur Null, Operations Manager utilise le compte d’action par défaut du serveur d’administration pour l’agent.

Pour obtenir un objet PSCredential, utilisez l'applet de commande Get-Credential. Pour plus d'informations, voir Get-Help Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Agent

Spécifie un tableau d’objets AgentManagedComputer . Ce paramètre spécifie les agents Operations Manager à désinstaller. Pour obtenir un objet AgentManagedComputer , utilisez l’applet de commande Get-SCOMADAgent .

Type:AgentManagedComputer[]
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Confirm

Vous demande une confirmation avant d’exécuter l’applet de commande.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Indique que l’applet de commande crée ou modifie un objet qu’une commande peut utiliser dans le pipeline. Par défaut, cette applet de commande ne génère aucun résultat.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Montre ce qui se passe en cas d’exécution de l’applet de commande. L’applet de commande n’est pas exécutée.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Entrées

Microsoft.EnterpriseManagement.Administration.AgentManagedComputer

Sorties

Microsoft.EnterpriseManagement.Administration.AgentTaskResult