Nom du fournisseur

Registry

Lecteurs

HKLM:, HKCU:

Description courte

Donne accès aux clés et valeurs du Registre système à partir de Windows PowerShell.

Description détaillée

Le fournisseur Registry de Windows PowerShell vous permet d'obtenir, d'ajouter, de modifier, d'effacer et de supprimer des clés et valeurs de Registre dans Windows PowerShell.

Les clés de Registre sont représentées comme des instances de la classe Microsoft.Win32.RegistryKey. Les valeurs de Registre sont représentées comme des instances de la classe PSCustomObject.

Le fournisseur Registry vous permet d'accéder à un espace de noms hiérarchique qui se compose de clés et sous-clés de Registre. Les valeurs et données de Registre ne sont pas des composants de cette hiérarchie. Ce sont en fait des propriétés de chacune des clés.

Le fournisseur Registry prend en charge toutes les applets de commande qui contiennent le nom Item (les applets de commande Item), telles que Get-Item, Copy-Item et Rename-Item. Utilisez les applets de commande Item lors de l'utilisation de clés et sous-clés de Registre. Le fournisseur Registry prend également en charge les applets de commande qui contiennent le nom ItemProperty (applets de commande ItemProperty). Utilisez les applets de commande ItemProperty lors de l'utilisation de valeurs et données de Registre. Vous ne pouvez pas utiliser les applets de commande qui contiennent le nom Content (les applets de commande Content) avec le fournisseur Registry.

Chaque clé de Registre est protégée par un descripteur de sécurité. Vous pouvez utiliser Get-Acl pour consulter le descripteur de sécurité d'une clé.

Fonctions

ShouldProcess

Exemples

Navigation dans le Registre

-------------------------- EXEMPLE 1 --------------------------

Cette commande définit la clé de Registre HKEY_LOCAL_MACHINE\Software comme emplacement actuel :

set-location hklm:\software

-------------------------- EXEMPLE 2 --------------------------

Cette commande affiche l'emplacement actuel :

get-location

Gestion des clés de Registre

-------------------------- EXEMPLE 1 --------------------------

Cette commande affiche les informations relatives à chaque sous-clé immédiate de la clé de Registre HKEY_LOCAL_MACHINE\Software.

get-childitem -path hklm:\software

-------------------------- EXEMPLE 2 --------------------------

Cette commande crée la sous-clé TestNew sous la sous-clé HKCU:\Environment :

new-item -path hkcu:\Environment\TestNew

-------------------------- EXEMPLE 3 --------------------------

Cette commande supprime la sous-clé TestNew de la clé HKEY_CURRENT_USER\Environment :

remove-item -path hkcu:\Environment\TestNew

-------------------------- EXEMPLE 4 --------------------------

Cette commande copie la clé TestNew vers une sous-clé TestCopy.

copy-item -path  hkcu:\Environment\TestNew  hkcu:\Environment\TestNew\TestCopy

-------------------------- EXEMPLE 5 --------------------------

Cette commande affiche les informations relatives à toutes les sous-clés de la clé de Registre HKEY_LOCAL_MACHINE\Software :

get-childitem -path hklm:\Software -recurse

-------------------------- EXEMPLE 6 --------------------------

Cette commande déplace la clé de Registre HKEY_CURRENT_USER\Environment\testnewcopy, ses propriétés, ainsi que toutes ses sous-clés et leurs propriétés, vers HKEY_CURRENT_USER\Environment\testnew :

move-item -path hkcu:\environment\testnewcopy `
-destination hkcu:\environment\testnew

-------------------------- EXEMPLE 7 --------------------------

Cette commande renomme la clé de Registre HKEY_CURRENT_USER\Environment\testnew en HKEY_CURRENT_USER\Environment\test :

rename-item -path hkcu:\environment\testnew\ -newname test

-------------------------- EXEMPLE 8 --------------------------

Cette commande affiche le descripteur de sécurité pour l'élément de Registre spécifié :

get-acl -path hkcu:\environment\testnew | format-list -property *

Gestion des entrées de Registre

-------------------------- EXEMPLE 1 --------------------------

Cette commande affiche le nom de la valeur et les données de chaque entrée de Registre contenue dans la clé de Registre HKEY_CURRENT_USER\Environment :

get-itemproperty -path hkcu:\Environment

L'entrée du Registre par défaut n'est retournée que si elle a une valeur.

-------------------------- EXEMPLE 2 --------------------------

Cette commande affiche le nom de la valeur et les données de chaque entrée du Registre Temp contenue dans la clé de Registre HKEY_CURRENT_USER\Environment :

get-itemproperty -path hkcu:\Environment -name Temp

-------------------------- EXEMPLE 3 --------------------------

Cette commande crée l'entrée de Registre nommée « pstest » dans la clé HKEY_CURRENT_USER et lui attribue la valeur « pstestvalue » :

new-itemproperty -path hkcu:\environment -name "pstest" -value "pstestvalue"

-------------------------- EXEMPLE 4 --------------------------

Cette commande met à jour la valeur de l'entrée de Registre pstest en updatedvalue dans la clé HKEY_CURRENT_USER\Environment :

set-itemproperty -path hkcu:\environment -name pstest 
-value "updatedvalue"

-------------------------- EXEMPLE 5 --------------------------

Cette commande renomme la valeur de l'entrée de Registre pstest en pstestnew dans la clé HKEY_CURRENT_USER\Environment :

rename-itemproperty -path hkcu:\environment -name pstest `
-newname pstestnew

-------------------------- EXEMPLE 6 --------------------------

Cette commande copie l'entrée de Registre nommée « pstestnew » de la clé HKEY_CURRENT_USER\Environment vers la clé HKEY_CURRENT_USER\Environment\testnewcopy :

copy-itemproperty -path hkcu:\environment ` 
-destination hkcu:\environment\testnewcopy -name pstestnew

-------------------------- EXEMPLE 7 --------------------------

Cette commande déplace l'entrée du Registre nommée « pstestnew » de la clé HKEY_CURRENT_USER\environment\testnewcopy vers la clé HKEY_CURRENT_USER\environment\testnew :

move-itemproperty -path hkcu:\environment\testnewcopy ' 
-destination hkcu:\environment\testnew -name pstestnew

-------------------------- EXEMPLE 8 --------------------------

Cette commande efface la valeur de l'entrée de Registre nommée « pstestnew » de la clé HKEY_CURRENT_USER\Environment\testnew :

clear-itemproperty -path hkcu:\environment\testnew -name pstestnew

Vous pouvez utiliser l'applet de commande Clear-Item pour effacer la valeur de l'entrée de Registre par défaut correspondant à une sous-clé. Par exemple, la commande suivante efface la valeur de l'entrée par défaut de la clé de Registre HKEY_CURRENT_USER\Environment\testnew : clear-item -path hkcu:\environment\testnew

-------------------------- EXEMPLE 9 --------------------------

Cette commande supprime l'entrée de Registre nommée « pstestnew » de la clé de Registre HKEY_CURRENT_USER\Environment\testnew :

remove-itemproperty -path hkcu:\environment\testnew `
-name pstestnew

-------------------------- EXEMPLE 10 --------------------------

Cette commande met à jour la valeur de l'entrée de Registre par défaut de la clé HKEY_CURRENT_USER\Environment\testnew avec la « valeur par défaut » :

set-itemproperty -path hkcu:\environment\testnew `
-name "(default)" -value "default value"

Vous pouvez également mettre à jour la valeur par défaut d'une clé de Registre en utilisant l'applet de commande Set-Item. Par exemple, la commande suivante met à jour la valeur par défaut de la clé testnew : set-item -path hkcu:\environment\testnew -value « une autre valeur par défaut »

Paramètres dynamiques

Les paramètres dynamiques sont des paramètres d'applet de commande ajoutés par un fournisseur Windows PowerShell et qui sont disponibles uniquement lorsque l'applet de commande est utilisée dans le lecteur du fournisseur.

Type <Microsoft.Win32.RegistryValueKind>

Spécifie les types de données à utiliser lors du stockage de valeurs dans le Registre ou identifie le type de données d'une valeur dans le Registre.

Value Description

String

Spécifie une chaîne terminée par le caractère null. Équivalente à REG_SZ.

ExpandString

Spécifie une chaîne terminée par le caractère null qui contient des références non développées à des variables d'environnement qui sont développées lorsque la valeur est récupérée. Équivalente à REG_EXPAND_SZ.

Binary

Spécifie les données binaires sous n'importe quelle forme. Équivalente à REG_BINARY.

DWord

Spécifie un nombre binaire 32 bits. Équivalente à REG_DWORD.

MultiString

Spécifie un tableau de chaînes terminées par deux caractères null. Équivalente à REG_MULTI_SZ.

QWord

Spécifie un nombre binaire 64 bits. Équivalente à REG_QWORD.

Unknown

Indique un type de données de Registre non pris en charge, tel que REG_RESOURCE_LIST.

Applets de commande prises en charge

Voir aussi



Table des matières