Remove-WmiObject

Supprime une instance d'une classe Windows Management Instrumentation (WMI) existante.

Syntaxe

Remove-WmiObject [-Class] <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject -InputObject <ManagementObject> [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject -Path <string> [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Remove-WmiObject [-Authentication {<Default> | <None> | <Connect> | <Call> | <Packet> | <PacketIntegrity> | <PacketPrivacy> | <Unchanged>}] [-Authority <string>] [-ComputerName <string[]>] [-Credential <PSCredential>] [-EnableAllPrivileges] [-Impersonation {<Default> | <Anonymous> | <Identify> | <Impersonate> | <Delegate>}] [-Locale <string>] [-Namespace <string>] [-AsJob] [-ThrottleLimit <int>] [-Confirm] [-WhatIf] [<CommonParameters>]

Description

L'applet de commande Remove-WmiObject supprime une instance d'une classe WMI existante.

Paramètres

-AsJob

Exécute la commande en tant que tâche en arrière-plan. Utilisez ce paramètre pour exécuter des commandes dont l'exécution nécessite beaucoup de temps.

Exécute la commande en tant que tâche en arrière-plan. Utilisez ce paramètre pour exécuter des commandes dont l'exécution nécessite beaucoup de temps.

Lorsque vous utilisez le paramètre AsJob, la commande retourne un objet qui représente la tâche en arrière-plan, puis affiche l'invite de commandes. Vous pouvez continuer à travailler dans la session pendant l'exécution de la tâche. Si Remove-WmiObject est utilisé sur un ordinateur distant, la tâche est créée sur l'ordinateur local, et les résultats provenant d'ordinateurs distants sont automatiquement retournés à l'ordinateur local. Pour gérer la tâche, utilisez les applets de commande contenant le nom Job (les applets de commande Job). Pour obtenir les résultats de la tâche, utilisez l'applet de commande Receive-Job.

Remarque : pour utiliser ce paramètre avec des ordinateurs distants, l'ordinateur local et l'ordinateur distant doivent être configurés pour la communication à distance. En outre, vous devez démarrer Windows PowerShell en utilisant l'option « Exécuter en tant qu'administrateur » dans Windows Vista et les versions ultérieures de Windows. Pour plus d'informations, consultez about_Remote_Requirements.

Pour plus d'informations sur les tâches en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.

-Authentication <AuthenticationLevel>

Spécifie le niveau d'authentification à utiliser avec la connexion WMI. Les valeurs valides sont :

-1 : Unchanged

0 : Default

1 : None (Aucune authentification n'est effectuée.)

2 : Connect (L'authentification est effectuée uniquement lorsque le client établit une relation avec l'application.)

3 : Call (L'authentification est effectuée uniquement au début de chaque appel, quand l'application reçoit une demande.)

4 : Packet (L'authentification est effectuée sur toutes les données reçues du client.)

5 : PacketIntegrity (Toutes les données transférées entre le client et l'application sont authentifiées et vérifiées.)

6 : PacketPrivacy (Les propriétés des autres niveaux d'authentification sont utilisées, et toutes les données sont chiffrées.)

-Authority <string>

Spécifie l'autorité à utiliser pour authentifier la connexion WMI. Vous pouvez spécifier l'authentification Kerberos ou NTLM standard. Pour utiliser NTLM, affectez au paramètre d'autorité la valeur « ntlmdomain:<Nom_Domaine> », où <Nom_Domaine> identifie un nom de domaine NTLM valide. Pour utiliser Kerberos, spécifiez « kerberos:<Nom_Domaine>\<Nom_Serveur> ». Vous ne pouvez pas inclure le paramètre d'autorité lorsque vous vous connectez à l'ordinateur local.

-Class <string>

Spécifie le nom d'une classe WMI que vous voulez supprimer.

-ComputerName <string[]>

Spécifie l'ordinateur sur lequel vous voulez exécuter l'opération de gestion. La valeur peut être un nom de domaine complet, un nom NetBIOS ou une adresse IP. Utilisez le nom de l'ordinateur local, localhost ou un point (.) pour spécifier l'ordinateur local. L'ordinateur local est la valeur par défaut. Lorsque l'ordinateur distant se trouve dans un domaine différent de l'utilisateur, vous devez utiliser un nom de domaine complet. Vous pouvez définir la valeur de ce paramètre en redirigeant la valeur vers le paramètre.

Ce paramètre ne s'appuie pas sur la communication à distance Windows PowerShell, laquelle utilise le service Gestion des services Web). Vous pouvez utiliser le paramètre ComputerName de Get-WmiObject même si votre ordinateur n'est pas configuré pour exécuter des commandes distantes du service Gestion des services Web.

-Credential <PSCredential>

Spécifie un compte d'utilisateur qui a l'autorisation d'exécuter cette action. La valeur par défaut est l'utilisateur actuel. Tapez un nom d'utilisateur, tel que « User01 », « Domain01\User01 » ou « User@Contoso.com ». Vous pouvez également entrer un objet PSCredential, tel qu'un objet qui est retourné par l'applet de commande Get-Credential. Lorsque vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.

-EnableAllPrivileges

Active tous les privilèges de l'utilisateur actuel avant que la commande ne passe l'appel WMI.

-Impersonation <ImpersonationLevel>

Spécifie le niveau d'emprunt d'identité à utiliser. Les valeurs valides sont :

0 : Default (Lit le Registre local pour connaître le niveau d'emprunt d'identité par défaut, qui a généralement la valeur « 3 : Impersonate ».)

1 : Anonymous (Masque les informations d'identification de l'appelant.)

2 : Identify (Permet aux objets d'interroger les informations d'identification de l'appelant.)

3 : Impersonate (Permet aux objets d'utiliser les informations d'identification de l'appelant.)

4 : Delegate (Permet aux objets d'autoriser d'autres objets à utiliser les informations d'identification de l'appelant.)

-InputObject <ManagementObject>

Spécifie un objet ManagementObject à utiliser en entrée. Lorsque ce paramètre est utilisé, tous les autres paramètres sont ignorés.

-Locale <string>

Spécifie les paramètres régionaux par défaut pour les objets WMI. Le paramètre Locale est spécifié dans un tableau au format MS_<LCID> dans l'ordre de préférence.

-Namespace <string>

Lorsqu'il est utilisé avec le paramètre Class, ce paramètre spécifie l'espace de noms du répertoire de stockage WMI dans lequel figure la classe WMI référencée.

-Path <string>

Spécifie le chemin d'accès de l'objet WMI d'une classe WMI, ou spécifie le chemin d'accès de l'objet WMI d'une instance d'une classe WMI à supprimer.

-ThrottleLimit <int>

Permet à l'utilisateur de spécifier une valeur de limitation pour le nombre d'opérations WMI pouvant être exécutées simultanément. Ce paramètre est utilisé avec le paramètre AsJob. La limite d'accélération s'applique uniquement à la commande actuelle, et non à la session ou à l'ordinateur.

-Confirm

Vous invite à confirmer l'exécution de la commande.

-WhatIf

Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.

<CommonParameters>

Cette applet de commande prend en charge les paramètres courants : -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer et -OutVariable. Pour plus d'informations, consultez about_Commonparameters.

Entrées et sorties

Le type d'entrée est le type des objets que vous pouvez diriger vers l'applet de commande. Le type de retour est le type des objets que l'applet de commande retourne.

Exemple 1

C:\PS>notepad   
C:\PS> $np = get-wmiobject -query "select * from win32_process where name='notepad.exe'"
C:\PS> $np | remove-wmiobject

Description
-----------
Cette commande ferme toutes les instances de Notepad.exe.

La première commande démarre une instance de Bloc-notes. 

La deuxième commande utilise l'applet de commande Get-WmiObject pour récupérer les instances de Win32_Process qui correspondent à Notepad.exe et les stocke dans la variable $np. 

La troisième commande passe l'objet dans la variable $np à l'applet de commande Remove-WmiObject, qui supprime toutes les instances de Notepad.exe.

Exemple 2

C:\PS>$a = Get-WMIObject -query "Select * From Win32_Directory Where Name ='C:\\Test'"
C:\PS> $a | Remove-WMIObject

Description
-----------
Cette commande supprime le répertoire C:\Test.

La première commande utilise l'applet de commande Get-WMIObject pour lancer une requête sur le répertoire C:\Test puis stocke l'objet dans la variable $a.

La seconde commande dirige la variable $a vers Remove-WMIObject, ce qui supprime le répertoire.

Voir aussi

Concepts

Get-WmiObject
Invoke-WmiMethod
Set-WmiInstance
Get-WSManInstance
Invoke-WSManAction
New-WSManInstance
Remove-WSManInstance