Partilhar via

Get-Item

  • Referência
Módulo:
Microsoft.PowerShell.Management

Obtém o item no local especificado.

Sintaxe

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

Description

O cmdlet Get-Item obtém o item no local especificado. Ele não obtém o conteúdo do item no local, a menos que você use um caractere curinga ('*') para solicitar todo o conteúdo do item.

Esse cmdlet é usado por provedores do PowerShell para navegar por diferentes tipos de armazenamentos de dados.

Exemplos

Exemplo 1: Obter o diretório atual

Este comando obtém o diretório atual. O ponto ('.') representa o item no local atual (não seu conteúdo).

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

Este comando obtém todos os itens no diretório atual. O caractere curinga ('*') representa todo o conteúdo do item 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

Este comando obtém o diretório atual da unidade C:. O objeto recuperado representa apenas o diretório, não seu conteúdo.

Get-Item C:\

Exemplo 4: Obter itens na unidade especificada

Este comando obtém os itens na unidade C:. O caractere curinga ('*') representa todos os itens no contêiner, não apenas o contêiner.

No PowerShell, use um único asterisco ('') para obter conteúdo, em vez do tradicional ".". O formato é interpretado literalmente, então ".*" não recuperaria diretórios ou nomes de arquivos sem um ponto.

Get-Item C:\*

Exemplo 5: Obter uma propriedade no diretório especificado

Este comando obtém a propriedade LastAccessTime do diretório "C:\Windows". LastAccessTime é apenas uma propriedade dos diretórios do sistema de arquivos. Para ver todas as propriedades de um diretório, digite (Get-Item \<directory-name\>) | Get-Member.

(Get-Item C:\Windows).LastAccessTime

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

Este comando mostra o conteúdo da chave do Registro Microsoft.PowerShell. Você pode usar esse cmdlet com o provedor do Registro PowerShell para obter chaves e subchaves do Registro, mas deve usar o cmdlet Get-ItemProperty para obter os valores e os dados 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

Este comando obtém itens no diretório do Windows com nomes que incluem um ponto ('.'), mas não começam com "w*". Este comando funciona somente quando o caminho inclui um caractere curinga ('*') para especificar o conteúdo do item.

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 . Se escrever um nome de utilizador, ser-lhe-á solicitada uma palavra-passe.

Advertência

Esse parâmetro não é suportado por nenhum provedor instalado com o Windows PowerShell.

Tipo:PSCredential
Position:Named
Default value:Current user
Necessário:False
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

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

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

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

Tipo:String
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-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 usando o parâmetro Force, o cmdlet não pode substituir restrições de segurança.

Tipo:SwitchParameter
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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 é 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".

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

-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 curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.

Tipo:String[]
Aliases:PSPath
Position:Named
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:False

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

Tipo:String[]
Position:0
Default value:None
Necessário:True
Aceitar entrada de pipeline:True
Aceitar carateres universais:True

-Stream

Obtém o fluxo de arquivo NTFS alternativo especificado do arquivo. Insira o nome do fluxo. Curingas são suportados. 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 do sistema de arquivos.

Tipo:String[]
Position:Named
Default value:No alternate file streams
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:True

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

Tipo:SwitchParameter
Aliases:usetx
Position:Named
Default value:False
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

Entradas

String

Você pode canalizar uma cadeia de caracteres que contenha um caminho para esse cmdlet.

Saídas

Object

Este cmdlet retorna os objetos que obtém. O tipo é determinado pelo tipo de objetos no caminho.

Notas

Este cmdlet não tem um parâmetro Recurse, porque obtém apenas um item, não seu conteúdo. Para obter o conteúdo de um item recursivamente, use Get-ChildItem.

Para navegar pelo Registro, use este cmdlet para obter chaves do Registro e o Get-ItemProperty para obter valores e dados do Registro. Os valores do Registro são considerados propriedades da chave do Registro.

Este cmdlet foi projetado para trabalhar 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.