Get-ChildItem

Módulo:: Microsoft.PowerShell.Management Module

Obtém os itens e itens filho em um ou mais locais especificados.

Sintaxe

Items (Predefinição)

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

LiteralItems

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

Description

O cmdlet Get-ChildItem 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 comando Get-ChildItem inclui os parâmetros Depth ou Recurse, diretórios vazios não são incluídos na saída.

O cmdlet Get-ChildItem foi projetado para trabalhar com os itens expostos por qualquer provedor. Por exemplo, os itens podem ser um arquivo ou diretório do sistema de arquivos, uma seção do Registro ou um armazenamento de certificados. Para listar os provedores disponíveis em sua sessão, use o comando Get-PSProvider. 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 cmdlet Get-ChildItem 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, lista o modo (Atributos), LastWriteTime, o tamanho do arquivo (Length) e o Nome do do item. As letras na propriedade Mode podem ser interpretadas da seguinte forma:

l (hiperligação)
d (diretório)
a (arquivo)
r (somente leitura)
h (oculto)
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 cmdlet Get-ChildItem usa o parâmetro Path para especificar o diretório C:\Test. O parâmetro Name retorna somente 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 cmdlet Get-ChildItem usa o parâmetro Path para especificar C:\Test\*.txt. Path usa o curinga asterisco (*) para especificar todos os arquivos com a extensão de nome de arquivo .txt. O parâmetro Recurse examina o diretório Path e os seus subdiretórios, conforme indicado nos cabeçalhos Directory:. O parâmetro Force exibe arquivos ocultos, como hiddenfile.txt, que têm um modo de 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 cmdlet Get-ChildItem usa o parâmetro Path para especificar o diretório C:\Test. O parâmetro Path inclui um asterisco de coringa no final (*) 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 de nome de arquivo .txt.

Quando o parâmetro Include é usado, o parâmetro Path precisa de um asterisco curinga no final (*) 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 é opcional. O parâmetro Recurse obtém itens do diretório Path e dos 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 cmdlet Get-ChildItem 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á aos subdiretórios do Path parâmetro. 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 do Registro HKLM:\HARDWARE. O caminho da colmeia e o nível superior das chaves do registo 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 HKLM:\HARDWARE chave do Registro. O parâmetro Exclude informa 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 drive Cert: do PowerShell que possui autoridade para assinatura de código.

O cmdlet Get-ChildItem usa o parâmetro Path para especificar o provedor de certificado com a unidade Cert:. 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 unidade Cert:, 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 cmdlet Get-ChildItem 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: Obtendo informações de link físico

No PowerShell 6.2, uma exibição alternativa foi adicionada para obter informações de link físico.

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

Exemplo 10: Saída para sistemas operacionais não Windows

No PowerShell 7.1 em sistemas Unix, o Get-ChildItem fornece saída semelhante ao 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

As novas propriedades que agora fazem parte da saída são:

UnixMode são as permissões de arquivo representadas em um sistema Unix
User é o proprietário do ficheiro
Grupo é o proprietário do grupo
Tamanho é o tamanho do arquivo ou diretório representado em um sistema Unix

Observação

Esse recurso foi movido de experimental para mainstream no PowerShell 7.1.

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

O comando dir 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 LinkTarget do objeto do sistema de arquivos retornado pelo Get-ChildItem e são exibidas na saída padrão.

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

Exemplo 12: Obter o destino do link para um ponto de reanálise do AppX.

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

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

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

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

Parâmetros

-Attributes

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Obtém arquivos e pastas com os atributos especificados. Este parâmetro suporta todos os atributos e permite especificar combinações complexas de atributos.

Por exemplo, para obter ficheiros que não sejam do sistema (não diretórios) encriptados ou comprimidos, escreva:

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

Para localizar arquivos e pastas com atributos comumente usados, use o parâmetro Attributes. Ou, os parâmetros Directory, File, Hidden, ReadOnlye System.

O parâmetro Attributes suporta os seguintes valores:

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

Para obter uma descrição desses atributos, consulte a enumeração FileAttributes.

Para combinar atributos, use os seguintes operadores:

! (NÃO)
+ (E)
, (OU)

Não use espaços entre um operador e seu atributo. Os espaços são aceitos após vírgulas.

Para atributos comuns, use as seguintes abreviaturas:

D (Diretório)
H (Escondido)
R (somente leitura)
S (Sistema)

Propriedades dos parâmetros

Tipo:	FlagsExpression<T>[FileAttributes]
Default value:	None
Valores aceites:	Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-CodeSigningCert

Observação

Esse parâmetro só está disponível no provedor Certificate.

Para obter uma lista de certificados que têm Code Signing no seu valor da propriedade EnhancedKeyUsageList, use o parâmetro CodeSigningCert.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Depth

Esse parâmetro foi adicionado no PowerShell 5.0 e permite controlar a profundidade da recursão. Por padrão, Get-ChildItem exibe o conteúdo do diretório pai. O parâmetro Depth determina o número de níveis de subdiretório incluídos na recursão e exibe o conteúdo.

Por exemplo, -Depth 2 inclui o diretório do parâmetro Path, o primeiro nível de subdiretórios e o segundo nível de subdiretórios. Por padrão, nomes de diretório e nomes de arquivos são incluídos na saída.

Observação

Num computador com Windows, a partir do PowerShell ou cmd.exe, pode apresentar uma visualização gráfica da estrutura de diretórios com o comando tree.com.

Propriedades dos parâmetros

Tipo:	UInt32
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Directory

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Para obter uma lista de diretórios, use o parâmetro Directory ou o parâmetro Attributes com a propriedade Directory. Você pode usar o parâmetro Recurse com Directory.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	anúncio

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DnsName

Observação

Esse parâmetro só está disponível no provedor Certificate.

Especifica um nome de domínio ou padrão de nome a ser correspondido à propriedade DNSNameList dos certificados que o cmdlet obtém. O valor deste parâmetro pode ser Unicode ou ASCII. Os valores Punycode são convertidos em Unicode. Caracteres coringa (*) são permitidos.

Este parâmetro foi reintroduzido no PowerShell 7.1

Propriedades dos parâmetros

Tipo:	DnsNameRepresentation
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-DocumentEncryptionCert

Observação

Esse parâmetro só está disponível no provedor Certificate.

Para conseguir uma lista de certificados que têm Document Encryption no valor da propriedade EnhancedKeyUsageList, use o parâmetro DocumentEncryptionCert.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Eku

Observação

Esse parâmetro só está disponível no provedor Certificate.

Especifica o texto ou um padrão de texto a ser correspondido com a propriedade EnhancedKeyUsageList dos certificados que o cmdlet obtém. Caracteres coringa (*) são permitidos. A propriedade EnhancedKeyUsageList contém o nome amigável e os campos OID do EKU.

Este parâmetro foi reintroduzido no PowerShell 7.1

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Exclude

Especifica uma matriz de um ou mais padrões de cadeia de caracteres que devem corresponder à medida que o cmdlet obtém itens subordinados. Qualquer item correspondente é excluído da saída. Insira um elemento ou padrão de caminho, como *.txt ou A*. Caracteres curinga são aceitos.

Um asterisco no final (*) no parâmetro Path é opcional. Por exemplo, -Path C:\Test\Logs ou -Path C:\Test\Logs\*. Se um asterisco à direita (*) for incluído, o comando recorrerá nos subdiretórios do Path parâmetro. Sem o asterisco (*), o conteúdo do parâmetro de caminho é exibido. Mais detalhes estão incluídos no Exemplo 5 e na seção Notas.

Os parâmetros Incluir e Excluir podem ser usados juntos. No entanto, as exclusões são aplicadas após as inclusões, o que pode afetar a produção final.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-ExpiringInDays

Observação

Esse parâmetro só está disponível no provedor Certificate.

Especifica que o cmdlet só deve retornar certificados que estão expirando dentro ou antes do número especificado de dias. Um valor zero (0) obtém certificados que expiraram.

Este parâmetro foi reintroduzido no PowerShell 7.1

Propriedades dos parâmetros

Tipo:	Int32
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-File

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Para obter uma lista de arquivos, use o parâmetro File. Você pode usar o parâmetro Recurse com o arquivo File.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	af

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Filter

Especifica um filtro para qualificar o parâmetro Path. O provedor FileSystem é o único provedor do PowerShell instalado que oferece suporte a filtros. Os filtros são mais eficientes do que outros parâmetros. O provedor aplica filtro quando o cmdlet obtém os objetos em vez de fazer com que o PowerShell filtre os objetos depois que eles são recuperados. A cadeia de caracteres de filtro é passada para a API .NET para enumerar arquivos. A API suporta apenas os caracteres universais * e ?.

Propriedades dos parâmetros

Tipo:	String
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	1
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-FollowSymlink

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Por padrão, o cmdlet Get-ChildItem exibe links simbólicos para diretórios encontrados durante a recursão, mas não recursa neles. Use o parâmetro FollowSymlink para pesquisar os diretórios que visam esses links simbólicos. O FollowSymlink é um parâmetro dinâmico e é suportado apenas no provedor FileSystem.

Esse parâmetro foi introduzido no PowerShell 6.0.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Force

Permite que o cmdlet obtenha itens que, de outra forma, não poderiam ser acessados pelo usuário, como arquivos ocultos ou do sistema. O parâmetro Force não substitui as restrições de segurança. A implementação varia de acordo com o fornecedor. Para obter mais informações, consulte about_Providers.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Hidden

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Para obter apenas itens ocultos, use o parâmetro Hidden ou o parâmetro Attributes com a propriedade Hidden. Por padrão, Get-ChildItem não exibe itens ocultos. Use o parâmetro Force para obter itens ocultos.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	ah, h

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Include

Especifica uma matriz de um ou mais padrões de cadeia de caracteres que devem corresponder à medida que o cmdlet obtém itens subordinados. Qualquer item correspondente é incluído na saída. Insira um elemento ou padrão de caminho, como "*.txt". Caracteres coringa são permitidos. O parâmetro Include só é efetivo quando o comando inclui o conteúdo de um item, como C:\Windows\*, onde o caractere curinga especifica o conteúdo do diretório C:\Windows.

Os parâmetros Incluir e Excluir podem ser usados juntos. No entanto, as exclusões são aplicadas após as inclusões, o que pode afetar a produção final.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-LiteralPath

Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. As aspas simples instruem o PowerShell a não interpretar nenhum carácter como sequências de escape.

Para obter mais informações, consulte about_Quoting_Rules.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	PSPath, LP

Conjuntos de parâmetros

LiteralItems

Position:	Named
Obrigatório:	True
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-Name

Obtém apenas os nomes dos itens no local. A saída é um objeto string que pode ser enviado pelo pipeline para outros comandos. Os nomes retornados são relativos ao valor do parâmetro Path.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Path

Especifica um caminho para um ou mais locais. Se não for especificado, o local padrão é o diretório atual (.). Curingas são aceitos. Tenha cuidado ao usar o parâmetro Path com o parâmetro Recurse. Para obter mais informações, consulte a seção NOTAS deste artigo.

Propriedades dos parâmetros

Tipo:	String[]
Default value:	Current directory
Suporta carateres universais:	True
NãoMostrar:	False

Conjuntos de parâmetros

Items

Position:	0
Obrigatório:	False
Valor do pipeline:	True
Valor do pipeline por nome de propriedade:	True
Valor dos restantes argumentos:	False

-ReadOnly

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Para obter apenas itens de leitura apenas, use o parâmetro ReadOnly ou o parâmetro Attributes, ou a propriedade ReadOnly.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	Ar

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-Recurse

Obtém os itens nos locais especificados e em todos os itens filho dos locais.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	False
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	s, r

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-SSLServerAuthentication

Observação

Esse parâmetro só está disponível no provedor Certificate.

Para obter uma lista de certificados que têm Server Authentication no valor da propriedade EnhancedKeyUsageList, use o parâmetro SSLServerAuthentication.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

-System

Observação

Esse parâmetro só está disponível no provedor FileSystem.

Obtém apenas arquivos e diretórios do sistema. Para obter apenas ficheiros e pastas do sistema, use o parâmetro System ou o parâmetro Attributes ou a propriedade System.

Propriedades dos parâmetros

Tipo:	SwitchParameter
Default value:	None
Suporta carateres universais:	False
NãoMostrar:	False
Aliases:	como

Conjuntos de parâmetros

(All)

Position:	Named
Obrigatório:	False
Valor do pipeline:	False
Valor do pipeline por nome de propriedade:	False
Valor dos restantes argumentos:	False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.

Entradas

String

Você pode encaminhar uma cadeia de caracteres que contenha um caminho para este cmdlet.

Saídas

AliasInfo

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

X509StoreLocation

X509Store

X509Certificate2

O cmdlet produz estes tipos ao aceder ao drive Cert:.

DictionaryEntry

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

DirectoryInfo

FileInfo

O cmdlet gera esses tipos ao acessar as unidades FileSystem.

FunctionInfo

FilterInfo

O cmdlet produz saídas desses tipos ao acessar as unidades Function:.

RegistryKey

O cmdlet gera este tipo ao aceder aos drives do Registo.

PSVariable

O cmdlet gera este tipo de saída ao aceder às unidades Variable:.

WSManConfigContainerElement

WSManConfigLeafElement

O cmdlet produz saídas desses tipos ao acessar as unidades WSMan:.

String

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

Notas

O PowerShell inclui os seguintes aliases para Get-ChildItem:

Todas as plataformas:
- dir, gci
Windows:
- ls

Comportamento de recursão com o parâmetro Path:

Quando você usa Get-ChildItem -Recurse com o parâmetro Path, o cmdlet procura o último componente de caminho, seja ou não um padrão curinga ou um nome literal.

Se o último componente de caminho corresponder a um subdiretório imediato existente do diretório de destino, o cmdlet executará a enumeração recursiva no diretório correspondente.
Se o último componente de caminho não corresponder a um subdiretório imediato existente do diretório de destino, o cmdlet procurará recursivamente na hierarquia do diretório de destino itens que correspondam ao último componente de caminho

Quando você usa Get-ChildItem -Recurse com o de caminho de e nome parâmetros, o comportamento muda. O comando procura o último componente de caminho entre os itens filho imediatos do diretório de destino.

Se houver uma correspondência entre os itens filho imediatos, o cmdlet executará a enumeração recursiva nos itens correspondentes. A correspondência curinga acontece apenas uma vez, no nível superior do diretório de destino. Os resultados são processados como se tivessem sido passados individualmente para o parâmetro LiteralPath.
Se o último componente de caminho não corresponder a nenhum item no nível superior, ocorrerá um erro.

Você deve evitar usar o parâmetro Path com o parâmetro Recurse. Para melhores resultados:

Use LiteralPath para especificar o diretório de destino para evitar acionar uma pesquisa recursiva para o último componente de caminho.
Use Filtrar ou Incluir parâmetros para especificar padrões curinga ou literais que devem ser pesquisados em todos os níveis da hierarquia do diretório de destino.

Comentários

Esta página foi útil?

Partilhar via

Get-ChildItem

Sintaxe

Items (Predefinição)

LiteralItems

Description

Exemplos

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

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

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

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

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

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

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

Exemplo 8: Obter itens usando o parâmetro Depth

Exemplo 9: Obtendo informações de link físico

Exemplo 10: Saída para sistemas operacionais não Windows

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

Exemplo 12: Obter o destino do link para um ponto de reanálise do AppX.

Parâmetros

-Attributes

Propriedades dos parâmetros

Conjuntos de parâmetros

-CodeSigningCert

Propriedades dos parâmetros

Conjuntos de parâmetros

-Depth

Propriedades dos parâmetros

Conjuntos de parâmetros

-Directory

Propriedades dos parâmetros

Conjuntos de parâmetros

-DnsName

Propriedades dos parâmetros

Conjuntos de parâmetros

-DocumentEncryptionCert

Propriedades dos parâmetros

Conjuntos de parâmetros

-Eku

Propriedades dos parâmetros

Conjuntos de parâmetros

-Exclude

Propriedades dos parâmetros

Conjuntos de parâmetros

-ExpiringInDays

Propriedades dos parâmetros

Conjuntos de parâmetros

-File

Propriedades dos parâmetros

Conjuntos de parâmetros

-Filter

Propriedades dos parâmetros

Conjuntos de parâmetros

-FollowSymlink

Propriedades dos parâmetros

Conjuntos de parâmetros

-Force

Propriedades dos parâmetros

Conjuntos de parâmetros

-Hidden

Propriedades dos parâmetros

Conjuntos de parâmetros

-Include

Propriedades dos parâmetros

Conjuntos de parâmetros

-LiteralPath

Propriedades dos parâmetros

Conjuntos de parâmetros

-Name

Propriedades dos parâmetros

Conjuntos de parâmetros

-Path

Propriedades dos parâmetros

Conjuntos de parâmetros

-ReadOnly

Propriedades dos parâmetros

Conjuntos de parâmetros

-Recurse

Propriedades dos parâmetros

Conjuntos de parâmetros