Get-ItemProperty
Obtiene las propiedades de un elemento especificado.
Sintaxis
Path (valor predeterminado)
Get-ItemProperty
[-Path] <String[]>
[[-Name] <String[]>]
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
LiteralPath
Get-ItemProperty
[[-Name] <String[]>]
-LiteralPath <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<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: Mostrar el nombre del valor y los datos de las entradas del Registro en una subclave del Registro
Este comando muestra el nombre de valor y los datos de cada una de las entradas del Registro contenidas en la subclave del Registro "CurrentVersion".
Tenga en cuenta que el comando requiere que haya una unidad de PowerShell denominada HKLM: que esté asignada al subárbol "HKEY_LOCAL_MACHINE" del Registro.
De forma predeterminada, en PowerShell hay disponible una unidad con ese nombre y esa asignación.
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:
"Registro:HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Windows\CurrentVersion".
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion
Ejemplo 4: 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 comando usa el parámetro Path para especificar la subclave y el parámetro Name para especificar el nombre de valor de la entrada.
El comando usa una marca de graduación inversa o énfasis grave ('), el carácter de continuación de PowerShell, para continuar con el comando en la segunda línea.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\Windows\CurrentVersion -Name "ProgramFilesDir"
Ejemplo 5: 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 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
Ejemplo 6: Obtención, formato y visualización de los resultados de los valores y datos del Registro
En este ejemplo se muestra cómo dar formato a la salida de un comando de Get-ItemProperty en una lista para facilitar la visualización de los valores y los datos del Registro y facilitar la interpretación de los resultados.
El primer comando usa el cmdlet Get-ItemProperty para obtener las entradas del Registro en la subclave de Microsoft.PowerShell.
Esta subclave almacena opciones para el shell predeterminado para PowerShell.
Los resultados se muestran en los siguientes resultados de ejemplo.
La salida muestra que hay dos entradas del Registro, "Path" y "ExecutionPolicy". Cuando una clave del Registro contiene menos de cinco entradas, de forma predeterminada se muestra en una tabla, pero a menudo es más fácil ver en una lista.
El segundo comando usa el mismo comando Get-ItemProperty.
Sin embargo, esta vez, el comando usa 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 un valor de '*' (todos) para mostrar todas las propiedades de los objetos de una lista.
Los resultados se muestran en los siguientes resultados de ejemplo.
La presentación resultante muestra las entradas del Registro "Path" y "ExecutionPolicy", junto con varias propiedades menos conocidas del objeto de clave del Registro. Las otras propiedades, prefijos con PS, son propiedades de objetos personalizados de PowerShell, como los objetos que representan las claves del Registro.
Get-ItemProperty -Path HKLM:\SOFTWARE\Microsoft\PowerShell\1\ShellIds\Microsoft.PowerShell
Path ExecutionPolicy
---- ---------------
C:\Windows\system32\WindowsPowerShell\v1.0\powershell.exe RemoteSigned
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
Parámetros
-Credential
Especifica una cuenta de usuario que tiene permiso para realizar esta acción. El valor predeterminado es el usuario actual.
Escriba un nombre de usuario, como "User01" o "Domain01\User01", o escriba un objeto de PSCredential, como uno generado por el cmdlet Get-Credential.
Si escribe un nombre de usuario, se le pedirá una contraseña.
Advertencia
Este parámetro no es compatible con ningún proveedor instalado con Windows PowerShell.
Propiedades de parámetro
| Tipo: | PSCredential |
| Valor predeterminado: | Current user |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Exclude
Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet excluye de la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento o patrón de ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Filter
Especifica un filtro en el formato o idioma del proveedor. El valor de este parámetro define 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 cuando el cmdlet obtiene los objetos en lugar de que PowerShell filtre los objetos una vez recuperados.
Propiedades de parámetro
| Tipo: | String |
| Valor predeterminado: | None |
| Admite caracteres comodín: | True |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Include
Especifica, como matriz de cadenas, un elemento o elementos que este cmdlet incluye en la operación. El valor de este parámetro define el parámetro Path. Escriba un elemento o patrón de ruta de acceso, como "*.txt". Se permite el uso de caracteres comodín.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-LiteralPath
Especifica la ruta de acceso a la ubicación actual de la propiedad. A diferencia del parámetro Path, 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 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.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PSPath |
Conjuntos de parámetros
LiteralPath
| Posición: | Named |
| Obligatorio: | True |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-Name
Especifica el nombre de la propiedad o las propiedades que se van a recuperar.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | PSProperty |
Conjuntos de parámetros
(All)
| Posición: | 1 |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
-Path
Especifica la ruta de acceso al elemento o a los elementos.
Propiedades de parámetro
| Tipo: | String[] |
| Valor predeterminado: | None |
| Admite caracteres comodín: | False |
| DontShow: | False |
Conjuntos de parámetros
Path
| Posición: | 0 |
| Obligatorio: | True |
| Valor de la canalización: | True |
| Valor de la canalización por nombre de propiedad: | True |
| Valor de los argumentos restantes: | False |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, vea Incluye el comando en la transacción activa. Este parámetro solo es válido cuando una transacción está en curso. Para obtener más información, vea about_Transactions.
Propiedades de parámetro
| Tipo: | SwitchParameter |
| Valor predeterminado: | False |
| Admite caracteres comodín: | False |
| DontShow: | False |
| Alias: | usetx |
Conjuntos de parámetros
(All)
| Posición: | Named |
| Obligatorio: | False |
| Valor de la canalización: | False |
| Valor de la canalización por nombre de propiedad: | False |
| Valor de los argumentos restantes: | False |
CommonParameters
Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para obtener más información, vea about_CommonParameters.
Entradas
String
Puede canalizar una cadena que contenga una ruta de acceso a Get-ItemProperty.
Salidas
System.Boolean, System.String, System.DateTime
Get-ItemProperty 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, puede devolver un archivo o una carpeta.
Notas
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, consulte about_Providers.