Get-Item
Obtém o item no local especificado.
Sintaxe
Path (Default)
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
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
Esse 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
Esse 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 de disco
Esse 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
Esse 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 arquivo sem um ponto.
Get-Item C:\*
Exemplo 5: Obter uma propriedade no diretório especificado
Esse 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 do chave do Registro Microsoft.PowerShell.
Você pode usar esse cmdlet com o provedor do Registro do 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 tenham uma exclusão
Esse comando obtém itens no diretório do Windows com nomes que incluem um ponto ('.'), mas não começam com "w*". Esse 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 Get-Credential.
Se você digitar um nome de usuário, será solicitada uma senha.
Aviso
Esse parâmetro não tem suporte para nenhum provedor instalado com o Windows PowerShell.
Propriedades do parâmetro
| Tipo: | PSCredential |
| Valor padrão: | Current user |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | 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 Excluir só é eficaz 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".
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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, pois o provedor os aplica quando o cmdlet obtém os objetos em vez de ter o PowerShell filtrar os objetos depois que eles são recuperados.
Propriedades do parâmetro
| Tipo: | String |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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 provedor para provedor. Para obter mais informações, consulte about_Providers. Mesmo com o uso do parâmetro Force, o cmdlet não pode substituir as restrições de segurança.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | 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 só é eficaz 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".
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-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 caractere curinga. Se o caminho incluir caracteres de escape, coloque-o entre aspas simples. Aspas simples indicam ao PowerShell que não deve interpretar nenhum caractere como uma sequência de escape.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | PSPath |
Conjuntos de parâmetros
LiteralPath
| Cargo: | Named |
| Obrigatório: | True |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Path
Especifica o caminho para um item. Esse cmdlet obtém o item no local especificado. Caracteres curinga são permitidos. Esse 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 do parâmetro
| Tipo: | String[] |
| Valor padrão: | None |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
Path
| Cargo: | 0 |
| Obrigatório: | True |
| Valor do pipeline: | True |
| Valor do pipeline pelo nome da propriedade: | True |
| Valor dos argumentos restantes: | False |
-Stream
Obtém o fluxo de arquivo NTFS alternativo especificado do arquivo. Insira o nome do fluxo. Há suporte para caracteres curinga. Para obter todos os fluxos, use um asterisco (*). Esse parâmetro não é válido em pastas.
Stream é um parâmetro dinâmico que o provedor FileSystem adiciona ao cmdlet Get-Item. Esse parâmetro funciona apenas em unidades de arquivos do sistema.
Propriedades do parâmetro
| Tipo: | String[] |
| Valor padrão: | No alternate file streams |
| Dá suporte a curingas: | True |
| DontShow: | False |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
-UseTransaction
Inclui o comando na transação ativa. Esse parâmetro só é válido quando uma transação está em andamento. Para obter mais informações, consulte about_Transactions.
Propriedades do parâmetro
| Tipo: | SwitchParameter |
| Valor padrão: | False |
| Dá suporte a curingas: | False |
| DontShow: | False |
| Aliases: | usetx |
Conjuntos de parâmetros
(All)
| Cargo: | Named |
| Obrigatório: | False |
| Valor do pipeline: | False |
| Valor do pipeline pelo nome da propriedade: | False |
| Valor dos argumentos restantes: | False |
CommonParameters
Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, consulte about_CommonParameters.
Entradas
String
É possível direcionar uma cadeia de caracteres que contém um caminho para este cmdlet.
Saídas
Object
Esse cmdlet retorna os objetos que ele obtém. O tipo é determinado pelo tipo de objetos no caminho.
Observações
Esse cmdlet não tem um parâmetro Recurse, pois 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 esse 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.
Esse cmdlet foi projetado para funcionar com os dados expostos por qualquer provedor.
Para listar os provedores disponíveis na sessão, digite Get-PsProvider.
Para obter mais informações, consulte about_Providers.