Remove-WmiObject

Syntaxe

class (Par défaut)

Remove-WmiObject
    [-Class] <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

object

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

path

Remove-WmiObject
    -Path <String>
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

WQLQuery

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

query

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

list

Remove-WmiObject
    [-AsJob]
    [-Impersonation <ImpersonationLevel>]
    [-Authentication <AuthenticationLevel>]
    [-Locale <String>]
    [-EnableAllPrivileges]
    [-Authority <String>]
    [-Credential <PSCredential>]
    [-ThrottleLimit <Int32>]
    [-ComputerName <String[]>]
    [-Namespace <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Exemples

Exemple 1 : Fermer toutes les instances d’un processus Win32

PS C:\> notepad
PS C:\> $np = Get-WmiObject -Query "select * from win32_process where name='notepad.exe'"
PS C:\> $np | Remove-WmiObject

Exemple 2 : Supprimer un dossier

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

Paramètres

-AsJob

Indique que cette applet de commande s’exécute en tant que travail en arrière-plan. Utilisez ce paramètre pour exécuter des commandes qui prennent beaucoup de temps.

Les nouvelles applets de commande CIM, introduites par Windows PowerShell 3.0, effectuent les mêmes tâches que les applets de commande WMI. Les applets de commande CIM sont conformes aux normes WS-Management (WSMan) et à la norme CIM (Common Information Model), ce qui permet aux applets de commande d’utiliser les mêmes techniques pour gérer les ordinateurs qui exécutent le système d’exploitation Windows et ceux qui exécutent d’autres systèmes d’exploitation. Au lieu d’utiliser Remove-WmiObject, envisagez d’utiliser l’applet de commande Remove-CimInstancehttps://go.microsoft.com/fwlink/?LinkId=227964.

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

Pour utiliser ce paramètre pour les ordinateurs distants, les ordinateurs locaux et distants doivent être configurés pour la communication à distance. Démarrez Windows PowerShell à l’aide de l’option Exécuter en tant qu’administrateur. Pour plus d’informations, consultez about_Remote_Requirements.

Pour plus d’informations sur les travaux en arrière-plan Windows PowerShell, consultez about_Jobs et about_Remote_Jobs.

Propriétés du paramètre

Jeux de paramètres

-Authentication

Spécifie le niveau d’authentification à utiliser pour la connexion WMI. Les valeurs acceptables pour ce paramètre sont les suivantes :

• -1 : inchangé.
• 0 : valeur par défaut.
• 1 : Aucun. Aucune authentification n’est effectuée.
• 2 : Se connecter. L’authentification est effectuée uniquement lorsque le client établit une relation avec l’application.
• 3 : Appel. L’authentification est effectuée uniquement au début de chaque appel lorsque l’application reçoit la demande.
• 4 : Paquet. 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.

Propriétés du paramètre

Jeux de paramètres

-Authority

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

Propriétés du paramètre

Jeux de paramètres

-Class

Spécifie le nom d’une classe WMI que cette applet de commande supprime.

Propriétés du paramètre

Jeux de paramètres

-ComputerName

Spécifie le nom de l’ordinateur sur lequel s’exécute cette applet de commande. La valeur par défaut est l’ordinateur local.

Tapez le nom NetBIOS, une adresse IP ou un nom de domaine complet d’un ou plusieurs ordinateurs. Pour spécifier l’ordinateur local, tapez le nom de l’ordinateur, un point (.) ou localhost.

Ce paramètre ne s’appuie pas sur la communication à distance Windows PowerShell. Vous pouvez utiliser le paramètre ComputerName même si votre ordinateur n’est pas configuré pour exécuter des commandes distantes.

Propriétés du paramètre

Jeux de paramètres

-Confirm

Vous invite à confirmer avant d’exécuter l’applet de commande.

Propriétés du paramètre

Jeux de paramètres

-Credential

Spécifie un compte d’utilisateur autorisé à effectuer cette action. La valeur par défaut est l’utilisateur actuel.

Tapez un nom d’utilisateur, tel que User01 ou Domain01\User01, ou entrez un objet PSCredential, tel qu’un objet généré par l’applet de commande Get-Credential. Si vous tapez un nom d’utilisateur, cette applet de commande vous invite à entrer un mot de passe.

Propriétés du paramètre

Jeux de paramètres

-EnableAllPrivileges

Indique que cette applet de commande active toutes les autorisations de l’utilisateur actuel avant la commande qu’elle effectue l’appel WMI.

Propriétés du paramètre

Jeux de paramètres

-Impersonation

Spécifie le niveau d’emprunt d’identité à utiliser. Les valeurs acceptables pour ce paramètre sont les suivantes :

• 0 : valeur par défaut. Lit le Registre local pour le niveau d’emprunt d’identité par défaut, qui est généralement défini sur 3 : Emprunt d’identité.
• 1 : Anonyme. Masque les informations d’identification de l’appelant.
• 2 : Identifier. Permet aux objets d’interroger les informations d’identification de l’appelant.
• 3 : Emprunt d’identité. Permet aux objets d’utiliser les informations d’identification de l’appelant.
• 4 : Délégué. Permet aux objets d’autoriser d’autres objets à utiliser les informations d’identification de l’appelant.

Propriétés du paramètre

Jeux de paramètres

-InputObject

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

Propriétés du paramètre

Jeux de paramètres

-Locale

Spécifie les paramètres régionaux préférés pour les objets WMI. Le paramètre Paramètres régionaux est spécifié en tant que tableau au format< LCID MS_>dans l’ordre préféré.

Propriétés du paramètre

Jeux de paramètres

-Namespace

Spécifie l’espace de noms du référentiel WMI où se trouve la classe WMI référencée lorsqu’elle est utilisée avec le paramètre classe .

Propriétés du paramètre

Jeux de paramètres

-Path

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.

Propriétés du paramètre

Jeux de paramètres

-ThrottleLimit

Spécifie le nombre maximal de connexions simultanées qui peuvent être établies pour exécuter cette commande. Ce paramètre est utilisé avec le paramètre AsJob. La limite de limitation s’applique uniquement à la commande actuelle, et non à la session ou à l’ordinateur.

Propriétés du paramètre

Jeux de paramètres

-WhatIf

Affiche ce qui se passerait si l’applet de commande s’exécute. L’applet de commande ne s’exécute pas.

Propriétés du paramètre

Jeux de paramètres

CommonParameters

Entrées

ManagementObject

Sorties

None, System.Management.Automation.RemotingJob

Liens associés

• Get-WmiObject
• Invoke-WmiMethod
• Set-WmiInstance