Get-ItemProperty
Obtiene las propiedades de un elemento especificado.
Sintaxis
Get-ItemProperty [-LiteralPath] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Get-ItemProperty [-Path] <string[]> [[-Name] <string[]>] [-Credential <PSCredential>] [-Exclude <string[]>] [-Filter <string>] [-Include <string[]>] [-UseTransaction] [<CommonParameters>]
Descripción
El cmdlet Get-ItemProperty obtiene las propiedades de los elementos especificados. Por ejemplo, puede utilizar Get-ItemProperty para obtener el valor de la propiedad LastAccessTime de un objeto de archivo. También puede utilizar Get-ItemProperty para ver entradas del Registro y sus valores.
Parámetros
-Credential <PSCredential>
Especifica una cuenta de usuario con permiso para realizar esta acción. El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como "Usuario01" o "Dominio01\Usuario01", o bien, escriba un objeto PSCredential, como uno generado por el cmdlet Get-Credential. Si escribe un nombre de usuario se le pedirá una contraseña.
Este parámetro no es compatible con los proveedores que se instalan con Windows PowerShell.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Exclude <string[]>
Omite los elementos especificados. Se permite el uso de caracteres comodín.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Filter <string>
Especifica un filtro en el formato o lenguaje del proveedor. El valor de este parámetro califica el parámetro Path. La sintaxis del filtro, incluido el uso de caracteres comodín, depende del proveedor. Los filtros son más eficaces que otros parámetros, ya que el proveedor los aplica al recuperar los objetos en lugar de hacer que Windows PowerShell filtre los objetos después de recuperarlos.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Include <string[]>
Incluye los elementos especificados.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-LiteralPath <string[]>
Especifica la ruta de la propiedad del elemento. El valor de LiteralPath se usa literalmente como se escribe. Ningún carácter se interpretará como un carácter comodín. Si la ruta incluye caracteres de escape, escríbala entre comillas simples. Las comillas simples indican a Windows PowerShell que no debe interpretar los caracteres como secuencias de escape.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-Name <string[]>
Especifica el nombre de las propiedades que se va a recuperar.
¿Requerido? |
false |
¿Posición? |
2 |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
-Path <string[]>
Especifica la ruta de acceso a los elementos.
¿Requerido? |
true |
¿Posición? |
1 |
Valor predeterminado |
|
¿Aceptar canalización? |
true (ByValue, ByPropertyName) |
¿Aceptar caracteres comodín? |
false |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro sólo es válido cuando hay una transacción en curso. Para obtener más información, vea about_Transactions.
¿Requerido? |
false |
¿Posición? |
named |
Valor predeterminado |
|
¿Aceptar canalización? |
false |
¿Aceptar caracteres comodín? |
false |
<CommonParameters>
Este cmdlet admite los parámetros comunes: -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer y -OutVariable. Para obtener más información, vea about_Commonparameters.
Entradas y salidas
El tipo de entrada es el tipo de los objetos que se pueden canalizar al cmdlet. El tipo devuelto es el tipo de los objetos que el cmdlet devuelve.
Entradas |
System.String Puede canalizar una cadena que contiene una ruta de acceso a Get-ItemProperty. |
Salidas |
Object Get-ItemProperty devuelve un objeto para cada propiedad de elemento que obtiene. El tipo de objeto depende del objeto que se recupera. |
Notas
El cmdlet Get-ItemProperty está diseñado para funcionar con los datos expuestos por cualquier proveedor. Para mostrar los proveedores que están disponibles en la sesión, escriba "Get-PSProvider". Para obtener más información, vea about_Providers.
Ejemplo 1
C:\PS>get-itemproperty C:\Windows
Descripción
-----------
Este comando obtiene información acerca del directorio C:\Windows.
Ejemplo 2
C:\PS>get-itemproperty C:\Test\Weather.xls | format-list
Descripción
-----------
Este comando obtiene las propiedades del archivo C:\Test\Weather.xls. El resultado se canaliza al cmdlet Format-List para mostrar el resultado en forma de lista.
Ejemplo 3
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
Descripción
-----------
Este comando muestra el nombre del valor y los datos de cada una de las entradas del Registro contenidas en la subclave CurrentVersion. Tenga en cuenta que el comando requiere que haya una unidad de Windows PowerShell denominada HKLM y que esté asignada al subárbol HKEY_LOCAL_MACHINE del Registro. De manera predeterminada, hay una unidad con ese nombre y una asignación correspondiente en Windows PowerShell. Como alternativa, la ruta a esta subclave del Registro puede especificarse mediante la siguiente ruta de acceso, que empieza por el nombre del proveedor seguido de dos signos de dos puntos:
Registry::HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion.
Ejemplo 4
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion `
-name "ProgramFilesDir"
Descripción
-----------
Este comando obtiene el nombre de valor y los datos de la entrada ProgramFilesDir del Registro contenida en la subclave CurrentVersion del Registro. El comando usa el parámetro Path para especificar la subclave y el parámetro Name para especificar el nombre de valor de la entrada.
Ejemplo 5
C:\PS>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=31bf3856ad
364e35, ProcessorArchitecture=msil
PowerShellVersion : 2.0
RuntimeVersion : v2.0.50727
CTPVersion : 5
PSCompatibleVersion : 1.0,2.0
Descripción
-----------
Este comando obtiene los nombres de valor y los datos de las entradas del Registro incluidas en la clave PowerShellEngine del Registro. Los resultados se muestran en el siguiente ejemplo.
Ejemplo 6
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
C:\PS>get-itemproperty -path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell | format-list -property *
PSPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds\Micro
soft.PowerShell
PSParentPath : Microsoft.PowerShell.Core\Registry::HKEY_LOCAL_MACHINE\Software\Microsoft\PowerShell\1\ShellIds
PSChildName : Microsoft.PowerShell
PSDrive : HKLM
PSProvider : Microsoft.PowerShell.Core\Registry
Path : C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe
ExecutionPolicy : RemoteSigned
Descripción
-----------
En este ejemplo se muestra la manera de presentar los resultados de un comando Get-ItemProperty en forma de lista para facilitar la visualización de los datos y valores del Registro, así como la interpretación de los resultados.
El primer comando utiliza el cmdlet Get-ItemProperty para obtener las entradas del Registro incluidas en la subclave Microsoft.PowerShell. Esta subclave almacena las opciones del shell predeterminado para Windows PowerShell. Los resultados se muestran en el siguiente ejemplo.
Los resultados muestran que hay dos entradas del Registro, Path y ExecutionPolicy. Cuando una clave del Registro contiene menos de cinco entradas, se muestra de forma predeterminada en una tabla, pero suele ser más fácil verla en una lista.
El segundo comando usa el mismo comando Get-ItemProperty. Sin embargo, esta vez, el comando utiliza un operador de canalización (|) para enviar los resultados del comando al cmdlet Format-List. El comando Format-List usa el parámetro Property con el valor de * (todo) para mostrar todas las propiedades de los objetos en una lista. Los resultados se muestran en el siguiente ejemplo.
La presentación resultante muestra las entradas del Registro Path y ExecutionPolicy, junto con varias propiedades menos familiares del objeto de clave del Registro. Las demás propiedades, que tienen el prefijo "PS", son propiedades de objetos personalizados de Windows PowerShell, como los objetos que representan las claves del Registro.
Vea también
Conceptos
about_Providers
Set-ItemProperty
Clear-ItemProperty
Copy-ItemProperty
Move-ItemProperty
New-ItemProperty
Remove-ItemProperty
Rename-ItemProperty