Get-ItemProperty
Obtient les propriétés de l'élément spécifié.
Syntaxe
Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Get-ItemProperty [-Path] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Get-ItemProperty obtient les propriétés des éléments spécifiés. Par exemple, vous pouvez utiliser Get-ItemProperty pour obtenir la valeur de la propriété LastAccessTime d'un objet fichier. Vous pouvez également utiliser Get-ItemProperty pour afficher les entrées du Registre et leurs valeurs.
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. 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 |
-Include <string[]>
Inclut les éléments spécifié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 le nom des propriétés à récupérer.
Obligatoire ? |
false |
Position ? |
2 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie le chemin d'accès aux éléments.
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 |
-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 vers Get-ItemProperty. |
Sorties |
Object Get-ItemProperty retourne un objet pour chaque propriété d'élément qu'il obtient. Le type d'objet dépend de l'objet récupéré. |
Remarques
L'applet de commande Get-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>get-itemproperty C:\Windows
Description
-----------
Cette commande obtient des informations sur le répertoire C:\Windows.
Exemple 2
C:\PS>get-itemproperty C:\Test\Weather.xls | format-list
Description
-----------
Cette commande obtient les propriétés du fichier C:\Test\Weather.xls. Le résultat est dirigé vers l'applet de commande Format-List pour que la sortie soit affichée sous forme de liste.
Exemple 3
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
Description
-----------
Cette commande affiche le nom de la valeur et les données de chacune des entrées contenues dans la sous-clé de Registre CurrentVersion. Notez que la commande requiert l'existence d'un lecteur Windows PowerShell nommé HKLM: qui est mappé à la ruche HKEY_LOCAL_MACHINE du Registre. Par défaut, un lecteur doté de ce nom et de ce mappage est disponible dans Windows PowerShell. Le chemin d'accès à cette sous-clé de Registre peut également être spécifié à l'aide du chemin d'accès suivant, commençant par le nom du fournisseur suivi de deux deux-points :
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.
Exemple 4
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion `
-name "ProgramFilesDir"
Description
-----------
Cette commande obtient le nom de la valeur et les données de l'entrée de Registre ProgramFilesDir figurant dans la sous-clé de Registre CurrentVersion. Cette commande utilise le paramètre Path pour spécifier la sous-clé et le paramètre Name pour spécifier le nom de la valeur de l'entrée.
Exemple 5
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine
ApplicationBase : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad
364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
Description
-----------
Cette commande obtient le nom des valeurs et les données des entrées du Registre figurant dans la clé de Registre PowerShellEngine. Les résultats sont présentés dans l'exemple de sortie suivant.
Exemple 6
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | format-list -property *
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName : Microsoft.PowerShell
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
Path : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned
Description
-----------
Cet exemple montre comment présenter la sortie d'une commande Get-ItemProperty sous forme de liste pour faciliter la lecture des valeurs et des données de Registre et l'interprétation des résultats.
La première commande utilise l'applet de commande Get-ItemProperty pour obtenir les entrées de Registre figurant dans la sous-clé Microsoft.PowerShell. Cette sous-clé stocke les options de l'environnement par défaut de Windows PowerShell. Les résultats sont présentés dans l'exemple de sortie suivant.
La sortie indique deux entrées de Registre : Path et ExecutionPolicy. Lorsqu'une clé de Registre contient moins de cinq entrées, elle s'affiche par défaut dans un tableau, mais sa lecture est souvent plus facile dans une liste.
La deuxième commande utilise la même commande Get-ItemProperty. Mais la commande utilise cette fois-ci un opérateur de pipeline (|) pour envoyer les résultats de la commande à l'applet de commande Format-List. La commande Format-List utilise le paramètre Property ayant la valeur * (tous) pour afficher toutes les propriétés des objets d'une liste. Les résultats sont présentés dans l'exemple de sortie suivant.
La sortie indique les entrées de Registre Path et ExecutionPolicy, ainsi que plusieurs propriétés moins connues de l'objet clé de Registre. Ces autres propriétés, qui commencent par « PS », sont des propriétés d'objets personnalisés Windows PowerShell (objets qui représentent les clés de Registre, par exemple).
Voir aussi
Concepts
about_Providers
Set-ItemProperty
Clear-ItemProperty
Copy-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-ItemProperty
Rename-ItemProperty