Get-ChildItem

Sintaxe

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

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

O Get-ChildItem cmdlet obtém os itens em um ou mais locais especificados. Se o item for um contêiner, ele receberá os itens dentro do contêiner, conhecidos como itens filho. Você pode usar o parâmetro Recurse para obter itens em todos os contêineres filho e usar o parâmetro Depth para limitar o número de níveis a serem recorrentes.

Get-ChildItem não exibe diretórios vazios. Quando um Get-ChildItem comando inclui os parâmetros Depth ou Recurse , diretórios vazios não são incluídos na saída.

Os locais são expostos Get-ChildItem pelos provedores do PowerShell. Um local pode ser um diretório do sistema de arquivos, uma seção do Registro ou um armazenamento de certificados. Alguns parâmetros só estão disponíveis para um provedor específico. Para obter mais informações, consulte about_Providers.

Exemplos

Exemplo 1: Obter itens filho de um diretório do sistema de arquivos

Este exemplo obtém os itens filho de um diretório do sistema de arquivos. Os nomes dos arquivos e subdiretórios são exibidos. Para locais vazios, o comando não retorna nenhuma saída e retorna ao prompt do PowerShell.

O Get-ChildItem cmdlet usa o parâmetro Path para especificar o diretório C:\Test. Get-ChildItem exibe os arquivos e diretórios no console do 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

Por padrão Get-ChildItem , lista o modo (Atributos), LastWriteTime, tamanho do arquivo (Length) e o Nome do item. As letras na propriedade Mode podem ser interpretadas da seguinte forma:

• l (ligação)
• d (diretório)
• a (arquivo)
• r (somente leitura)
• h (escondido)
• s (sistema)

Para obter mais informações sobre os sinalizadores de modo, consulte about_Filesystem_Provider.

Exemplo 2: Obter nomes de itens filho em um diretório

Este exemplo lista apenas os nomes dos itens em um diretório.

O Get-ChildItem cmdlet usa o parâmetro Path para especificar o diretório C:\Test. O parâmetro Name retorna apenas os nomes de arquivo ou diretório do caminho especificado. Os nomes retornados são relativos ao valor do parâmetro Path .

Get-ChildItem -Path C:\Test -Name

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

Exemplo 3: Obter itens filho no diretório e subdiretórios atuais

Este exemplo exibe .txt arquivos localizados no diretório atual e seus subdiretórios.

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

O Get-ChildItem cmdlet usa o parâmetro Path para especificar C:\Test\*.txt. Path usa o curinga asterisco (*) para especificar todos os arquivos com a extensão .txtde nome de arquivo . O parâmetro Recurse pesquisa o diretório Path e seus subdiretórios, conforme mostrado nos cabeçalhos Directory: . O parâmetro Force exibe arquivos ocultos, como hiddenfile.txt os que têm um modo h.

Exemplo 4: Obter itens filho usando o parâmetro Include

Neste exemplo, Get-ChildItem usa o parâmetro Include para localizar itens específicos do diretório especificado pelo parâmetro 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

O Get-ChildItem cmdlet usa o parâmetro Path para especificar o diretório C:\Test. O parâmetro Path inclui um curinga de asterisco à direita (*) para especificar o conteúdo do diretório. O parâmetro Include usa um curinga asterisco (*) para especificar todos os arquivos com a extensão .txtde nome de arquivo .

Quando o parâmetro Include é usado, o parâmetro Path precisa de um curinga de asterisco à direita (*) para especificar o conteúdo do diretório. Por exemplo, -Path C:\Test\*.

• Se o parâmetro Recurse for adicionado ao comando, o asterisco à direita (*) no parâmetro Path será opcional. O parâmetro Recurse obtém itens do diretório Path e seus subdiretórios. Por exemplo, -Path C:\Test\ -Recurse -Include *.txt
• Se um asterisco à direita (*) não estiver incluído no parâmetro Path , o comando não retornará nenhuma saída e retornará ao prompt do PowerShell. Por exemplo, -Path C:\Test\.

Exemplo 5: Obter itens filho usando o parâmetro Exclude

A saída do exemplo mostra o conteúdo do diretório C:\Test\Logs. A saída é uma referência para os outros comandos que usam os parâmetros Exclude e 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

O Get-ChildItem cmdlet usa o parâmetro Path para especificar o diretório C:\Test\Logs. O parâmetro Exclude usa o curinga asterisco (*) para especificar quaisquer arquivos ou diretórios que comecem com A ou a sejam excluídos da saída.

Quando o parâmetro Exclude é usado, um asterisco à direita (*) no parâmetro Path é opcional. Por exemplo, -Path C:\Test\Logs ou -Path C:\Test\Logs\*.

• Se um asterisco à direita (*) não estiver incluído no parâmetro Path , o conteúdo do parâmetro Path será exibido. As exceções são nomes de arquivos ou nomes de subdiretórios que correspondem ao valor do parâmetro Exclude .
• Se um asterisco à direita (*) for incluído no parâmetro Path , o comando recorrerá nos subdiretórios do parâmetro Path . As exceções são nomes de arquivos ou nomes de subdiretórios que correspondem ao valor do parâmetro Exclude .
• Se o parâmetro Recurse for adicionado ao comando, a saída de recursão será a mesma, independentemente de o parâmetro Path incluir ou não um asterisco à direita (*).

Exemplo 6: Obter as chaves do Registro de uma seção do Registro

Este exemplo obtém todas as chaves do Registro de HKEY_LOCAL_MACHINE\HARDWARE.

Get-ChildItem usa o parâmetro Path para especificar a chave HKLM:\HARDWAREdo Registro . O caminho da colmeia e o nível superior das chaves do Registro são exibidos no console do PowerShell.

Para obter mais informações, consulte 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

O primeiro comando mostra o conteúdo da chave do HKLM:\HARDWARE Registro. O parâmetro Exclude diz Get-ChildItem para não retornar nenhuma subchave que comece com D*. Atualmente, o parâmetro Exclude só funciona em subchaves, não em propriedades de item.

Exemplo 7: Obter todos os certificados com autoridade de assinatura de código

Este exemplo obtém cada certificado na unidade do PowerShell Cert: que tem autoridade de assinatura de código.

O Get-ChildItem cmdlet usa o parâmetro Path para especificar o provedor de certificado com a Cert: unidade. O parâmetro Recurse pesquisa o diretório especificado por Path e seus subdiretórios. O parâmetro CodeSigningCert obtém apenas certificados que têm autoridade de assinatura de código.

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

Para obter mais informações sobre o provedor de certificado e a Cert: unidade, consulte about_Certificate_Provider.

Exemplo 8: Obter itens usando o parâmetro Depth

Este exemplo exibe os itens em um diretório e seus subdiretórios. O parâmetro Depth determina o número de níveis de subdiretório a serem incluídos na recursão. Diretórios vazios são excluídos da saída.

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

O Get-ChildItem cmdlet usa o parâmetro Path para especificar C:\Parent. O parâmetro Depth especifica dois níveis de recursão. Get-ChildItem exibe o conteúdo do diretório especificado pelo parâmetro Path e os dois níveis de subdiretórios.

Exemplo 9: Obter o destino do link para um ponto de junção

O dir comando no Shell de Comando do Windows mostra o local de destino de um ponto de junção do sistema de arquivos. No PowerShell, essas informações estão disponíveis na propriedade Target do objeto do sistema de arquivos retornado pelo Get-ChildItem.

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

Name     Target
----     ------
tmp      {C:\Users\user1\AppData\Local\Temp}

Exemplo 10: Obter o destino do link para um ponto de análise do AppX

Este exemplo tenta obter as informações de destino para um ponto de análise do AppX. Os aplicativos da Microsoft Store criam pontos de análise do AppX no diretório AppData do usuário.

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

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

No momento, o Windows não fornece uma maneira de obter as informações de destino para um ponto de análise do AppX. As propriedades LinkTarget e LinkType do objeto de sistema de arquivos estão vazias.

Parâmetros

-Attributes

-CodeSigningCert

-Depth

-Directory

-DnsName

-DocumentEncryptionCert

-Eku

-Exclude

-ExpiringInDays

-File

-Filter

-FollowSymlink

-Force

-Hidden

-Include

-LiteralPath

-Name

-Path

-ReadOnly

-Recurse

-SSLServerAuthentication

-System

-UseTransaction

Entradas

String

Você pode canalizar uma cadeia de caracteres que contenha um caminho para esse cmdlet.

Saídas

AliasInfo

O cmdlet gera esse tipo ao acessar a Alias: unidade.

X509StoreLocation

X509Store

X509Certificate2

O cmdlet gera esses tipos ao acessar a Cert: unidade.

DictionaryEntry

O cmdlet gera esse tipo ao acessar a Env: unidade.

DirectoryInfo

FileInfo

O cmdlet gera esses tipos ao acessar as unidades do sistema de arquivos.

FunctionInfo

FilterInfo

O cmdlet gera esses tipos ao acessar as Function: unidades.

RegistryKey

O cmdlet gera esse tipo ao acessar as unidades do Registro.

PSVariable

O cmdlet gera esse tipo ao acessar as Variable: unidades.

WSManConfigContainerElement

WSManConfigLeafElement

O cmdlet gera esses tipos ao acessar as WSMan: unidades.

String

Quando você usa o parâmetro Name , esse cmdlet retorna os nomes de objeto como cadeias de caracteres.

Notas

O Windows PowerShell inclui os seguintes aliases para Get-ChildItem:

• ls
• dir
• gci

Get-ChildItem não recebe itens ocultos por padrão. Para obter itens ocultos, use o parâmetro Force .

O Get-ChildItem cmdlet foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis em sua sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.

Ligações Relacionadas

• about_Certificate_Provider
• about_Providers
• about_Quoting_Rules
• about_Registry_Provider
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path