Get-ChildItem

Syntaxe

Items (Par défaut)

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

LiteralItems

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

Description

Paramètres

-Attributes

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
• Appareil
• Directory
• Crypté
• Caché
• IntegrityStream
• Normal
• NoScrubData
• NotContentIndexed
• Hors ligne
• ReadOnly
• ReparsePoint
• SparseFile
• Système
• 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)

Propriétés du paramètre

Jeux de paramètres

-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.

Propriétés du paramètre

Jeux de paramètres

-Directory

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.

Propriétés du paramètre

Jeux de paramètres

-Exclude

Spécifie, en tant que tableau de chaînes, une propriété ou une propriété que cette applet de commande exclut de l’opération. La valeur de ce paramètre qualifie le paramètre Path. 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.

Propriétés du paramètre

Jeux de paramètres

-File

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

Propriétés du paramètre

Jeux de paramètres

-Filter

Spécifie un filtre pour qualifier le paramètre Path. Le fournisseur FileSystem est le seul fournisseur PowerShell installé qui prend en charge l’utilisation de filtres. 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. La chaîne de filtre est transmise à l’API .NET pour énumérer les fichiers. Cette API prend uniquement en charge les caractères génériques * et ?.

Propriétés du paramètre

Jeux de paramètres

-Force

Permet à l’applet de commande d’obtenir des éléments qui ne peuvent pas être accessibles autrement par l’utilisateur, tels que les fichiers masqués ou système. Le paramètre Forcer ne remplace pas les restrictions de sécurité. L’implémentation varie entre les fournisseurs. Pour plus d’informations, voir about_Providers.

Propriétés du paramètre

Jeux de paramètres

-Hidden

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.

Propriétés du paramètre

Jeux de paramètres

-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 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.

Propriétés du paramètre

Jeux de paramètres

-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 la section sur les règles de citation.

Propriétés du paramètre

Jeux de paramètres

-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 caractères génériques sont autorisés.

Propriétés du paramètre

Jeux de paramètres

-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 (.).

Propriétés du paramètre

Jeux de paramètres

-ReadOnly

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

Propriétés du paramètre

Jeux de paramètres

-Recurse

Obtient les éléments aux emplacements spécifiés, de même que dans tous les éléments enfants de ces emplacements.

Propriétés du paramètre

Jeux de paramètres

-System

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

Propriétés du paramètre

Jeux de paramètres

-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

Jeux de paramètres

CommonParameters

Entrées

String

Sorties

Object

String

Notes

Liens associés

• about_Fournisseur_de_Certificat
• À propos des fournisseurs
• à_propos_des_règles_de_citation
• à_propos_du_Fournisseur_de_Registre
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path