Remove-ItemProperty

Remove-ItemProperty
    [-Path] <String[]>
    [-Name] <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-InformationAction <ActionPreference>]
    [-InformationVariable <String>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Remove-ItemProperty
    [-Name] <String[]>
    -LiteralPath <String[]>
    [-Force]
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Credential <PSCredential>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

L’applet de commande Remove-ItemProperty supprime une propriété et sa valeur d’un élément. Vous pouvez l’utiliser pour supprimer les valeurs de Registre et les données qu’ils stockent.

Cette commande supprime la valeur de Registre « SmpProperty » et ses données à partir de la sous-clé « SmpApplication » de la clé de Registre HKEY_LOCAL_MACHINE\Software.

Remove-ItemProperty -Path "HKLM:\Software\SmpApplication" -Name "SmpProperty"

Étant donné que la commande est émise à partir d’un lecteur de système de fichiers (PS C:\>), elle inclut le chemin complet de la sous-clé « SmpApplication », y compris le lecteur, HKLM:et la clé « Software ».

Ces commandes suppriment la valeur de registre « Options » et ses données de la sous-clé « MyApp » de « HKEY_CURRENT_USER\Software\MyCompany ».

PS C:\> Set-Location HKCU:\Software\MyCompany\MyApp
PS HKCU:\Software\MyCompany\MyApp> Remove-ItemProperty -Path . -Name "Options" -Confirm

La première commande utilise la cmdlet Set-Location pour modifier l'emplacement actuel vers le lecteur HKEY_CURRENT_USER (HKCU:) et la sous-clé Software\MyCompany\MyApp.

La deuxième commande utilise Remove-ItemProperty pour supprimer la valeur de registre « Options » et ses données de la sous-clé « MyApp ». Étant donné que chemin d’accès est nécessaire, la commande utilise un point (.) pour indiquer l’emplacement actuel. Le paramètre Confirmer demande une confirmation de l'utilisateur avant de supprimer la valeur.

Cette commande supprime la valeur de Registre « NoOfEmployees » et ses données à partir de la clé de Registre HKLM\Software\MyCompany.

Get-Item -Path HKLM:\Software\MyCompany | Remove-ItemProperty -Name NoOfEmployees

La commande utilise l’applet de commande Get-Item pour obtenir un élément qui représente la clé de Registre. Il utilise un opérateur de pipeline (|) pour envoyer l’objet à Remove-ItemProperty. Ensuite, il utilise le paramètre Name de Remove-ItemProperty pour spécifier le nom de la valeur de Registre.

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Vous pouvez diriger une chaîne qui contient un chemin d’accès, mais pas un chemin littéral, vers cette applet de commande.

Cette applet de commande ne retourne aucune sortie.

PowerShell inclut les alias suivants pour Remove-ItemProperty:

• Toutes les plateformes :

  • rp

• Dans le fournisseur de Registre PowerShell, les valeurs de Registre sont considérées comme des propriétés d’une clé de Registre ou d’une sous-clé de Registre. Vous pouvez utiliser les applets de commande ItemProperty pour gérer ces valeurs.

• Remove-ItemProperty est conçu pour fonctionner avec 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, voir about_Providers.