Get-Item

Sintaxe

Path (Predefinição)

Get-Item
    [-Path] <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [-Stream <String[]>]
    [<CommonParameters>]

LiteralPath

Get-Item
    -LiteralPath <String[]>
    [-Filter <String>]
    [-Include <String[]>]
    [-Exclude <String[]>]
    [-Force]
    [-Credential <PSCredential>]
    [-UseTransaction]
    [-Stream <String[]>]
    [<CommonParameters>]

Description

Exemplos

Exemplo 1: Obter o diretório atual

Get-Item .

Directory: C:\

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006  10:01 AM            ps-test

Exemplo 2: Obter todos os itens no diretório atual

Get-Item *

Directory: C:\ps-test

Mode                LastWriteTime     Length Name
----                -------------     ------ ----
d----         7/26/2006   9:29 AM            Logs
d----         7/26/2006   9:26 AM            Recs
-a---         7/26/2006   9:28 AM         80 date.csv
-a---         7/26/2006  10:01 AM         30 filenoext
-a---         7/26/2006   9:30 AM      11472 process.doc
-a---         7/14/2006  10:47 AM         30 test.txt

Exemplo 3: Obter o diretório atual de uma unidade

Get-Item C:\

Exemplo 4: Obter itens na drive especificada

Get-Item C:\*

Exemplo 5: Obter uma propriedade no diretório especificado

(Get-Item C:\Windows).LastAccessTime

Exemplo 6: Mostrar o conteúdo de uma chave do Registro

Get-Item HKLM:\Software\Microsoft\Powershell\1\Shellids\Microsoft.Powershell\

Exemplo 7: Obter itens em um diretório que têm uma exclusão

Get-Item c:\Windows\*.* -Exclude "w*"

Parâmetros

-Credential

Especifica uma conta de usuário que tem permissão para executar essa ação. O padrão é o usuário atual.

Digite um nome de usuário, como "User01" ou "Domain01\User01", ou insira um objeto PSCredential, como um gerado pelo cmdlet Get-Credential. Se escrever um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Exclude

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet exclui 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 Exclude é efetivo somente 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

-Filter

Especifica um filtro no formato ou idioma do provedor. O valor desse parâmetro qualifica o parâmetro Path.

A sintaxe do filtro, incluindo o uso de caracteres curinga, depende do provedor. 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.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Force

Indica que esse cmdlet obtém itens que não podem ser acessados de outra forma, como itens ocultos. A implementação varia de fornecedor para fornecedor. Para obter mais informações, consulte about_Providers. Mesmo utilizando o parâmetro Force, o cmdlet não consegue ultrapassar as restrições de segurança.

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 é efetivo somente 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 o item. Ao contrário do parâmetro Path, 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. Aspas simples indicam ao PowerShell para não interpretar quaisquer caracteres como sequências de escape.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Path

Especifica o caminho para um item. Este cmdlet obtém o item no local especificado. Curingas são permitidos. Este parâmetro é necessário, mas o nome do parâmetro ("Path") é opcional.

Use um ponto ('.') para especificar o local atual. Use o caractere curinga ('*') para especificar todos os itens no local atual.

Propriedades dos parâmetros

Conjuntos de parâmetros

-Stream

Obtém o fluxo de arquivo NTFS alternativo especificado do arquivo. Insira o nome do fluxo. O uso de caracteres universais é suportado. Para obter todos os fluxos, use um asterisco (*). Este parâmetro não é válido em pastas.

Stream é um parâmetro dinâmico que o provedor FileSystem adiciona ao cmdlet Get-Item. Este parâmetro funciona apenas em unidades de disco do sistema de arquivos.

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

Notas

Ligações Relacionadas

• Clear-Item
• Copy-Item
• Invoke-Item
• Move-Item
• Novo Item
• Remove-Item
• Renomear-Item
• Set-Item
• Get-ChildItem
• Get-ItemProperty
• Get-PSProvider