Supprime la propriété et sa valeur d'un élément.
Syntaxe
Remove-ItemProperty [-LiteralPath] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>] Remove-ItemProperty [-Path] <string[]> [-Name] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-Confirm] [-WhatIf] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Remove-ItemProperty supprime une propriété et sa valeur d'un élément. Vous pouvez l'utiliser pour supprimer des valeurs de Registre et les données qu'elles contiennent.
Paramètres
-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 » ou « Domain01\User01 », ou entrez un objet PSCredential, tel que celui généré par l'applet de commande Get-Credential. Si vous tapez un nom d'utilisateur, vous êtes invité à entrer un mot de passe.
Ce paramètre n'est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Exclude <string[]>
Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Filter <string>
Spécifie un filtre dans le format ou le langage du fournisseur. La valeur de ce paramètre qualifie le paramètre Path. La syntaxe du filtre, notamment l'utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que les autres paramètres, car le fournisseur les applique lors de la récupération des objets, plutôt que de laisser le soin à Windows PowerShell de filtrer les objets une fois qu'ils ont été récupérés.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Force
Permet à l'applet de commande de supprimer une propriété d'un objet qui, sinon, n'est pas accessible par l'utilisateur. L'implémentation est différente d'un fournisseur à l'autre. Pour plus d'informations, consultez about_Providers.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-Include <string[]>
Supprime uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-LiteralPath <string[]>
Spécifie un chemin d'accès à la propriété d'élément. La valeur de -LiteralPath est utilisée exactement telle que vous la tapez. Aucun caractère n'est interprété en tant que caractère générique. Si le chemin d'accès inclut des caractères d'échappement, mettez-le entre des guillemets simples. Les guillemets simples indiquent à Windows PowerShell qu'aucun caractère ne doit être interprété en tant que séquence d'échappement.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Name <string[]>
Spécifie les noms des propriétés à récupérer.
|
Obligatoire ? |
true |
|
Position ? |
2 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie le chemin d'accès à l'élément dont les propriétés sont supprimées. Les caractères génériques sont autorisés.
|
Obligatoire ? |
true |
|
Position ? |
1 |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
|
Accepter les caractères génériques ? |
false |
-Confirm
Vous invite à confirmer l'exécution de la commande.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-WhatIf
Décrit le résultat que vous obtiendriez en exécutant la commande, sans réellement l'exécuter.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
-UseTransaction
Inclut la commande dans la transaction active. Ce paramètre est valide uniquement lorsqu'une transaction est en cours. Pour plus d'informations, consultez about_Transactions.
|
Obligatoire ? |
false |
|
Position ? |
named |
|
Valeur par défaut |
|
|
Accepter l'entrée de pipeline ? |
false |
|
Accepter les caractères génériques ? |
false |
<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.
|
Entrées |
System.String Vous pouvez diriger une chaîne qui contient un chemin d'accès (mais pas un chemin d'accès littéral) vers Remove-ItemProperty. |
|
Sorties |
None Cette applet de commande ne retourne aucune sortie. |
Remarques
Vous pouvez également faire référence à Remove-ItemProperty par son alias intégré, « rp ». Pour plus d'informations, consultez about_Alias.
Dans le fournisseur Registry de Windows PowerShell, les valeurs de Registre sont considérées comme des propriétés d'une clé ou sous-clé de Registre. Vous pouvez utiliser les applets de commande ItemProperty pour gérer ces valeurs.
L'applet de commande Remove-ItemProperty est conçue pour utiliser les données exposées par n'importe quel fournisseur. Pour répertorier les fournisseurs disponibles dans votre session, tapez « Get-PSProvider ». Pour plus d'informations, consultez about_Providers.
Exemple 1
C:\PS>remove-itemproperty -path HKLM:\Software\SmpApplication -name SmpProperty Description ----------- Cette commande supprime la valeur de Registre SmpProperty et ses données de la sous-clé SmpApplication de la clé de Registre HKEY_LOCAL_MACHINE\Software. Comme la commande est émise à partir d'un lecteur de système de fichiers (C:\PS>), elle inclut le chemin d'accès complet de la sous-clé SmpApplication, avec le lecteur HKLM: et la clé Software. Elle utilise le paramètre Name pour identifier la valeur de Registre qui est supprimée.
Exemple 2
C:\PS>set-location HKCU:\Software\MyCompany\MyApp PS HKCU:\Software\MyCompany\MyApp> remove-itemproperty -path . -Name Options -confirm Description ----------- Ces commandes suppriment la valeur de Registre Options ainsi que ses données de la sous-clé MyApp de HKEY_CURRENT_USER\Software\MyCompany. La première commande utilise l'applet de commande Set-Location pour modifier l'emplacement actuel sur le lecteur HKEY_CURRENT_USER (HKCU:) et la sous-clé Software\MyCompany\MyApp. La seconde commande utilise l'applet de commande Remove-Item pour supprimer la valeur de Registre Options et ses données de la sous-clé MyApp. Le paramètre Path étant requis, la commande utilise un point (.) pour indiquer l'emplacement actuel. Elle utilise le paramètre Name pour spécifier la valeur de Registre à supprimer. En outre, elle utilise le paramètre Confirm pour demander la confirmation de l'utilisateur avant la suppression de la valeur.
Exemple 3
C:\PS>get-item -path HKLM:\Software\MyCompany | remove-itemproperty -name NoOfEmployees Description ----------- Cette commande supprime la valeur de Registre NoOfEmployees et ses données de la clé de Registre HKLM\Software\MyCompany. La commande utilise l'applet de commande Get-Item pour obtenir un élément qui représente la clé de Registre. Elle utilise un opérateur de pipeline (|) pour envoyer l'objet à l'applet de commande Remove-ItemProperty. Elle utilise ensuite le paramètre Name de Remove-ItemProperty pour spécifier le nom de la valeur de Registre.
Voir aussi