Get-Item
Obtém o item no local especificado.
Syntax
Get-Item
[-Path] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
Get-Item
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Force]
[-Credential <PSCredential>]
[-Stream <String[]>]
[<CommonParameters>]
Description
O Get-Item
cmdlet 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 pelos provedores do PowerShell para navegar por diferentes tipos de armazenamentos de dados.
Exemplos
Exemplo 1: Obter o diretório atual
Este exemplo 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 exemplo 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 exemplo obtém o diretório atual da C:
unidade. O objeto recuperado representa somente o diretório, e não o seu conteúdo.
Get-Item C:\
Exemplo 4: Obter itens na unidade especificada
Este exemplo obtém os itens na C:
unidade. O caractere curinga (*
) representa todos os itens no contêiner, não apenas o contêiner.
Get-Item C:\*
No PowerShell, use um único asterisco (*
) para obter conteúdo, em vez do tradicional *.*
. O formato é interpretado literalmente, portanto *.*
, não recuperaria diretórios ou nomes de arquivo sem um ponto.
Exemplo 5: Obter uma propriedade no diretório especificado
Este exemplo obtém a propriedade LastAccessTime do C:\Windows
diretório. LastAccessTime é apenas uma propriedade de 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 exemplo mostra o conteúdo da 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 você deve usar o Get-ItemProperty
cmdlet 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
Este exemplo obtém itens no diretório do Windows com nomes que incluem um ponto (.
), mas não começam com w*
. Este exemplo funciona somente quando o caminho inclui um caractere curinga (*
) para especificar o conteúdo do item.
Get-Item C:\Windows\*.* -Exclude "w*"
Exemplo 8: Obtendo informações de hardlink
No PowerShell 6.2, uma exibição alternativa foi adicionada para obter informações de hardlink. Para obter as informações de hardlink, redirecione a saída para Format-Table -View childrenWithHardlink
Get-Item -Path C:\PathWhichIsAHardLink | Format-Table -View childrenWithHardlink
Parâmetros
-Credential
Observação
Esse parâmetro não é suportado por nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar esse cmdlet, use Invoke-Command.
Type: | PSCredential |
Position: | Named |
Default value: | Current user |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet exclui na operação. O valor deste 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 C:\Windows
diretório.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-Filter
Especifica um filtro para qualificar o parâmetro Path . O provedor FileSystem é o único provedor do PowerShell instalado que dá suporte a filtros. Os filtros são mais eficientes do que outros parâmetros. O provedor aplica o filtro quando o cmdlet obtém os objetos em vez de ter o PowerShell filtrar os objetos depois que eles são recuperados. A cadeia de caracteres de filtro é passada para a API .NET para enumerar arquivos. A API só dá *
suporte e ?
curingas.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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 provedor para provedor. 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.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Include
Especifica, como uma matriz de cadeia de caracteres, um item ou itens que esse cmdlet inclui na operação. O valor deste 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 C:\Windows
diretório.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
-LiteralPath
Especifica um caminho para um ou mais locais. 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 dizem ao PowerShell para não interpretar nenhum caractere como sequências de escape.
Para obter mais informações, consulte about_Quoting_Rules.
Type: | String[] |
Aliases: | PSPath, LP |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String[] |
Position: | 0 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | True |
-Stream
Obtém o fluxo de arquivos 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 Get-Item
cmdlet.
Esse parâmetro funciona somente em unidades de sistema de arquivos.
Type: | String[] |
Position: | Named |
Default value: | No alternate file streams |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | True |
Entradas
Você pode canalizar uma cadeia de caracteres que contém um caminho para este cmdlet.
Saídas
Esse cmdlet retorna os objetos que 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 obter Get-ItemProperty
valores e dados do Registro. Os valores do registro são considerados propriedade da chave do registro.
Esse 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.