Get-ItemProperty

Referência

Módulo:: Microsoft.PowerShell.Management

Obtém as propriedades de um item especificado.

Syntax

Get-ItemProperty
   [-Path] <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Get-ItemProperty
   -LiteralPath <String[]>
   [[-Name] <String[]>]
   [-Filter <String>]
   [-Include <String[]>]
   [-Exclude <String[]>]
   [-Credential <PSCredential>]
   [<CommonParameters>]

Description

O Get-ItemProperty cmdlet obtém as propriedades dos itens especificados. Por exemplo, você pode usar esse cmdlet para obter o valor da propriedade LastAccessTime de um objeto de arquivo. Você também pode usar esse cmdlet para exibir as entradas do Registro e seus valores.

Exemplos

Exemplo 1: obter informações sobre um diretório específico

Este comando obtém informações sobre o C:\Windows diretório.

Get-ItemProperty C:\Windows

Exemplo 2: Obter as propriedades de um arquivo específico

Esse comando obtém as propriedades do C:\Test\Weather.xls arquivo. O resultado é canalizado para o Format-List cmdlet para exibir a saída como uma lista.

Get-ItemProperty C:\Test\Weather.xls | Format-List

Exemplo 3: exibir o nome do valor e os dados das entradas do Registro em uma subchave do Registro

Esse comando exibe o nome do valor e os dados de cada uma das entradas do Registro contidas na subchave do Registro "CurrentVersion".

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion

Observação

Esse comando exige que haja uma unidade do PowerShell nomeada HKLM: que seja mapeada para o hive "HKEY_LOCAL_MACHINE" do registro.

Por padrão, uma unidade com esse nome e mapeamento está disponível no PowerShell. Como alternativa, o caminho para essa subchave de registro pode ser especificado usando o seguinte caminho alternativo que começa com o nome do provedor seguido por dois-pontos duplos:

Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.

Exemplo 4: obter o nome do valor e os dados de uma entrada do Registro em uma subchave do Registro

Esse comando obtém o nome do valor e os dados da entrada do registro "ProgramFilesDir" na subchave do registro "CurrentVersion". O Caminho especifica a subchave e o parâmetro Name especifica o nome do valor da entrada.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"

Exemplo 5: Obter os nomes de valor e os dados das entradas do Registro em uma chave do Registro

Esse comando obtém os nomes de valor e os dados das entradas do Registro na chave do Registro "PowerShellEngine". Os resultados são mostrados na seguinte saída de exemplo.

Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\PowerShellEngine

ApplicationBase         : C:\Windows\system32\WindowsPowerShell\v1.0\
ConsoleHostAssemblyName : Microsoft.PowerShell.ConsoleHost, Version=1.0.0.0, Culture=neutral, PublicKeyToken=31bf3856ad364e35, ProcessorArchitecture=msil
PowerShellVersion       : 2.0
RuntimeVersion          : v2.0.50727
CTPVersion              : 5
PSCompatibleVersion     : 1.0,2.0

Parâmetros

-Credential

Observação

Não há suporte para esse parâmetro em nenhum provedor instalado com o PowerShell. Para representar outro usuário ou elevar suas credenciais ao executar este 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 Exclude 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 ao uso de filtros. Você pode encontrar a sintaxe da linguagem de filtro FileSystem em about_Wildcards. 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.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Include

Especifica, como uma matriz de cadeia de caracteres, um item ou itens que este 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 ele é 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 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

-Name

Especifica o nome da propriedade ou propriedades para recuperar. Caracteres curinga são permitidos.

Type:	String[]
Aliases:	PSProperty
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	True

-Path

Especifica o caminho para o(s) item(ns). Caracteres curinga são permitidos.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	True

Entradas

String

Você pode canalizar uma cadeia de caracteres que contém um caminho para Get-ItemProperty.

Saídas

System.Boolean, System.String, System.DateTime

Get-ItemProperty retorna um objeto para cada propriedade de item que ele obtém. O tipo de objeto depende do objeto que é recuperado. Por exemplo, em uma unidade de sistema de arquivos, ele pode retornar um arquivo ou pasta.

Observações

O Get-ItemProperty cmdlet foi projetado 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.