Compartir a través de

Get-ItemProperty

  • Referencia
Módulo:
Microsoft.PowerShell.Management

Obtiene las propiedades de un elemento especificado.

Sintaxis

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

El Get-ItemProperty cmdlet obtiene las propiedades de los elementos especificados. Por ejemplo, puede usar este cmdlet para obtener el valor de la propiedad LastAccessTime de un objeto de archivo. También puede usar este cmdlet para ver las entradas del Registro y sus valores.

Ejemplos

Ejemplo 1: Obtener información sobre un directorio específico

Este comando obtiene información sobre el C:\Windows directorio .

Get-ItemProperty C:\Windows

Ejemplo 2: Obtener las propiedades de un archivo específico

Este comando obtiene las propiedades del C:\Test\Weather.xls archivo. El resultado se canaliza al Format-List cmdlet para mostrar la salida como una lista.

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

Ejemplo 3: Obtener el nombre de valor y los datos de una entrada del Registro en una subclave del Registro

Este comando obtiene el nombre de valor y los datos de la entrada del ProgramFilesDir Registro en la subclave del CurrentVersion Registro. La ruta de acceso especifica la subclave y el parámetro Name especifica el nombre de valor de la entrada.

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

Nota:

Este comando requiere que haya una unidad de PowerShell denominada HKLM: que se asigne al HKEY_LOCAL_MACHINE subárbol del Registro.

Una unidad con ese nombre y asignación está disponible en PowerShell de forma predeterminada. Como alternativa, la ruta de acceso a esta subclave del Registro puede especificarse mediante la siguiente ruta de acceso alternativa que comienza con el nombre del proveedor seguido de dos puntos dobles:

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

Ejemplo 4: Obtener los nombres de valor y los datos de las entradas del Registro en una clave del Registro

Este comando obtiene los nombres de valor y los datos de las entradas del Registro en la clave del PowerShellEngine Registro. Los resultados se muestran en los siguientes resultados de ejemplo.

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 no es compatible con ningún proveedor instalado con PowerShell. Para suplantar a otro usuario o elevar las credenciales al ejecutar este cmdlet, use Invoke-Command.

Tipo:PSCredential
Posición:Named
Valor predeterminado:Current user
Requerido:False
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Exclude

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye en la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento o patrón de ruta de acceso, como *.txt. Se permite el uso de caracteres comodín. El parámetro Exclude solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows directorio.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Filter

Especifica un filtro para calificar el parámetro Path . El proveedor FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro FileSystem en about_Wildcards. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Include

Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento o patrón de ruta de acceso, como *.txt. Se permite el uso de caracteres comodín. El parámetro Include solo es efectivo cuando el comando incluye el contenido de un elemento, como C:\Windows\*, donde el carácter comodín especifica el contenido del C:\Windows directorio.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-LiteralPath

Especifica una ruta de acceso a una o varias ubicaciones. El valor de LiteralPath se usa exactamente como se escribe. Ninguno de los caracteres se interpreta como caracteres comodín. Si la ruta de acceso contiene caracteres de escape, escríbalos entre comillas simples. Las comillas simples indican a PowerShell que no interprete ningún carácter como secuencias de escape.

Para obtener más información, consulte about_Quoting_Rules.

Tipo:String[]
Alias:PSPath, LP
Posición:Named
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:False

-Name

Especifica el nombre de la propiedad o de las propiedades que se van a recuperar. Se permite el uso de caracteres comodín.

Tipo:String[]
Alias:PSProperty
Posición:1
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:True

-Path

Especifica la ruta de acceso al elemento o elementos. Se permite el uso de caracteres comodín.

Tipo:String[]
Posición:0
Valor predeterminado:None
Requerido:True
Aceptar entrada de canalización:True
Aceptar caracteres comodín:True

Entradas

String

Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.

Salidas

Boolean

String

DateTime

FileInfo

DirectoryInfo

Este cmdlet devuelve un objeto para cada propiedad de elemento que obtiene. El tipo de objeto depende del objeto recuperado. Por ejemplo, en una unidad del sistema de archivos, puede devolver un archivo o una carpeta.

Notas

PowerShell incluye los siguientes alias para Get-ItemProperty:

  • Todas las plataformas:
    • gp

El Get-ItemProperty cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, escriba Get-PSProvider. Para obtener más información, consulte about_Providers.