Get-Item
Obtém o item no local especificado.
Sintaxe
Get-Item [-LiteralPath] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Get-Item [-Path] <string[]> [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Force] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Descrição
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.
O cmdlet Get-Item é utilizado pelos provedores do Windows PowerShell para permitir que você navegue pelos diferentes tipos de repositórios de dados.
Parâmetros
-Credential <PSCredential>
Especifica uma conta de usuário com 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 aquele gerado pelo cmdlet Get-Credential. Uma senha será solicitada após a digitação do nome do usuário.
Este parâmetro não tem suporte em nenhum dos provedores instalados com o Windows PowerShell.
Necessário? |
false |
Posição? |
named |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByPropertyName) |
Aceitar caracteres curinga? |
false |
-Exclude <string[]>
Omite 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 Exclude tem efeito somente 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.
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? |
named |
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, como itens 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 conteúdo de um item, como C:\Windows\*, em que 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 o item. 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 |
-Path <string[]>
Especifica o caminho de um item. Get-Item obtém o item no local especificado. Os caracteres curinga são permitidos. Este parâmetro é obrigatório, mas seu nome ("Path") é opcional.
Use um ponto (.) para especificar o local atual. Use o caractere curinga (*) para especificar todos os itens do local atual.
Necessário? |
true |
Posição? |
1 |
Valor padrão |
|
Aceitar entrada do pipeline? |
true (ByValue, ByPropertyName) |
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-Item. |
Saídas |
Object Get-Item retorna os objetos que foram obtidos. O tipo é determinado pelo tipo dos objetos no caminho. |
Observações
Você também pode fazer referência a Get-Item usando seu alias interno, "gi". Para obter mais informações, consulte about_Aliases.
Get-Item não tem um parâmetro Recurse porque obtém somente um item e não o seu conteúdo. Para obter o conteúdo de um item de forma recursiva, use Get-ChildItem.
Para navegar pelo Registro, use Get-Item para obter as chaves do Registro e Get-ItemProperty para obter os valores e os dados do Registro. Os valores do Registro são considerados propriedades da chave do Registro.
O cmdlet Get-Item 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-item .
Directory: C:\
Mode LastWriteTime Length Name
---- ------------- ------ ----
d---- 7/26/2006 10:01 AM ps-test
Descrição
-----------
Esse comando obtém o diretório atual. O ponto (.) representa o item do diretório atual (e não o seu conteúdo).
Exemplo 2
C:\PS>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
Descrição
-----------
Esse comando obtém todos os itens do diretório atual. O caractere curinga (*) representa todo o conteúdo do item atual.
Exemplo 3
C:\PS>get-item C:\
Descrição
-----------
Esse comando obtém o diretório atual da unidade C:. O objeto recuperado representa somente o diretório, e não o seu conteúdo.
Exemplo 4
C:\PS>get-item C:\*
Descrição
-----------
Esse comando obtém os itens na unidade C:. O caractere curinga (*) representa todos os itens do contêiner, não somente o contêiner.
No Windows PowerShell, use um único asterisco (*) para obter o conteúdo, em vez do tradicional "*.*". O formato é interpretado literalmente, portanto "*.*" não recuperaria diretórios ou nomes de arquivos que não tivessem um ponto.
Exemplo 5
C:\PS>(get-item C:\Windows).LastAccessTime
Descrição
-----------
Esse comando obtém a propriedade LastAccessTime do diretório C:\Windows. LastAccessTime é somente uma das propriedades dos diretórios do sistema de arquivos. Para ver todas as propriedades de um diretório, digite "(Get-Item <nome-do-diretório>) | Get-Member".
Exemplo 6
C:\PS>get-item hklm:\software\microsoft\powershell\1\shellids\microsoft.powershell\*
Descrição
-----------
Esse comando mostra o conteúdo da chave do Registro Microsoft.PowerShell. Você pode usar Get-Item no provedor Registry do Windows PowerShell para obter chaves e subchaves do Registro, mas deve usar Get-ItemProperty para obter os valores e os dados do Registro.
Exemplo 7
C:\PS>get-item c:\Windows\* -include *.* -exclude w*
Descrição
-----------
Esse comando obtém itens do diretório Windows com nomes que incluam um ponto (.) mas que não comecem com w*. Esse comando só funciona quando o caminho inclui um caractere curinga (*) para especificar o conteúdo do item.
Consulte também
Conceitos
about_Providers
Clear-Item
Copy-Item
Invoke-Item
Move-Item
Set-Item
New-Item
Remove-Item
Rename-Item