Compartilhar via

Get-ChildItem

Módulo:
Microsoft.PowerShell.Management Module

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

Sintaxe

Items (Default) 

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

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

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

Os locais são expostos a Get-ChildItem pelos provedores do PowerShell. Um local pode ser um diretório do sistema de arquivos, hive de registro ou um repositório de certificados. Para obter mais informações, consulte about_Providers.

Parâmetros

-Attributes

Obtém arquivos e pastas com os atributos especificados. Esse parâmetro dá suporte a todos os atributos e permite especificar combinações complexas de atributos.

Por exemplo, para obter arquivos que não são do sistema (não diretórios) criptografados ou compactados, digite:

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 atributos dá suporte às seguintes propriedades:

  • Archive
  • Compressed
  • Dispositivo
  • Directory
  • Criptografado
  • Escondido
  • IntegrityStream
  • Normal
  • NoScrubData
  • NotContentIndexed
  • Offline
  • ReadOnly
  • ReparsePoint
  • SparseFile
  • Sistema
  • Temporary

Para obter uma descrição desses atributos, consulte ode 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. Espaços são aceitos após vírgulas.

Para atributos comuns, use as seguintes abreviações:

  • D (Diretório)
  • H (Oculto)
  • R (Somente leitura)
  • S (Sistema)

Propriedades do parâmetro

Tipo:

FlagsExpression<T>[FileAttributes]

Valor padrão:None
Valores aceitos:Archive, Compressed, Device, Directory, Encrypted, Hidden, IntegrityStream, Normal, NoScrubData, NotContentIndexed, Offline, ReadOnly, ReparsePoint, SparseFile, System, Temporary
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Depth

Esse parâmetro foi adicionado ao 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 arquivo são incluídos na saída.

Observação

Em um computador Windows, a partir do PowerShell ou de cmd.exe, você pode exibir uma visualização gráfica da estrutura de diretório com o comando tree.com.

Propriedades do parâmetro

Tipo:UInt32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Directory

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:anúncio, d

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Exclude

Especifica, como uma matriz de cadeia de caracteres, uma propriedade ou propriedade que este cmdlet exclui da operação. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como *.txt ou A*. São aceitos caracteres curinga.

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

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-File

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:af

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Filter

Especifica um filtro para qualificar o parâmetro Path. O provedor FileSystem é o único provedor do PowerShell instalado que dá suporte ao uso de filtros. Os filtros são mais eficientes do que outros parâmetros, pois o provedor os aplica quando o cmdlet obtém os objetos em vez de ter o PowerShell filtrar os objetos depois que eles são recuperados. A cadeia de caracteres de filtro é passada para a API do .NET para enumerar arquivos. Essa API só dá suporte a caracteres curingas * e ?.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:1
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Force

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Hidden

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ah, h

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Include

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor desse parâmetro qualifica o parâmetro Path. Insira um elemento ou padrão de caminho, como "*.txt". Caracteres curinga são permitidos. O parâmetro Include só é eficaz quando o comando inclui o conteúdo de um item, como C:\Windows\*, em que o caractere curinga especifica o conteúdo do diretório C:\Windows.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-LiteralPath

Especifica um caminho para um ou mais locais. O valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere é interpretado como caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.

Para mais informações, consulte sobre_Regras_de_Citação.

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:PSPath

Conjuntos de parâmetros

LiteralItems
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-Name

Obtém apenas os nomes dos itens no local. A saída é um objeto de cadeia de caracteres que pode ser enviado pelo pipeline para outros comandos. Caracteres curinga são permitidos.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Path

Especifica um caminho para um ou mais locais. Você pode usar curingas. O local padrão é o diretório atual (.).

Propriedades do parâmetro

Tipo:

String[]

Valor padrão:Current directory
Dá suporte a curingas:True
DontShow:False

Conjuntos de parâmetros

Items
Cargo:0
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:True
Valor dos argumentos restantes:False

-ReadOnly

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:ar

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Recurse

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:s

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-System

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:as

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-UseTransaction

Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:False
Dá suporte a curingas:False
DontShow:False
Aliases:usetx

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes: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 canalizar uma cadeia de caracteres que contém um caminho para Get-ChildItem.

Saídas

Object

O tipo de objeto que Get-ChildItem retorna é determinado pelos objetos no caminho da unidade do provedor.

String

Se você usar o parâmetro Name, Get-ChildItem retornará os nomes de objeto como cadeias de caracteres.

Observações

  • Você pode consultar Get-ChildItem por seus aliases internos, ls, dire gci. Para obter mais informações, consulte about_Aliases.
  • Get-ChildItem não obtém itens ocultos por padrão. Para obter itens ocultos, use o parâmetro Force.
  • O cmdlet Get-ChildItem foi projetado para trabalhar com os dados expostos por qualquer provedor. Para listar os provedores disponíveis na sessão, digite Get-PSProvider. Para obter mais informações, consulte about_Providers.