NOM
Get-ItemProperty
RÉSUMÉ
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'utili
sateur 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 [<SwitchParameter>]
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, WarningAction, WarningVariable,
OutBuffer et OutVariable. Pour plus d'informations, tapez
« get-help about_commonparameters ».
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é.
NOTES
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=31bf38
56ad
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 -pro
perty *
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\M
icro
soft.PowerShell
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Softwar\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).
LIENS CONNEXES
Online version: http://go.microsoft.com/fwlink/?LinkID=113320
about_Providers
Set-ItemProperty
Clear-ItemProperty
Copy-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-ItemProperty
Rename-ItemProperty
Aucun commentaire:
Enregistrer un commentaire