Get-ChildItem

Module:

Microsoft.PowerShell.Management

Obtient les éléments et les éléments enfants dans un ou plusieurs emplacements spécifiés

Syntaxe

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-CodeSigningCert]
   [-DocumentEncryptionCert]
   [-SSLServerAuthentication]
   [-DnsName <string>]
   [-Eku <string[]>]
   [-ExpiringInDays <int>]
   [<CommonParameters>]

Get-ChildItem
   [[-Path] <string[]>]
   [[-Filter] <string>]
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Get-ChildItem
   [[-Filter] <string>]
   -LiteralPath <string[]>
   [-Include <string[]>]
   [-Exclude <string[]>]
   [-Recurse]
   [-Depth <uint>]
   [-Force]
   [-Name]
   [-Attributes <FlagsExpression[FileAttributes]>]
   [-FollowSymlink]
   [-Directory]
   [-File]
   [-Hidden]
   [-ReadOnly]
   [-System]
   [<CommonParameters>]

Description

L’applet de commande Get-ChildItem obtient les éléments 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 des éléments dans tous les conteneurs enfants et utiliser le paramètre Depth pour limiter le nombre de niveaux à récurser.

Get-ChildItem n’affiche pas de répertoires vides. Lorsqu'une commande Get-ChildItem inclut les paramètres de profondeur ou de récursivité , les répertoires vides ne sont pas inclus dans la sortie.

Les emplacements sont exposés à Get-ChildItem par les fournisseurs PowerShell. Un emplacement peut être un répertoire de système de fichiers, une ruche du Registre ou un magasin de certificats. Certains paramètres sont disponibles uniquement pour un fournisseur spécifique. Pour plus d’informations, voir about_Providers.

Exemples

Exemple 1 : Obtenir des éléments enfants à partir d’un répertoire de système de fichiers

Cet exemple permet d'obtenir les éléments enfants d'un répertoire du système de fichiers. Les noms de fichiers et de sous-répertoires sont affichés. Pour les emplacements vides, la commande ne renvoie aucune sortie et retourne à la requête PowerShell.

L’applet de commande Get-ChildItem utilise le paramètre Path pour spécifier le répertoire C:\Test. Get-ChildItem affiche les fichiers et répertoires dans la console PowerShell.

Get-ChildItem -Path C:\Test

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     08:29                Logs
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a----         2/1/2019     08:43            183 CreateTestFile.ps1
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

Par défaut, Get-ChildItem répertorie le mode (Attributes), LastWriteTime, la taille du fichier (Length) et le nom de l’élément. Les lettres dans la propriété Mode peuvent être interprétées comme suit :

• l (lien)
• d (répertoire)
• a (archive)
• r (en lecture seule)
• h (caché)
• s (système)

Pour plus d’informations sur les indicateurs de mode, consultez about_Filesystem_Provider.

Exemple 2 : Obtenir les noms des éléments enfants dans un répertoire

Cet exemple répertorie uniquement les noms d’éléments d’un répertoire.

L’applet de commande Get-ChildItem utilise le paramètre de Path pour spécifier le répertoire C:\Test. Le paramètre Name retourne uniquement les noms de fichiers ou de répertoires du chemin d’accès spécifié. Les noms retournés sont relatifs à la valeur du paramètre Path.

Get-ChildItem -Path C:\Test -Name

Logs
anotherfile.txt
Command.txt
CreateTestFile.ps1
ReadOnlyFile.txt

Exemple 3 : Obtenir les éléments enfants dans le répertoire actuel et ses sous-répertoires

Cet exemple montre comment afficher .txt fichiers situés dans le répertoire actif et ses sous-répertoires.

Get-ChildItem -Path .\*.txt -Recurse -Force

Directory: C:\Test\Logs\Adirectory

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile4.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile4.txt

    Directory: C:\Test\Logs\Backup

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 ATextFile.txt
-a----        2/12/2019     15:50             20 LogFile3.txt

    Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/12/2019     16:16             20 Afile.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt

    Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-a-h--        2/12/2019     15:52             22 hiddenfile.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

L’applet de commande Get-ChildItem utilise le paramètre Path pour spécifier C:\Test\*.txt. Path utilise le caractère générique astérisque (*) pour spécifier tous les fichiers avec l’extension de nom de fichier .txt. Le paramètre Recurse permet d'effectuer une recherche dans le répertoire Path et ses sous-répertoires, comme indiqué dans les en-têtes Directory : Le paramètre Force affiche les fichiers cachés, tels que hiddenfile.txt, dont le mode est h.

Exemple 4 : Obtenir les éléments enfants à l'aide du paramètre Include

Dans cet exemple, Get-ChildItem utilise le paramètre Include pour rechercher des éléments spécifiques à partir du répertoire spécifié par le paramètre Path.

# When using the -Include parameter, if you don't include an asterisk in the path
# the command returns no output.
Get-ChildItem -Path C:\Test\ -Include *.txt



Get-ChildItem -Path C:\Test\* -Include *.txt

Directory: C:\Test

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
-a----        2/13/2019     08:55             26 anotherfile.txt
-a----        2/12/2019     15:40         118014 Command.txt
-ar---        2/12/2019     14:31             27 ReadOnlyFile.txt

L’applet de commande Get-ChildItem utilise le paramètre Path pour spécifier le répertoire C:\Test. Le paramètre Path inclut un caractère générique sous forme d'astérisque (*) pour spécifier le contenu du répertoire. Le paramètre Include utilise un astérisque comme caractère générique (*) pour spécifier tous les fichiers avec l’extension .txt.

Lorsque le paramètre Include est utilisé, le paramètre Path a besoin d’un astérisque de fin (*) générique pour spécifier le contenu du répertoire. Par exemple, -Path C:\Test\*.

• Si le paramètre Recurse est ajouté à la commande, l’astérisque de fin (*) dans le paramètre Path est facultatif. Le paramètre Recurse obtient les éléments du répertoire Path et de ses sous-répertoires. Par exemple, -Path C:\Test\ -Recurse -Include *.txt
• Si un astérisque de fin (*) n’est pas inclus dans le paramètre Path, la commande ne retourne aucune sortie et retourne à l’invite PowerShell. Par exemple, -Path C:\Test\.

Exemple 5 : Obtenir les éléments enfants à l'aide du paramètre Exclure

La sortie de l’exemple affiche le contenu du répertoire C:\Test\Logs. La sortie est une référence pour les autres commandes qui utilisent les paramètres Exclude et Recurse.

Get-ChildItem -Path C:\Test\Logs

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Adirectory
d-----        2/15/2019     08:28                AnEmptyDirectory
d-----        2/15/2019     13:21                Backup
-a----        2/12/2019     16:16             20 Afile.txt
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

Get-ChildItem -Path C:\Test\Logs\* -Exclude A*

Directory: C:\Test\Logs

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/15/2019     13:21                Backup
-a----        2/13/2019     13:26             20 LogFile1.txt
-a----        2/12/2019     16:24             23 systemlog1.log

L’applet de commande Get-ChildItem utilise le paramètre Path pour spécifier le répertoire C:\Test\Logs. Le paramètre Exclude utilise le caractère générique astérisque (*) pour spécifier les fichiers ou répertoires commençant par A ou a sont exclus de la sortie.

Lorsque le paramètre Exclure est utilisé, un astérisque de fin (*) dans le paramètre Path est facultatif. Par exemple, -Path C:\Test\Logs ou -Path C:\Test\Logs\*.

• Si un astérisque de fin (*) n’est pas inclus dans le paramètre Path, le contenu du paramètre Path s’affiche. Les exceptions sont des noms de noms de fichiers ou de sous-répertoires qui correspondent à la valeur de Exclure paramètre.
• Si un astérisque de fin (*) est inclus dans le paramètre de chemin , la commande s'exécute de manière récursive dans les sous-répertoires du paramètre de chemin . Les exceptions sont des noms de noms de fichiers ou de sous-répertoires qui correspondent à la valeur de Exclure paramètre.
• Si le paramètre Recurse est ajouté à la commande, le résultat de la récursion est le même que le paramètre Path inclue ou non un astérisque de fin (*).

Exemple 6 : Obtenir les clés de registre à partir d’une ruche de registre

Cet exemple récupère toutes les clés de registre de HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem utilise le paramètre chemin pour spécifier la clé de registre HKLM:\HARDWARE. Le chemin du répertoire de stockage et le niveau supérieur des clés de registre sont affichés dans la console PowerShell.

Pour plus d'informations, voir about_Registry_Provider.

Get-ChildItem -Path HKLM:\HARDWARE

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name             Property
----             --------
ACPI
DESCRIPTION
DEVICEMAP
RESOURCEMAP
UEFI

Get-ChildItem -Path HKLM:\HARDWARE -Exclude D*

Hive: HKEY_LOCAL_MACHINE\HARDWARE

Name                           Property
----                           --------
ACPI
RESOURCEMAP

La première commande affiche le contenu de la clé de Registre HKLM:\HARDWARE. Le paramètre Exclure indique Get-ChildItem de ne pas retourner de sous-clés qui commencent par D*. Actuellement, le paramètre Exclure fonctionne uniquement sur les sous-clés, et non sur les propriétés d’élément.

Exemple 7 : Obtenir tous les certificats avec l’autorité de signature de code

Cet exemple permet d'obtenir chaque certificat dans le lecteur PowerShell Cert: qui a une autorité de signature de code.

L’applet de commande Get-ChildItem utilise le paramètre Path pour spécifier le fournisseur de certificats avec le lecteur Cert:. Le paramètre Recurse recherche le répertoire spécifié par Path et ses sous-répertoires. Le paramètre CodeSigningCert obtient uniquement les certificats qui ont une autorité de signature de code.

Get-ChildItem -Path Cert:\* -Recurse -CodeSigningCert

Pour plus d'informations sur le fournisseur de certificats et le lecteur Cert:, voir about_Certificate_Provider.

Exemple 8 : Obtenir des éléments à l’aide du paramètre Depth

Cet exemple montre comment afficher les éléments d’un répertoire et de ses sous-répertoires. Le paramètre Depth détermine le nombre de niveaux de sous-répertoire à inclure dans la récursivité. Les répertoires vides sont exclus de la sortie.

Get-ChildItem -Path C:\Parent -Depth 2

Directory: C:\Parent

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level1
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:24                SubDir_Level2
-a----        2/13/2019     08:55             26 file.txt

    Directory: C:\Parent\SubDir_Level1\SubDir_Level2

Mode                LastWriteTime         Length Name
----                -------------         ------ ----
d-----        2/14/2019     10:22                SubDir_Level3
-a----        2/13/2019     08:55             26 file.txt

L’applet de commande Get-ChildItem utilise le paramètre Path pour spécifier C:\Parent. Le paramètre Depth spécifie deux niveaux de récursivité. Get-ChildItem affiche le contenu du répertoire spécifié par le paramètre Path et les deux niveaux de sous-répertoires.

Exemple 9 : Obtention d'informations sur le lien dur

Dans PowerShell 6.2, une autre vue a été ajoutée pour obtenir des informations sur les liens durs.

Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLink

Exemple 10 : Sortie pour les systèmes d’exploitation non Windows

Dans PowerShell 7.1 sur les systèmes Unix, le Get-ChildItem fournit une sortie de type Unix :

PS> Get-ChildItem /etc/r*

Directory: /etc

UnixMode   User Group    LastWriteTime Size Name
--------   ---- -----    ------------- ---- ----
drwxr-xr-x root wheel  9/30/2019 19:19  128 racoon
-rw-r--r-- root wheel  9/26/2019 18:20 1560 rc.common
-rw-r--r-- root wheel  7/31/2017 17:30 1560 rc.common~previous
-rw-r--r-- root wheel  9/27/2019 20:34 5264 rc.netboot
lrwxr-xr-x root wheel  11/8/2019 15:35   22 resolv.conf -> /private/var/run/resolv.conf
-rw-r--r-- root wheel 10/23/2019 17:41    0 rmtab
-rw-r--r-- root wheel 10/23/2019 17:41 1735 rpc
-rw-r--r-- root wheel  7/25/2017 18:37 1735 rpc~previous
-rw-r--r-- root wheel 10/23/2019 18:42  891 rtadvd.conf
-rw-r--r-- root wheel  8/24/2017 21:54  891 rtadvd.conf~previous

Les nouvelles propriétés qui font désormais partie de la sortie sont les suivantes :

• UnixMode sont les autorisations de fichier telles que représentées sur un système Unix
• L'utilisateur est le propriétaire du fichier
• groupe est le propriétaire du groupe
• Taille correspond à la taille du fichier ou du répertoire tel qu’il est représenté sur un système Unix

Remarque

Cette fonctionnalité a été déplacée d’expérimentale à standard dans PowerShell 7.1.

Exemple 11 : Obtenir la cible de liaison pour un point de jonction

La commande dir dans l’interpréteur de commandes Windows affiche l’emplacement cible d’un point de jonction de système de fichiers. Dans PowerShell, ces informations sont disponibles à partir de la propriété LinkTarget de l’objet de système de fichiers retourné par Get-ChildItem et s’affiche dans la sortie par défaut.

PS D:\> New-Item -ItemType Junction -Name tmp -Target $env:TEMP
PS D:\> Get-ChildItem | Select-Object name, LinkTarget

Name     LinkTarget
----     ----------
tmp      C:\Users\user1\AppData\Local\Temp

PS D:\> Get-ChildItem

    Directory: D:\

Mode          LastWriteTime    Length Name
----          -------------    ------ ----
l----   12/16/2021  9:29 AM           tmp -> C:\Users\user1\AppData\Local\Temp

Exemple 12 : Obtenir la cible du lien pour un point AppX reparse

Cet exemple tente d'obtenir les informations sur la cible d'un point AppX reparse. Les applications Microsoft Store créent des points de repli AppX dans le répertoire AppData de l'utilisateur.

Get-ChildItem ~\AppData\Local\Microsoft\WindowsApps\MicrosoftEdge.exe |
    Select-Object Mode, LinkTarget, LinkType, Name

Mode  LinkTarget LinkType Name
----  ---------- -------- ----
la---                     MicrosoftEdge.exe

À l'heure actuelle, Windows ne permet pas d'obtenir les informations relatives à la cible d'un point de reparsage AppX. Les propriétés LinkTarget et LinkType de l’objet de système de fichiers sont vides.

Paramètres

-Attributes

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Obtient des fichiers et des dossiers avec les attributs spécifiés. Ce paramètre prend en charge tous les attributs et vous permet de spécifier des combinaisons complexes d’attributs.

Par exemple, pour obtenir des fichiers non système (et non des répertoires) chiffrés ou compressés, tapez :

Get-ChildItem -Attributes !Directory+!System+Encrypted, !Directory+!System+Compressed

Pour rechercher des fichiers et des dossiers avec des attributs couramment utilisés, utilisez le paramètre Attributs. Ou, les paramètres répertoire, fichier, masqué, lectureSeuleet système.

Le paramètre Attributes prend en charge les propriétés suivantes :

• Archive
• Compressed
• Device
• Directory
• Encrypted
• Hidden
• IntegrityStream
• Normal
• NoScrubData
• NotContentIndexed
• Offline
• ReadOnly
• ReparsePoint
• SparseFile
• System
• Temporary

Pour obtenir une description de ces attributs, consultez l’énumération FileAttributes.

Pour combiner des attributs, utilisez les opérateurs suivants :

• ! (NOT)
• + (AND)
• , (OR)

N'utilisez pas d'espaces entre un opérateur et son attribut. Les espaces sont acceptés après les virgules.

Pour les attributs courants, utilisez les abréviations suivantes :

• D (Répertoire)
• H (caché)
• R (Lecture seule)
• S (Système)

Type:	FlagsExpression<T>[FileAttributes]
Valeurs acceptées:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-CodeSigningCert

Remarque

Ce paramètre est disponible uniquement dans le fournisseur de certificat.

Pour obtenir la liste des certificats qui ont Code Signing dans leur valeur de propriété EnhancedKeyUsageList, utilisez le paramètre CodeSigningCert.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Depth

Ce paramètre a été ajouté dans PowerShell 5.0 et vous permet de contrôler la profondeur de récursivité. Par défaut, Get-ChildItem affiche le contenu du répertoire parent. Le paramètre Depth détermine le nombre de niveaux de sous-répertoire inclus dans la récursivité et affiche le contenu.

Par exemple, -Depth 2 inclut le répertoire Path paramètre, le premier niveau des sous-répertoires et le deuxième niveau de sous-répertoires. Par défaut, les noms de répertoires et les noms de fichiers sont inclus dans la sortie.

Remarque

Sur un ordinateur Windows à partir de PowerShell ou cmd.exe, vous pouvez afficher une vue graphique d’une structure de répertoires avec la commande tree.com.

Type:	UInt32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Directory

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Pour obtenir la liste des répertoires, utilisez le paramètre répertoire ou les attributs avec la propriété répertoire. Vous pouvez utiliser le paramètre Recurse avec Directory.

Type:	SwitchParameter
Alias:	ad
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-DnsName

Remarque

Ce paramètre est disponible uniquement dans le fournisseur de certificat .

Spécifie un nom de domaine ou un modèle de nom correspondant à la propriété DNSNameList des certificats que l’applet de commande obtient. La valeur de ce paramètre peut être Unicode ou ASCII. Les valeurs Punycode sont converties en Unicode. Les caractères génériques (*) sont autorisés.

Ce paramètre a été réintroduite dans PowerShell 7.1

Type:	DnsNameRepresentation
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

-DocumentEncryptionCert

Remarque

Ce paramètre est disponible uniquement dans le fournisseur du Certificat .

Pour obtenir la liste des certificats qui ont Document Encryption dans leur valeur de propriété EnhancedKeyUsageList, utilisez le paramètre DocumentEncryptionCert.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Eku

Remarque

Ce paramètre est uniquement disponible dans le fournisseur de certificat .

Spécifie du texte ou un modèle de texte à mettre en correspondance avec la propriété EnhancedKeyUsageList des certificats que l’applet de commande obtient. Les caractères génériques (*) sont autorisés. La propriété EnhancedKeyUsageList contient le nom amical et les champs OID de l'EKU.

Ce paramètre a été réintroduite dans PowerShell 7.1

Type:	String
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

-Exclude

Spécifie un tableau d'un ou de plusieurs modèles de chaînes à comparer lorsque la cmdlet obtient des éléments enfants. Tout élément correspondant est exclu de la sortie. Saisissez un élément de chemin d'accès ou un motif, tel que *.txt ou A*. Les caractères génériques sont acceptés.

Un astérisque de fin (*) dans le paramètre Path est facultatif. Par exemple, -Path C:\Test\Logs ou -Path C:\Test\Logs\*. Si un astérisque de fin (*) est inclus, la commande s'exécute de manière récursive dans les sous-répertoires du paramètre Path. Sans astérisque (*), le contenu du paramètre Path s’affiche. Vous trouverez plus d’informations dans l’exemple 5 et la section Notes.

Les paramètres Include et Exclude peuvent être utilisés ensemble. Toutefois, les exclusions sont appliquées après les inclusions, ce qui peut affecter la sortie finale.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

-ExpiringInDays

Remarque

Ce paramètre est disponible uniquement chez le fournisseur de certificat .

Spécifie que l’applet de commande doit uniquement retourner des certificats arrivant à expiration ou avant le nombre de jours spécifié. Une valeur de zéro (0) récupère les certificats qui ont expiré.

Ce paramètre a été réintroduite dans PowerShell 7.1

Type:	Int32
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-File

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Pour obtenir la liste des fichiers, utilisez le paramètre File. Vous pouvez utiliser le paramètre Recurse avec File.

Type:	SwitchParameter
Alias:	af
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Filter

Spécifie un filtre pour qualifier le paramètre Path. Le fournisseur FileSystem est le seul fournisseur PowerShell installé qui prend en charge les filtres. Les filtres sont plus efficaces que les autres paramètres. Le fournisseur applique un filtre lorsque l’applet de commande obtient les objets plutôt que d’avoir PowerShell à filtrer les objets après leur récupération. La chaîne de filtre est transmise à l’API .NET pour énumérer les fichiers. L’API prend uniquement en charge les caractères génériques * et ?.

Type:	String
Position:	1
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

-FollowSymlink

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Par défaut, l’applet de commande Get-ChildItem affiche des liens symboliques vers des répertoires trouvés lors de la récursivité, mais ne les récurse pas. Utilisez le paramètre FollowSymlink pour rechercher les répertoires qui ciblent ces liens symboliques. Le FollowSymlink est un paramètre dynamique et est pris en charge uniquement dans le fournisseur FileSystem.

Ce paramètre a été introduit dans PowerShell 6.0.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
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 qui ne peuvent pas être accessibles par l’utilisateur, tels que les fichiers masqués ou système. Le paramètre Force ne contourne pas les restrictions de sécurité. L’implémentation varie entre les fournisseurs. Pour plus d’informations, voir about_Providers.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Hidden

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Pour obtenir uniquement les éléments masqués, utilisez le paramètre Hidden ou le paramètre Attributes avec la propriété Hidden. Par défaut, Get-ChildItem n’affiche pas les éléments masqués. Utilisez le paramètre Force pour obtenir des éléments masqués.

Type:	SwitchParameter
Alias:	ah, h
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Include

Spécifie un tableau d'un ou de plusieurs modèles de chaînes à comparer lorsque la cmdlet obtient des éléments enfants. Tout élément correspondant est inclus dans la sortie. Saisissez un élément de chemin ou un modèle, tel que "*.txt". Les caractères génériques sont autorisés. Le paramètre Include n’est effectif que 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.

Les paramètres Include et Exclude peuvent être utilisés ensemble. Toutefois, les exclusions sont appliquées après les inclusions, ce qui peut affecter la sortie finale.

Type:	String[]
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	True

-LiteralPath

Spécifie un chemin d’accès à un ou plusieurs emplacements. La valeur de LiteralPath est utilisée exactement comme elle est typé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.

Pour plus d'informations, voir about_Quoting_Rules.

Type:	String[]
Alias:	PSPath, LP
Position:	Named
Valeur par défaut:	None
Obligatoire:	True
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	False

-Name

Obtient uniquement les noms des éléments dans l’emplacement. La sortie est un objet de chaîne qui peut être envoyé vers le bas du pipeline vers d’autres commandes. Les noms retournés sont relatifs à la valeur du paramètre Path.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-Path

Spécifie un chemin d’accès à un ou plusieurs emplacements. Les caractères génériques sont acceptés. L’emplacement par défaut est le répertoire actif (.).

Type:	String[]
Position:	0
Valeur par défaut:	Current directory
Obligatoire:	False
Accepter l'entrée de pipeline:	True
Accepter les caractères génériques:	True

-ReadOnly

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Pour obtenir uniquement des éléments en lecture seule, utilisez le paramètre ReadOnly ou la propriété ReadOnly du paramètre Attributes.

Type:	SwitchParameter
Alias:	ar
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
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.

Type:	SwitchParameter
Alias:	s, r
Position:	Named
Valeur par défaut:	False
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-SSLServerAuthentication

Remarque

Ce paramètre est disponible uniquement dans le fournisseur de certificat .

Pour obtenir la liste des certificats qui ont Server Authentication dans leur valeur de propriété EnhancedKeyUsageList, utilisez le paramètre SSLServerAuthentication.

Type:	SwitchParameter
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

-System

Remarque

Ce paramètre est disponible uniquement dans le fournisseur FileSystem.

Obtient uniquement les fichiers système et les répertoires. Pour obtenir uniquement les fichiers et dossiers système, utilisez le paramètre System ou la propriété System du paramètre Attributes.

Type:	SwitchParameter
Alias:	as
Position:	Named
Valeur par défaut:	None
Obligatoire:	False
Accepter l'entrée de pipeline:	False
Accepter les caractères génériques:	False

Entrées

String

Vous pouvez acheminer une chaîne contenant un chemin vers ce cmdlet.

Sorties

AliasInfo

La cmdlet produit ce type de sortie lorsqu'elle accède au lecteur Alias:.

X509StoreLocation

X509Store

X509Certificate2

La cmdlet produit ce type de sortie lorsqu'elle accède au lecteur Cert:.

DictionaryEntry

La cmdlet produit ce type lors de l'accès au lecteur Env:.

DirectoryInfo

FileInfo

La cmdlet affiche ces types lors de l'accès aux lecteurs Filesystem.

FunctionInfo

FilterInfo

La cmdlet affiche ces types lors de l'accès aux lecteurs Function:.

RegistryKey

La cmdlet affiche ce type lors de l'accès aux lecteurs Registry.

PSVariable

La cmdlet affiche ce type lors de l'accès aux lecteurs Variable:.

WSManConfigContainerElement

WSManConfigLeafElement

La cmdlet produit ces types lors de l'accès aux lecteurs WSMan:.

String

Lorsque vous utilisez le paramètre Name, cette applet de commande retourne les noms d’objets sous forme de chaînes.

Notes

PowerShell inclut les alias suivants pour Get-ChildItem:

• Toutes les plateformes :
  • dir, gci
• Windows:
  • ls

Get-ChildItem n’obtient pas les éléments masqués par défaut. Pour obtenir des éléments masqués, utilisez le paramètre force.

L’applet de commande Get-ChildItem 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.

Liens associés

• about_Certificate_Provider
• à propos des Fournisseurs
• à_propos_des_règles_de_citation
• about_Registry_Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path