Get-ChildItem
Obtient les éléments et les éléments enfants à un ou plusieurs emplacements spécifiés.
Syntaxe
Get-ChildItem [[-Path] <string[]>] [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
Get-ChildItem [-LiteralPath] <string[]> [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
Description
L'applet de commande Get-ChildItem obtient les éléments présents dans un ou plusieurs emplacements spécifiés. Si l'élément est un conteneur, elle obtient les éléments qui se trouvent à l'intérieur du conteneur, appelés éléments enfants. Vous pouvez utiliser le paramètre Recurse pour obtenir les éléments présents dans tous les conteneurs enfants.
L'emplacement peut être un emplacement de système de fichiers (répertoire, par exemple) ou un emplacement exposé par un autre fournisseur (ruche de Registre ou magasin de certificats, par exemple).
Paramètres
-Exclude <string[]>
Omet les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». 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 ? |
2 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Force
Permet à l'applet de commande d'obtenir des éléments, tels que des fichiers cachés ou système qui, sinon, ne sont pas accessibles par l'utilisateur. L'implémentation est différente d'un fournisseur à l'autre. Pour plus d'informations, consultez about_Providers. Même en utilisant le paramètre Force, l'applet de commande ne peut pas remplacer les restrictions de sécurité.
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[]>
Récupère uniquement les éléments spécifiés. La valeur de ce paramètre qualifie le paramètre Path. Entrez un élément ou un modèle de chemin d'accès, tel que « *.txt ». Les caractères génériques sont autorisés.
Le paramètre Include n'a d'effet que si la commande inclut le paramètre Recurse ou si le chemin d'accès mène au contenu d'un répertoire tel que C:\Windows\*, où le caractère générique spécifie le contenu du répertoire C:\Windows.
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 à un ou plusieurs emplacements. Contrairement à Path, 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
Récupère uniquement les noms des éléments à partir des emplacements. Si vous dirigez la sortie de cette commande vers une autre commande, seuls les noms des éléments sont transmis.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
Accepter les caractères génériques ? |
false |
-Path <string[]>
Spécifie un chemin d'accès à un ou plusieurs emplacements. Les caractères génériques sont autorisés. L'emplacement par défaut est le répertoire actif (.).
Obligatoire ? |
false |
Position ? |
1 |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
true (ByValue, ByPropertyName) |
Accepter les caractères génériques ? |
false |
-Recurse
Obtient les éléments aux emplacements spécifiés, de même que dans tous les éléments enfants de ces emplacements.
Recurse n'a d'effet que si le chemin d'accès pointe vers un conteneur doté d'éléments enfants, tel que C:\Windows ou C:\Windows\*. Il n'a aucun effet si le chemin pointe vers un élément n'ayant pas d'éléments enfants, tel que C:\Windows\*.exe.
Obligatoire ? |
false |
Position ? |
named |
Valeur par défaut |
|
Accepter l'entrée de pipeline ? |
false |
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-ChildItem. |
Sorties |
Objet. Type d'objet que Get-ChildItem retourne qui est déterminé par le fournisseur avec lequel il est utilisé. |
Remarques
Vous pouvez également faire référence à Get-ChildItem par ses alias intégrés, « ls », « dir » et « gci ». Pour plus d'informations, consultez about_Aliases.
Par défaut, Get-ChildItem n'obtient pas d'éléments masqués. Pour obtenir ces éléments, utilisez -Force.
L'applet de commande Get-ChildItem 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-childitem
Description
-----------
Cette commande obtient les éléments enfants à l'emplacement actuel. S'il s'agit d'un répertoire de système de fichiers, elle obtient les fichiers et les sous-répertoires du répertoire actif. Si l'élément n'a pas d'éléments enfants, cette commande retourne à l'invite de commandes sans rien afficher.
L'affichage par défaut répertorie le mode (attributs), l'heure de la dernière écriture, la taille du fichier (longueur) et le nom du fichier. Les valeurs valides pour le mode sont d (répertoire), a (archive), r (en lecture seule), h (masqué) et s (système).
Exemple 2
C:\PS>get-childitem . -include *.txt -recurse -force
Description
-----------
Cette commande récupère tous les fichiers .txt présents dans le répertoire actif et ses sous-répertoires. Le point (.) représente le répertoire actif et le paramètre Include spécifie l'extension du nom de fichier. Le paramètre Recurse indique à Windows PowerShell que les objets doivent être récupérés de manière récursive et que l'objet de la commande est le répertoire spécifié et son contenu. Le paramètre force ajoute des fichiers masqués à l'affichage.
Exemple 3
C:\PS>get-childitem c:\windows\logs\* -include *.txt -exclude A*
Description
-----------
Cette commande répertorie les fichiers .txt du sous-répertoire Logs, à l'exception de ceux dont le nom commence par la lettre A. Elle utilise le caractère générique (*) pour indiquer le contenu du sous-répertoire Logs et non le conteneur du répertoire. Comme le paramètre Recurse n'est pas inclus dans la commande, Get-ChildItem n'inclut pas automatiquement le contenu du répertoire. Vous devez par conséquent spécifier ce contenu.
Exemple 4
C:\PS>get-childitem registry::hklm\software
Description
-----------
Cette commande récupère toutes les clés de Registre de la clé HKEY_LOCAL_MACHINE\SOFTWARE dans le Registre sur l'ordinateur local.
Exemple 5
C:\PS>get-childitem -name
Description
-----------
Cette commande récupère uniquement les noms d'éléments dans le répertoire actif.
Exemple 6
C:\PS>get-childitem cert:\. -recurse -codesigningcert
Description
-----------
Cette commande obtient dans le magasin de certificats tous les certificats ayant une autorité de signature de code.
La commande utilise l'applet de commande Get-ChildItem. Le chemin d'accès spécifie le lecteur Cert: exposé par le fournisseur de certificats de Windows PowerShell. La barre oblique inverse (\) spécifie un sous-répertoire du magasin de certificats, tandis que le point (.) représente le répertoire actif, c'est-à-dire le répertoire racine du magasin de certificats. Le paramètre Recurse spécifie une recherche récursive.
Le paramètre CodeSigningCertificate est un paramètre dynamique qui obtient uniquement les certificats ayant une autorité de signature de code. Pour plus d'informations, tapez « get-help certificate ».
Exemple 7
C:\PS>get-childitem * -include *.exe
Description
-----------
Cette commande récupère tous les éléments du répertoire actif dont le nom de fichier est doté de l'extension « .exe ». Le caractère générique (*) représente le contenu du répertoire actif (pas le conteneur). Lors de l'utilisation du paramètre Include sans le paramètre Recurse, le chemin d'accès doit pointer vers le contenu et non un conteneur.