Partilhar via

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, pode utilizar este cmdlet para obter o valor da propriedade LastAccessTime de um objeto de ficheiro. Também pode utilizar este cmdlet para ver as entradas do registo e os respetivos 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 ficheiro específico

Este comando obtém as propriedades do C:\Test\Weather.xls ficheiro. O resultado é direcionado para o Format-List cmdlet para apresentar o resultado como uma lista.

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

Exemplo 3: obter o nome do valor e os dados de uma entrada de registo numa subchave de registo

Este comando obtém o nome do valor e os ProgramFilesDir dados da entrada de registo na subchave do CurrentVersion registo. 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"

Nota

Este comando requer que exista uma unidade do PowerShell com o nome HKLM: mapeada para o HKEY_LOCAL_MACHINE ramo de registo.

Por predefinição, está disponível uma unidade com esse nome e mapeamento no PowerShell. Em alternativa, o caminho para esta subchave de registo pode ser especificado através do seguinte caminho alternativo que começa com o nome do fornecedor seguido de dois pontos:

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

Exemplo 4: Obter os nomes dos valores e os dados das entradas de registo numa chave de registo

Este comando obtém os nomes de valor e os dados das entradas de registo na chave de PowerShellEngine registo. Os resultados são apresentados 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

Nota

Este parâmetro não é suportado por nenhum fornecedor instalado com o PowerShell. Para representar outro utilizador ou elevar as suas credenciais ao executar este cmdlet, utilize 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, um item ou itens que este cmdlet exclui na operação. O valor deste parâmetro qualifica o parâmetro Path . Introduza um elemento ou padrão de caminho, como *.txt. Os carateres universais 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 caráter universal 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 fornecedor fileSystem é o único fornecedor do PowerShell instalado que suporta a utilização de filtros. Pode encontrar a sintaxe da linguagem de filtro FileSystem no about_Wildcards. Os filtros são mais eficientes do que outros parâmetros, porque o fornecedor aplica-os quando o cmdlet obtém os objetos em vez de ter o PowerShell a filtrar os objetos depois de serem obtidos.

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

-Include

Especifica, como uma matriz de cadeia, um item ou itens que este cmdlet inclui na operação. O valor deste parâmetro qualifica o parâmetro Path . Introduza um elemento ou padrão de caminho, como *.txt. Os carateres universais 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 caráter universal 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 uma ou mais localizações. O valor de LiteralPath é utilizado exatamente como é escrito. Não são interpretados carateres universais. Se o caminho incluir carateres de escape, coloque-o entre plicas. As aspas únicas indicam ao PowerShell para não interpretar os carateres como sequências de escape.

Para obter mais informações, veja 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 a obter. Os carateres universais 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 item ou itens. Os carateres universais são permitidos.

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

Entradas

String

Pode encaminhar uma cadeia que contém um caminho para este cmdlet.

Saídas

Boolean

String

DateTime

FileInfo

DirectoryInfo

Este cmdlet devolve um objeto para cada propriedade de item que obtém. O tipo de objeto depende do objeto que é obtido. Por exemplo, numa unidade do sistema de ficheiros, pode devolver um ficheiro ou pasta.

Notas

O PowerShell inclui os seguintes aliases para Get-ItemProperty:

  • Todas as plataformas:
    • gp

O Get-ItemProperty cmdlet foi concebido para funcionar com os dados expostos por qualquer fornecedor. Para listar os fornecedores disponíveis na sua sessão, escreva Get-PSProvider. Para obter mais informações, veja about_Providers.