Get-ItemProperty
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 cmdlet Get-ItemProperty
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 directorio C:\Windows
.
Get-ItemProperty C:\Windows
Ejemplo 2: Obtener las propiedades de un archivo específico
Este comando obtiene las propiedades del archivo C:\Test\Weather.xls
. El resultado se canaliza al cmdlet Format-List
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 Registro ProgramFilesDir
en la subclave del Registro CurrentVersion
. El Path 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 subárbol de HKEY_LOCAL_MACHINE
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 se puede especificar mediante la siguiente ruta de acceso alternativa que comienza con el nombre del proveedor seguido de dos puntos:
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 Registro PowerShellEngine
. Los resultados se muestran en la siguiente salida 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 permiten 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 directorio C:\Windows
.
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 de FileSystem es el único proveedor de PowerShell instalado que admite el uso de filtros. Puede encontrar la sintaxis del lenguaje de filtro de 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 permiten 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 directorio C:\Windows
.
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. No se interpreta ningún carácter como caracteres comodín. Si la ruta de acceso incluye caracteres de escape, escríbala 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, vea 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 las propiedades que se van a recuperar. Se permiten 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 a los elementos. Se permiten 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
Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.
Salidas
Este cmdlet devuelve un objeto para cada propiedad de elemento que obtiene. El tipo de objeto depende del objeto que se recupera. Por ejemplo, en una unidad del sistema de archivos, podría devolver un archivo o carpeta.
Notas
PowerShell incluye los siguientes alias para Get-ItemProperty
:
- Todas las plataformas:
gp
El cmdlet Get-ItemProperty
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, vea about_Providers.