Get-ItemPropertyValue
Obtiene el valor de una o varias propiedades de un elemento especificado.
Sintaxis
Get-ItemPropertyValue
[[-Path] <String[]>]
[-Name] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Get-ItemPropertyValue
-LiteralPath <String[]>
[-Name] <String[]>
[-Filter <String>]
[-Include <String[]>]
[-Exclude <String[]>]
[-Credential <PSCredential>]
[-UseTransaction]
[<CommonParameters>]
Description
Get-ItemPropertyValue
Obtiene el valor actual de una propiedad que se especifica al usar el parámetro Name, ubicado en una ruta de acceso que especifique con los parámetros Path o LiteralPath.
Ejemplos
Ejemplo 1: Obtener el valor de la propiedad ProductID
Este comando obtiene el valor de la propiedad ProductID del \SOFTWARE\Microsoft\WindowsNT\CurrentVersion
objeto en el proveedor del Registro de Windows.
Get-ItemPropertyValue 'HKLM:\SOFTWARE\Microsoft\Windows NT\CurrentVersion' -Name ProductID
94253-50000-11141-AA785
Ejemplo 2: Obtener la última hora de escritura de un archivo o carpeta
Este comando obtiene el valor de la propiedad LastWriteTime o la última vez que se cambió un archivo o carpeta, desde la C:\Program Files\WindowsPowerShell
carpeta , trabajando en el proveedor FileSystem.
Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -Name LastWriteTime
Wednesday, September 3, 2014 2:53:22 PM
Ejemplo 3: Obtener varios valores de propiedad de un archivo o carpeta
Este comando obtiene los valores de las propiedades LastWriteTime, CreationTime y Root de una carpeta. Los valores de propiedad se devuelven en el orden en que especificó los nombres de propiedad.
Get-ItemPropertyValue -Path 'C:\Program Files\WindowsPowerShell' -Name LastWriteTime,CreationTime,Root
Tuesday, March 23, 2021 6:53:13 AM
Monday, August 14, 2017 1:42:40 PM
Name : C:\
FullName : C:\
Parent :
Exists : True
Root : C:\
Extension :
CreationTime : 10/30/2015 1:28:30 AM
CreationTimeUtc : 10/30/2015 6:28:30 AM
LastAccessTime : 5/26/2021 9:24:31 AM
LastAccessTimeUtc : 5/26/2021 2:24:31 PM
LastWriteTime : 5/25/2021 7:25:08 AM
LastWriteTimeUtc : 5/25/2021 12:25:08 PM
Attributes : Hidden, System, Directory
Mode : d--hs-
BaseName : C:\
Target : {}
LinkType :
Parámetros
-Credential
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 "User01" o "Domain01\User01" o escriba un objeto PSCredential , como uno generado por el Get-Credential
cmdlet. Si escribe un nombre de usuario, se le pedirá una contraseña.
Advertencia
Este parámetro no es compatible con los proveedores instalados con Windows PowerShell.
Tipo: | PSCredential |
Posición: | Named |
Valor predeterminado: | None |
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 de la operación. El valor de este parámetro califica el parámetro Path . Escriba un elemento de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
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 en el formato o idioma 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 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 de ruta de acceso o un patrón, como "*.txt". Se permite el uso de caracteres comodín.
Tipo: | String[] |
Posición: | Named |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | True |
-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 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.
Tipo: | String[] |
Alias: | PSPath |
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.
Tipo: | String[] |
Alias: | PSProperty |
Posición: | 1 |
Valor predeterminado: | None |
Requerido: | True |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
-Path
Especifica la ruta de acceso al elemento o elementos.
Tipo: | String[] |
Posición: | 0 |
Valor predeterminado: | None |
Requerido: | False |
Aceptar entrada de canalización: | True |
Aceptar caracteres comodín: | False |
-UseTransaction
Incluye el comando en la transacción activa. Este parámetro solo es válido cuando hay una transacción en curso. Para obtener más información, consulte about_Transactions.
Tipo: | SwitchParameter |
Alias: | usetx |
Posición: | Named |
Valor predeterminado: | False |
Requerido: | False |
Aceptar entrada de canalización: | False |
Aceptar caracteres comodín: | False |
Entradas
Puede canalizar una cadena que contenga una ruta de acceso a este cmdlet.
Salidas
Este cmdlet devuelve un objeto para cada valor de propiedad de elemento que obtiene. El tipo de objeto depende del valor de propiedad que se recupera.
Notas
Windows PowerShell incluye los siguientes alias para Get-ItemPropertyValue
:
gpv
Este cmdlet está diseñado para trabajar con los datos expuestos por cualquier proveedor. Para enumerar los proveedores disponibles en la sesión, ejecute el Get-PSProvider
cmdlet . Para obtener más información, consulte about_Providers.