Get-ChildItem
Obtém os itens e os itens filhos em um ou mais locais especificados.
Sintaxe
Get-ChildItem [[-Path] <string[]>] [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
Get-ChildItem [-LiteralPath] <string[]> [[-Filter] <string>] [-Exclude <string[]>] [-Force] [-Include <string[]>] [-Name] [-Recurse] [-UseTransaction] [<CommonParameters>]
Descrição
O cmdlet Get-ChildItem obtém os itens em um ou mais locais especificados. Se o item for um contêiner, ele obterá os itens que estão dentro desse contêiner, conhecidos como itens filhos. Você pode usar o parâmetro Recurse para obter itens em todos os contêineres filho.
Um local pode ser um local no sistema de arquivos, como um diretório, ou um local exporto por outro provedor, como um hive do Registro ou um repositório de certificados.
Parâmetros
-Exclude <string[]>
Omite os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um elemento ou padrão do caminho, como "*.txt". Os caracteres curinga são permitidos.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Filter <string>
Especifica um filtro no formato ou no idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path. A sintaxe do filtro, incluindo o uso dos caracteres curinga, depende do provedor. Os filtros são mais eficientes do que outros parâmetros porque o provedor os aplica durante a recuperação dos objetos, em vez de fazer com que o Windows PowerShell os filtre depois de recuperados.
Necessário? |
false |
Posição? |
2 |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Force
Permite que o cmdlet obtenha itens que não podem ser acessados de outra forma pelo usuário, como arquivos do sistema ou ocultos. A implementação varia de provedor para provedor. Para obter mais informações, consulte about_Providers. Mesmo usando o parâmetro Force, o cmdlet não pode substituir as restrições de segurança.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Include <string[]>
Recupera apenas os itens especificados. O valor desse parâmetro qualifica o parâmetro Path. Digite um padrão ou elemento do caminho, como "*.txt". Os caracteres curinga são permitidos.
O parâmetro Include tem efeito somente quando o comando inclui o parâmetro Recurse ou quando o caminho leva até o conteúdo de um diretório, como C:\Windows\*, onde o caractere curinga especifica o conteúdo do diretório C:\Windows.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-LiteralPath <string[]>
Especifica o caminho para um ou mais locais. Ao contrário de Path, o valor de LiteralPath é usado exatamente como é digitado. Nenhum caractere será interpretado como curinga. Se o caminho incluir caracteres de escape, coloque-os entre aspas simples. As aspas simples dizem ao Windows PowerShell para não interpretar quaisquer caracteres que tenham sequências de escape.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Name
Recupera somente os nomes dos itens que estão nos locais. Se você enviar a saída desse comando para outro comando, somente os nomes dos itens serão enviados.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-Path <string[]>
Especifica o caminho para um ou mais locais. Os caracteres curinga são permitidos. O local padrão é o diretório atual (.).
Necessário? |
false |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Recurse
Obtém os itens que estão nos locais especificados e em todos os itens filhos desses locais.
Recurse funciona somente quando o caminho aponta para um contêiner que tenha itens filhos, como C:\Windows ou C:\Windows\*, e nunca quando aponta para itens sem itens filhos, como C:\Windows\*.exe.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
-UseTransaction
Inclui o comando na transação ativa. Este parâmetro é válido apenas quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
false |
Aceitar caracteres curinga? |
false |
<CommonParameters>
Esse cmdlet oferece suporte aos parâmetros comuns: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer e -OutVariable. Para obter mais informações, consulte about_Commonparameters.
Entradas e saídas
O tipo de entrada é o tipo dos objetos que você pode canalizar para o cmdlet. O tipo de retorno é o tipo dos objetos que o cmdlet retorna.
Entradas |
System.String Você pode enviar uma cadeia de caracteres que contém um caminho para Get-ChildItem. |
Saídas |
Object. O tipo de objeto que Get-ChildItem retorna é determinado pelo provedor com o qual é usado. |
Observações
Você também pode se referir a Get-ChildItem usando seus aliases internos "ls", "dir" e "gci". Para obter mais informações, consulte about_Aliases.
Por padrão, Get-ChildItem não obtém itens ocultos. Para obtê-los, utilize –Force.
O cmdlet Get-ChildItem foi desenvolvido para funcionar 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.
Exemplo 1
C:\PS>get-childitem
Descrição
-----------
Esse comando obtém os itens filhos do local atual. Caso o local seja um diretório do sistema de arquivos, ele obterá os arquivos e os subdiretórios do diretório atual. Se o item não tiver itens filhos, esse comando retornará ao prompt de comando sem exibir nada.
A exibição padrão lista o modo (atributos), a hora da última gravação, o tamanho do arquivo (comprimento) e o nome do arquivo. Os valores válidos para o modo são d (diretório), a (arquivo morto), r (somente leitura), h (oculto) e s (sistema).
Exemplo 2
C:\PS>get-childitem . -include *.txt -recurse -force
Descrição
-----------
Esse comando recupera todos os arquivos .txt do diretório atual e todos os subdiretórios. O ponto (.) representa o diretório atual e o parâmetro Include especifica a extensão do nome do arquivo. O parâmetro Recurse faz com que o Windows PowerShell recupere objetos de forma recursiva e indica que o sujeito do comando é o diretório especificado e o seu conteúdo. O parâmetro force adiciona arquivos ocultos à exibição.
Exemplo 3
C:\PS>get-childitem c:\windows\logs\* -include *.txt -exclude A*
Descrição
-----------
Esse comando lista os arquivos .txt do subdiretório Logs, exceto por aqueles cujos nomes comecem pela letra A. Usa o caractere curinga (*) para indicar o conteúdo do subdiretório Logs, e não o contêiner do diretório. Como o comando não inclui o parâmetro Recurse, Get-ChildItem não inclui automaticamente o conteúdo do diretório; é preciso especificá-lo.
Exemplo 4
C:\PS>get-childitem registry::hklm\software
Descrição
-----------
Esse comando recupera todas as chaves de Registro da chave HKEY_LOCAL_MACHINE\SOFTWARE no Registro do computador local.
Exemplo 5
C:\PS>get-childitem -name
Descrição
-----------
Esse comando recupera somente os nomes dos itens do diretório atual.
Exemplo 6
C:\PS>get-childitem cert:\. -recurse -codesigningcert
Descrição
-----------
Esse comando obtém todos os certificados do local de repositório de certificados que tenham autoridade de assinatura de código.
O comando usa o cmdlet Get-ChildItem. O caminho especifica a unidade Cert: exposta pelo provedor de certificados do Windows PowerShell. O símbolo de barra invertida (\) especifica um subdiretório do local de repositório do certificado e o ponto (.) representa o diretório atual, que seria o diretório raiz do local de repositório do certificado. O parâmetro Recurse especifica uma pesquisa recursiva.
CodeSigningCertificate é um parâmetro dinâmico que obtém somente os certificados com a autoridade de assinatura de código. Para obter mais informações, digite "get-help certificate".
Exemplo 7
C:\PS>get-childitem * -include *.exe
Descrição
-----------
Esse comando recupera todos os itens do diretório atual que tenham a extensão de nome de arquivo ".exe". O caractere curinga (*) representa o conteúdo do diretório atual (e não do contêiner). Quando o parâmetro Include é usado sem o parâmetro Recurse, o caminho deve apontar para o conteúdo e não para o contêiner.