Get-Item
Obtient l’élément à l’emplacement spécifié.
Syntaxe
Path (Par défaut)
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
LiteralPath
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-UseTransaction]
[-Stream <String[]>]
[<CommonParameters>]
Description
L’applet de commande Get-Item obtient l’élément à l’emplacement spécifié.
Il n’obtient pas le contenu de l’élément à l’emplacement, sauf si vous utilisez un caractère générique ('*') pour demander tout le contenu de l’élément.
Cette applet de commande est utilisée par les fournisseurs PowerShell pour parcourir différents types de magasins de données.
Exemples
Exemple 1 : Obtenir le répertoire courant
Cette commande obtient le répertoire actif. Le point ('.') représente l’élément à l’emplacement actuel (et non son contenu).
Get-Item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Exemple 2 : Obtenir tous les éléments du répertoire actif
Cette commande obtient tous les éléments du répertoire actif. Le caractère générique ('*') représente tout le contenu de l’élément actif.
Get-Item *
Directory: C:\ps-test
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 9:29 AM Logs
d---- 7/26/2006 9:26 AM Recs
-a--- 7/26/2006 9:28 AM 80 date.csv
-a--- 7/26/2006 10:01 AM 30 filenoext
-a--- 7/26/2006 9:30 AM 11472 process.doc
-a--- 7/14/2006 10:47 AM 30 test.txt
Exemple 3 : Obtenir le répertoire actuel d’un lecteur
Cette commande obtient le répertoire actuel du lecteur C : . L’objet récupéré représente uniquement le répertoire, et non son contenu.
Get-Item C:\
Exemple 4 : Récupérer des éléments dans le lecteur spécifié
Cette commande obtient les éléments du lecteur C : . Le caractère générique ('*') représente tous les éléments du conteneur, pas seulement le conteneur.
Dans PowerShell, utilisez un seul astérisque ('') pour obtenir le contenu, au lieu dutraditionnel .". Le format est interprété littéralement, de sorte que «.* » ne récupère pas de répertoires ni de noms de fichiers sans point.
Get-Item C:\*
Exemple 5 : Obtenir une propriété dans le répertoire spécifié
Cette commande obtient la propriété LastAccessTime du répertoire « C :\Windows ».
LastAccessTime n’est qu’une seule propriété des répertoires de système de fichiers.
Pour afficher toutes les propriétés d’un répertoire, tapez (Get-Item \<directory-name\>) | Get-Member.
(Get-Item C:\Windows).LastAccessTime
Exemple 6 : Afficher le contenu d’une clé de Registre
Cette commande affiche le contenu de la clé de Registre Microsoft.PowerShell.
Vous pouvez utiliser cette applet de commande avec le fournisseur de Registre PowerShell pour obtenir les clés et les sous-clés de Registre, mais vous devez utiliser l’applet de commande Get-ItemProperty pour obtenir les valeurs et données du Registre.
Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\
Exemple 7 : Obtenir des éléments dans un répertoire qui ont une exclusion
Cette commande obtient des éléments dans le répertoire Windows avec des noms qui incluent un point ('.'), mais ne commencent pas par « w* ». Cette commande ne fonctionne que lorsque le chemin inclut un caractère générique ('*') pour spécifier le contenu de l’élément.
Get-Item c:\Windows\*.* -Exclude "w*"
Paramètres
-Credential
Spécifie un compte d’utilisateur autorisé à effectuer 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 qu’un objet 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.
Avertissement
Ce paramètre n’est pas pris en charge par les fournisseurs installés avec Windows PowerShell.
Propriétés du paramètre
| Type: | PSCredential |
| Valeur par défaut: | Current user |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Exclude
Spécifie, en tant que tableau de chaînes, un élément ou des éléments que cette applet de commande exclut dans l’opération. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément de chemin d’accès ou un modèle, tel que « *.txt». Les caractères génériques sont autorisés.
Le paramètre Exclure est efficace uniquement lorsque la commande inclut le contenu d’un élément, tel que « C :\Windows* », où le caractère générique spécifie le contenu du répertoire « C :\Windows ».
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Filter
Spécifie un filtre dans le format ou la langue du fournisseur. La valeur de ce paramètre qualifie le paramètre Path.
La syntaxe du filtre, y compris l’utilisation de caractères génériques, dépend du fournisseur. Les filtres sont plus efficaces que d’autres paramètres, car le fournisseur les applique lorsque l’applet de commande obtient les objets plutôt que de filtrer les objets après leur récupération.
Propriétés du paramètre
| Type: | String |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Force
Indique que cette applet de commande obtient des éléments qui ne peuvent pas être accessibles autrement, tels que les éléments masqués. L’implémentation varie du fournisseur au fournisseur. Pour plus d’informations, voir about_Providers. Même en utilisant le paramètre Force, l’applet de commande ne peut pas contourner les restrictions de sécurité.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Include
Spécifie, sous la forme d’un tableau de chaînes, un élément ou des éléments inclus dans l’opération. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément de chemin d’accès ou un modèle, tel que « *.txt». Les caractères génériques sont autorisés.
Le paramètre Include
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-LiteralPath
Spécifie un chemin d’accès à l’élément. Contrairement au paramètre Path, la valeur de LiteralPath est utilisée exactement comme elle est tapée. 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 à PowerShell de ne pas interpréter de caractères comme séquences d’échappement.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | PSPath |
Jeux de paramètres
LiteralPath
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Path
Spécifie le chemin d’accès à un élément. Cette applet de commande obtient l’élément à l’emplacement spécifié. Les caractères génériques sont autorisés. Ce paramètre est obligatoire, mais le nom du paramètre (« Path ») est facultatif.
Utilisez un point ('.') pour spécifier l’emplacement actuel. Utilisez le caractère générique ('*') pour spécifier tous les éléments à l’emplacement actuel.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
Path
| Position: | 0 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | True |
| Valeur des arguments restants: | False |
-Stream
Obtient le flux de fichiers NTFS de remplacement spécifié à partir du fichier. Entrez le nom du flux. Les caractères génériques sont pris en charge. Pour obtenir tous les flux, utilisez un astérisque (*). Ce paramètre n’est pas valide sur les dossiers.
Stream est un paramètre dynamique que le fournisseur FileSystem ajoute à l’applet de commande Get-Item. Ce paramètre fonctionne uniquement dans les lecteurs de système de fichiers.
Propriétés du paramètre
| Type: | String[] |
| Valeur par défaut: | No alternate file streams |
| Prend en charge les caractères génériques: | True |
| DontShow: | False |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | 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.
Propriétés du paramètre
| Type: | SwitchParameter |
| Valeur par défaut: | False |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
| Alias: | usetx |
Jeux de paramètres
(All)
| Position: | Named |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
CommonParameters
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.
Entrées
String
Vous pouvez acheminer une chaîne contenant un chemin vers cette applet de commande.
Sorties
Object
Cette applet de commande retourne les objets qu’elle obtient. Le type est déterminé par le type d’objets dans le chemin d’accès.
Notes
Cette applet de commande n’utilise pas de paramètre Recurse, car elle obtient uniquement un élément, et non son contenu.
Pour obtenir le contenu d’un élément de manière récursive, utilisez Get-ChildItem.
Pour parcourir le Registre, utilisez cette applet de commande pour obtenir les clés de Registre et les Get-ItemProperty pour obtenir des valeurs et des données de Registre.
Les valeurs de Registre sont considérées comme des propriétés de la clé de Registre.
Cette applet de commande est conçue 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.