Get-ChildItem

Sintaxe

Items (Predefinição)

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

Parâmetros

-Attributes

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 as seguintes propriedades:

• Arquivo
• Comprimido
• Dispositivo
• Diretório
• criptografado
• Escondido
• IntegrityStream
• Normal
• NoScrubData
• NãoIndexadoConteúdo
• offline
• Apenas leitura
• ReparsePoint
• Ficheiro Disperso
• Sistema
• #Temporário

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

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

Conjuntos de parâmetros

-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 arquivo são incluídos na saída.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Directory

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

Conjuntos de parâmetros

-Exclude

Especifica, como uma matriz de cadeia de caracteres, uma propriedade ou propriedade que esse 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*. 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-File

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

Conjuntos de parâmetros

-Filter

Especifica um filtro para qualificar o parâmetro Path. O provedor FileSystem é o único provedor do PowerShell instalado que oferece suporte ao uso de filtros. Os filtros são mais eficientes do que outros parâmetros, porque o provedor os aplica 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. Essa API suporta apenas * e ? curingas.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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 as restrições de segurança. A implementação varia entre os fornecedores. Para obter mais informações, consulte about_Providers.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Hidden

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

Conjuntos de parâmetros

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-LiteralPath

Especifica um caminho para um ou mais locais. O valor de LiteralPath é utilizado exatamente como foi escrito. Nenhum caractere é interpretado como carta curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.

Para obter mais informações, consulte about_Quoting_Rules.

Propriedades dos parâmetros

Conjuntos de parâmetros

-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. Curingas são permitidos.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Path

Especifica um caminho para um ou mais locais. Curingas são aceitos. O local padrão é o diretório atual (.).

Propriedades dos parâmetros

Conjuntos de parâmetros

-ReadOnly

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

Conjuntos de parâmetros

-Recurse

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

Propriedades dos parâmetros

Conjuntos de parâmetros

-System

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

Conjuntos de parâmetros

-UseTransaction

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

Propriedades dos parâmetros

Conjuntos de parâmetros

CommonParameters

Entradas

String

Saídas

Object

String

Notas

Ligações Relacionadas

• sobre_Fornecedor_de_Certificado
• sobre_Fornecedores
• sobre_Regras_de_Citação
• sobre_Fornecedor_de_Registo
• ForEach-Object
• Get-Alias
• Get-Item
• Get-Location
• Get-Process
• Get-PSProvider
• Split-Path