Get-Item
Obtém o item no local especificado.
Sintaxe
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>]Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[-CodeSigningCert]
[-DocumentEncryptionCert]
[-SSLServerAuthentication]
[-DnsName <string>]
[-Eku <string[]>]
[-ExpiringInDays <int>]
[<CommonParameters>]Get-Item
[-Path] <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<CommonParameters>]Get-Item
-LiteralPath <string[]>
[-Filter <string>]
[-Include <string[]>]
[-Exclude <string[]>]
[-Force]
[-Credential <pscredential>]
[<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 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-testExemplo 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.txtExemplo 3: Obter o diretório atual de uma unidade de disco
Este exemplo obtém o diretório atual do drive 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 exemplo obtém os itens na unidade C:. 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, de modo que *.* 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 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).LastAccessTimeExemplo 6: Mostrar o conteúdo de uma chave do Registro
Este exemplo mostra o conteúdo da chave de 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
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: obter 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 C:\Windows\System32\ntoskrnl.exe |
Format-Table -View childrenWithHardLink
Directory: C:\Windows\System32
Mode LastWriteTime Length Name
---- ------------- ------ ----
la--- 5/12/2021 7:40 AM 10848576 ntoskrnl.exeA propriedade Mode identifica o hardlink por meio do l em la---
Exemplo 9: Saída para sistemas operacionais não Windows
No PowerShell 7.1 em sistemas Unix, o cmdlet Get-Item fornece saída semelhante ao Unix:
PS> Get-Item /Users
Directory: /
UnixMode User Group LastWriteTime Size Name
-------- ---- ----- ------------- ---- ----
drwxr-xr-x root admin 12/20/2019 11:46 192 UsersAs novas propriedades que agora fazem parte da saída são:
- UnixMode é as permissões de arquivo, conforme representadas em um sistema Unix
- user é o proprietário do arquivo
- Group é o proprietário do grupo
- Size é o tamanho do arquivo ou diretório, conforme representado em um sistema Unix
Nota
Esse recurso foi movido do experimental para o mainstream no PowerShell 7.1.
Parâmetros
-CodeSigningCert
Esse é um parâmetro dinâmico disponibilizado pelo provedor Certificate. Esse parâmetro e o provedor de Certificado só estão disponíveis no Windows.
Para obter uma lista dos certificados que têm Code Signing no valor de propriedade EnhancedKeyUsageList, use o parâmetro CodeSigningCert.
Para obter mais informações, consulte about_Certificate_Provider.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Credential
Nota
Esse parâmetro não é compatível com nenhum provedor instalado com o PowerShell. Ao executar esse cmdlet, para representar outro usuário ou elevar suas credenciais, use Invoke-Command.
| Tipo: | PSCredential |
| Cargo: | Named |
| Valor padrão: | Current user |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | False |
-DnsName
Esse é um parâmetro dinâmico disponibilizado pelo provedor Certificate. Esse parâmetro e o provedor de Certificado só estão disponíveis no Windows.
Especifica um nome de domínio ou um padrão de nome para corresponder à propriedade DNSNameList de certificados que o cmdlet obtém. O valor desse parâmetro pode ser Unicode ou ASCII. Os valores de Punycode são convertidos em Unicode. Caracteres curinga (*) são permitidos.
Esse parâmetro foi reintroduzido no PowerShell 7.1
Para obter mais informações, consulte about_Certificate_Provider.
| Tipo: | DnsNameRepresentation |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-DocumentEncryptionCert
Esse é um parâmetro dinâmico disponibilizado pelo provedor Certificate. Esse parâmetro e o provedor de Certificado só estão disponíveis no Windows.
Para obter certificados que têm Document Encryption em seu valor de propriedade EnhancedKeyUsageList, use o parâmetro DocumentEncryptionCert.
Para obter mais informações, consulte about_Certificate_Provider.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Eku
Esse é um parâmetro dinâmico disponibilizado pelo provedor Certificate. Esse parâmetro e o provedor de Certificado só estão disponíveis no Windows.
Especifica um texto ou padrão de texto para corresponder à propriedade EnhancedKeyUsageList de certificados que o cmdlet obtém. Caracteres curinga (*) são permitidos. A propriedade EnhancedKeyUsageList contém o nome amigável e os campos OID do EKU.
Esse parâmetro foi reintroduzido no PowerShell 7.1
Para obter mais informações, consulte about_Certificate_Provider.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-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.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
-ExpiringInDays
Esse é um parâmetro dinâmico disponibilizado pelo provedor Certificate. Esse parâmetro e o provedor de Certificado só estão disponíveis no Windows.
Especifica que o cmdlet só deve retornar certificados que estão expirando dentro ou antes do número especificado de dias. Um valor zero (0) obtém certificados que expiraram.
Esse parâmetro foi reintroduzido no PowerShell 7.1
Para obter mais informações, consulte about_Certificate_Provider.
| Tipo: | Int32 |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-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 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 do .NET para enumerar arquivos. A API só dá suporte a caracteres curingas * e ?.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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 ao usar o parâmetro Force, o cmdlet não consegue superar restrições de segurança.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | False |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | 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. As aspas simples dizem ao PowerShell a não interpretar nenhum caractere como sequências de escape.
Para obter mais informações, consulte about_Quoting_Rules.
| Tipo: | String[] |
| Aliases: | PSPath, LP |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | 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.
| Tipo: | String[] |
| Cargo: | 0 |
| Valor padrão: | None |
| Obrigatório: | True |
| Aceitar a entrada de pipeline: | True |
| Aceitar caracteres curinga: | True |
-SSLServerAuthentication
Esse é um parâmetro dinâmico disponibilizado pelo provedor Certificate. Esse parâmetro e o provedor de Certificado só estão disponíveis no Windows.
Para obter uma lista dos certificados que têm Server Authentication no valor de propriedade EnhancedKeyUsageList, use o parâmetro SSLServerAuthentication.
Para obter mais informações, consulte about_Certificate_Provider.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Stream
Esse é um parâmetro dinâmico disponibilizado pelo provedor de FileSystem. Esse parâmetro só está disponível no Windows.
Obtém o fluxo de dados 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 é válido em diretórios, mas observe que os diretórios não têm fluxos de dados por padrão.
Esse parâmetro foi introduzido no PowerShell 3.0. A partir do PowerShell 7.2, Get-Item podem obter fluxos de dados alternativos de diretórios, bem como arquivos.
Para obter mais informações, consulte about_FileSystem_Provider.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | No alternate file streams |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | True |
Entradas
É possível direcionar uma cadeia de caracteres que contém um caminho para este cmdlet.
Saídas
O cmdlet gera esse tipo ao acessar a unidade Alias:.
O cmdlet gera esses tipos quando acessa a unidade Cert:.
O cmdlet gera esse tipo ao acessar a unidade Env:.
O cmdlet gera esses tipos ao acessar as unidades do FileSystem.
O cmdlet gera esses tipos quando acessa as unidades Function:.
O cmdlet gera esse tipo ao acessar as unidades do Registro.
O cmdlet gera esse tipo ao acessar as unidades Variable:.
O cmdlet gera esses tipos quando acessa as unidades WSMan:.
Observações
O PowerShell inclui os seguintes aliases para Get-Item:
- Todas as plataformas:
gi
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.
