Get-ChildItem
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 Get-ChildItem de commande 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 Get-ChildItem commande 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 par Get-ChildItem les fournisseurs PowerShell. Un emplacement peut être un répertoire de système de fichiers, une ruche de Registre ou un magasin de certificats. Certains paramètres sont disponibles uniquement pour un fournisseur spécifique. Pour plus d’informations, consultez about_Providers.
Exemples
Exemple 1 : Obtenir des éléments enfants à partir d’un répertoire de système de fichiers
Cet exemple obtient les éléments enfants à partir d’un répertoire de système de fichiers. Les noms de fichiers et de sous-répertoires sont affichés. Pour les emplacements vides, la commande ne retourne aucune sortie et retourne à l’invite PowerShell.
L’applet Get-ChildItem de commande 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.txtPar défaut Get-ChildItem , répertorie le mode (Attributes), LastWriteTime, la taille de fichier (Length) et le nom de l’élément. Les lettres de la propriété Mode peuvent être interprétées comme suit :
l(lien)d(répertoire)a(archive)r(lecture seule)h(masqué)s(système)
Pour plus d’informations sur les indicateurs de mode, consultez about_Filesystem_Provider.
Exemple 2 : Obtenir des noms d’éléments enfants dans un répertoire
Cet exemple répertorie uniquement les noms d’éléments d’un répertoire.
L’applet Get-ChildItem de commande utilise le paramètre 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.txtExemple 3 : Obtenir des éléments enfants dans le répertoire actif et les sous-répertoires
Cet exemple montre comment afficher .txt les 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.txtL’applet Get-ChildItem de commande utilise le paramètre Path pour spécifier C:\Test\*.txt. Le chemin utilise le caractère générique astérisque (*) pour spécifier tous les fichiers avec l’extension .txtde nom de fichier . Le paramètre Recurse recherche le répertoire Path et ses sous-répertoires, comme indiqué dans les en-têtes Directory : . Le paramètre Force affiche les fichiers masqués tels que hiddenfile.txt ceux qui ont un mode h.
Exemple 4 : Obtenir des éléments enfants à l’aide du paramètre Include
Dans cet exemple Get-ChildItem , le paramètre Include permet de 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.txtL’applet Get-ChildItem de commande utilise le paramètre Path pour spécifier le répertoire C:\Test. Le paramètre Path inclut un caractère générique astérisque (*) de fin pour spécifier le contenu du répertoire.
Le paramètre Include utilise un caractère générique astérisque (*) pour spécifier tous les fichiers avec l’extension .txtde nom de fichier.
Lorsque le paramètre Include est utilisé, le paramètre Path a besoin d’un caractère générique astérisque (*) de fin 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 des éléments enfants à l’aide du paramètre Exclude
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.logL’applet Get-ChildItem de commande 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 qui commencent A par ou a sont exclus de la sortie.
Lorsque le paramètre Exclude 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 du paramètre Exclude . - Si un astérisque de fin (
*) est inclus dans le paramètre Path , la commande récurse dans les sous-répertoires du paramètre Path . Les exceptions sont des noms de noms de fichiers ou de sous-répertoires qui correspondent à la valeur du paramètre Exclude . - Si le paramètre Recurse est ajouté à la commande, la sortie de récursivité est identique si le paramètre Path inclut un astérisque de fin (
*).
Exemple 6 : Obtenir les clés de Registre à partir d’une ruche de Registre
Cet exemple obtient toutes les clés de Registre de HKEY_LOCAL_MACHINE\HARDWARE.
Get-ChildItem utilise le paramètre Path pour spécifier la clé HKLM:\HARDWAREde Registre . Le chemin d’accès et le niveau supérieur des clés de Registre sont affichés dans la console PowerShell.
Pour plus d’informations, consultez 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
RESOURCEMAPLa première commande affiche le contenu de la clé de HKLM:\HARDWARE Registre. Le paramètre Exclude indique Get-ChildItem de ne pas retourner les sous-clés qui commencent par D*. Actuellement, le paramètre Exclude 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 obtient chaque certificat dans le lecteur PowerShell Cert: qui a l’autorité de signature de code.
L’applet Get-ChildItem de commande utilise le paramètre Path pour spécifier le fournisseur de certificats avec le Cert: lecteur. 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 -CodeSigningCertPour plus d’informations sur le fournisseur de certificats et le Cert: lecteur, consultez 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.txtL’applet Get-ChildItem de commande 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 de lien dur
Dans PowerShell 6.2, une autre vue a été ajoutée pour obtenir des informations de lien dur.
Get-ChildItem -Path C:\PathContainingHardLink | Format-Table -View childrenWithHardLinkExemple 10 : Sortie pour les systèmes d’exploitation non Windows
Dans PowerShell 7.1 sur les systèmes Unix, le Get-ChildItem système 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~previousLes nouvelles propriétés qui font désormais partie de la sortie sont les suivantes :
- UnixMode est les autorisations de fichier représentées sur un système Unix
- L’utilisateur est le propriétaire du fichier
- Le groupe est le propriétaire du groupe
- La taille est 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 dir commande 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 sont affichées 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\TempExemple 12 : Obtenir la cible de lien pour un point d’analyse AppX
Cet exemple tente d’obtenir les informations cibles d’un point d’analyse AppX. Les applications du Microsoft Store créent des points d’analyse 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À ce stade, Windows ne fournit pas de moyen d’obtenir les informations cibles d’un point d’analyse 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 les fichiers et les 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 Attributes . Ou, le répertoire des paramètres, fichier, masqué, readOnly et système.
Le paramètre Attributes prend en charge les propriétés suivantes :
- Archive
- Compressed
- Appareil
- Directory
- Chiffré
- Hidden
- IntegrityStream
- Normal
- NoScrubData
- NotContentIndexed
- Hors connexion
- Lecture seule
- RéparsePoint
- SparseFile
- Système
- Temporaire
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(Masqué)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 certificats .
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 du paramètre Path, 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 de 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 Directory ou le paramètre Attributes avec la propriété Directory . 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 certificats .
Spécifie un nom de domaine ou un modèle de nom à mettre en correspondance avec 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 de certificats .
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 disponible uniquement dans le fournisseur de certificats .
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 convivial et les champs OID de la référence 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 plusieurs modèles de chaîne à mettre en correspondance lorsque l’applet de commande obtient des éléments enfants. Tout élément correspondant est exclu de la sortie. Entrez un élément ou un modèle de chemin d’accès, 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 récurse 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 dans le fournisseur de certificats .
Spécifie que l’applet de commande doit uniquement retourner des certificats arrivant à expiration ou avant le nombre de jours spécifié. La valeur zéro (0) obtient 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 * et ? les caractères génériques.
| 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 Get-ChildItem de commande affiche des liens symboliques vers des répertoires trouvés pendant la récursivité, mais ne les récurse pas. Utilisez le paramètre FollowSymlink pour rechercher les répertoires qui ciblent ces liens symboliques. 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 remplace pas les restrictions de sécurité. L’implémentation est différente d’un fournisseur à l’autre. Pour plus d’informations, consultez 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 les é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 plusieurs modèles de chaîne à mettre en correspondance lorsque l’applet de commande obtient des éléments enfants. Tout élément correspondant est inclus dans la sortie. 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 est efficace uniquement lorsque la commande inclut le contenu d’un élément, par C:\Windows\*exemple, où le caractère générique spécifie le contenu du C:\Windows répertoire.
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, consultez 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 |
| 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 certificats .
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 des fichiers système et des dossiers, utilisez la propriété Système de paramètres système ou Attributs.
| 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
Vous pouvez diriger une chaîne qui contient un chemin d’accès à cette applet de commande.
Sorties
L’applet de commande génère ce type lors de l’accès au Alias: lecteur.
L’applet de commande génère ces types lors de l’accès au Cert: lecteur.
L’applet de commande génère ce type lors de l’accès au Env: lecteur.
L’applet de commande génère ces types lors de l’accès aux lecteurs du système de fichiers.
L’applet de commande génère ces types lors de l’accès Function: aux lecteurs.
L’applet de commande génère ce type lors de l’accès aux lecteurs du Registre.
L’applet de commande génère ce type lors de l’accès Variable: aux lecteurs.
L’applet de commande génère ces types lors de l’accès WSMan: aux lecteurs.
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 Get-ChildItem 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, consultez about_Providers.
