about_Properties

Descripción breve

Describe cómo usar propiedades de objeto en PowerShell.

Descripción larga

PowerShell usa colecciones estructuradas de información denominada objetos para representar los elementos de los almacenes de datos o el estado del equipo. Normalmente, trabaja con objetos que forman parte de Microsoft .NET Framework, pero también puede crear objetos personalizados en PowerShell.

La asociación entre un elemento y su objeto está muy cerca. Al cambiar un objeto, normalmente se cambia el elemento que representa. Por ejemplo, cuando se obtiene un archivo en PowerShell, no se obtiene el archivo real. En su lugar, obtendrá un objeto FileInfo que representa el archivo. Al cambiar el objeto FileInfo, el archivo también cambia.

La mayoría de los objetos tienen propiedades. Las propiedades son los datos asociados a un objeto . Los distintos tipos de objeto tienen propiedades diferentes. Por ejemplo, un objeto FileInfo, que representa un archivo, tiene una propiedad IsReadOnly que contiene $True si el archivo tiene el atributo de solo lectura y $False si no lo hace. Un objeto DirectoryInfo, que representa un directorio del sistema de archivos, tiene una propiedad Parent que contiene la ruta de acceso al directorio primario.

Propiedades de objeto

Para obtener las propiedades de un objeto, use el cmdlet Get-Member. Por ejemplo, para obtener las propiedades de un objeto FileInfo, use el cmdlet Get-ChildItem para obtener el objeto FileInfo que representa un archivo. A continuación, use un operador de canalización (|) para enviar el objeto fileInfo de a Get-Member. El comando siguiente obtiene el archivo pwsh.exe y lo envía a Get-Member. La variable automática $PSHOME contiene la ruta de acceso del directorio de instalación de PowerShell.

Get-ChildItem $PSHOME\pwsh.exe | Get-Member

La salida del comando enumera los miembros del objeto FileInfo. Los miembros incluyen propiedades y métodos. Al trabajar en PowerShell, tiene acceso a todos los miembros de los objetos.

Para obtener solo las propiedades de un objeto y no los métodos, use el parámetro MemberType del cmdlet Get-Member con un valor de Property, como se muestra en el ejemplo siguiente.

Get-ChildItem $PSHOME\pwsh.exe | Get-Member -MemberType Property

TypeName: System.IO.FileInfo

Name              MemberType Definition
----              ---------- ----------
Attributes        Property   System.IO.FileAttributes Attributes {get;set;}
CreationTime      Property   System.DateTime CreationTime {get;set;}
CreationTimeUtc   Property   System.DateTime CreationTimeUtc {get;set;}
Directory         Property   System.IO.DirectoryInfo Directory {get;}
DirectoryName     Property   System.String DirectoryName {get;}
Exists            Property   System.Boolean Exists {get;}
Extension         Property   System.String Extension {get;}
FullName          Property   System.String FullName {get;}
IsReadOnly        Property   System.Boolean IsReadOnly {get;set;}
LastAccessTime    Property   System.DateTime LastAccessTime {get;set;}
LastAccessTimeUtc Property   System.DateTime LastAccessTimeUtc {get;set;}
LastWriteTime     Property   System.DateTime LastWriteTime {get;set;}
LastWriteTimeUtc  Property   System.DateTime LastWriteTimeUtc {get;set;}
Length            Property   System.Int64 Length {get;}
Name              Property   System.String Name {get;}

Después de encontrar las propiedades, puede usarlas en los comandos de PowerShell.

Valores de propiedades

Aunque cada objeto de un tipo específico tiene las mismas propiedades, los valores de esas propiedades describen el objeto determinado. Por ejemplo, cada objeto FileInfo tiene una propiedad CreationTime, pero el valor de esa propiedad difiere para cada archivo.

La forma más común de obtener los valores de las propiedades de un objeto es usar el operador de acceso a miembros (.). Escriba una referencia al objeto, como una variable que contenga el objeto o un comando que obtiene el objeto . A continuación, escriba el operador (.) seguido del nombre de propiedad.

Por ejemplo, el siguiente comando muestra el valor de la propiedad creationTime del archivo pwsh.exe. El comando Get-ChildItem devuelve un objeto FileInfo que representa el pwsh.exe file. El comando se incluye entre paréntesis para asegurarse de que se ejecuta antes de que se tenga acceso a las propiedades.

(Get-ChildItem $PSHOME\pwsh.exe).CreationTime

Tuesday, June 14, 2022 5:17:14 PM

También puede guardar un objeto en una variable y, a continuación, obtener sus propiedades mediante el método de acceso de miembro (.), como se muestra en el ejemplo siguiente:

$a = Get-ChildItem $PSHOME\pwsh.exe
$a.CreationTime

Tuesday, June 14, 2022 5:17:14 PM

También puede usar los cmdlets Select-Object y Format-List para mostrar los valores de propiedad de un objeto. Select-Object y Format-List tienen un parámetro Property. Puede usar el parámetro Property para especificar una o varias propiedades y sus valores. O bien, puede usar el carácter comodín (*) para representar todas las propiedades.

Por ejemplo, el siguiente comando muestra los valores de todas las propiedades del archivo pwsh.exe.

Get-ChildItem $PSHOME\pwsh.exe | Format-List -Property *

PSPath              : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7\pwsh.exe
PSParentPath        : Microsoft.PowerShell.Core\FileSystem::C:\Program Files\PowerShell\7
PSChildName         : pwsh.exe
PSDrive             : C
PSProvider          : Microsoft.PowerShell.Core\FileSystem
PSIsContainer       : False
Mode                : -a---
ModeWithoutHardLink : -a---
VersionInfo         : File:             C:\Program Files\PowerShell\7\pwsh.exe
                      InternalName:     pwsh.dll
                      OriginalFilename: pwsh.dll
                      FileVersion:      7.3.9.500
                      FileDescription:  pwsh
                      Product:          PowerShell
                      ProductVersion:   7.3.9 SHA: 116d193ed28dcc6914653c799846bbf379cea0fb
                      Debug:            False
                      Patched:          False
                      PreRelease:       False
                      PrivateBuild:     False
                      SpecialBuild:     False
                      Language:         Language Neutral

BaseName            : pwsh
ResolvedTarget      : C:\Program Files\PowerShell\7\pwsh.exe
Target              :
LinkType            :
Length              : 293312
DirectoryName       : C:\Program Files\PowerShell\7
Directory           : C:\Program Files\PowerShell\7
IsReadOnly          : False
FullName            : C:\Program Files\PowerShell\7\pwsh.exe
Extension           : .exe
Name                : pwsh.exe
Exists              : True
CreationTime        : 10/25/2023 7:00:18 PM
CreationTimeUtc     : 10/26/2023 12:00:18 AM
LastAccessTime      : 11/14/2023 5:14:36 PM
LastAccessTimeUtc   : 11/14/2023 11:14:36 PM
LastWriteTime       : 10/25/2023 7:00:18 PM
LastWriteTimeUtc    : 10/26/2023 12:00:18 AM
LinkTarget          :
UnixFileMode        : -1
Attributes          : Archive

Propiedades estáticas

Puede usar las propiedades estáticas de las clases de .NET en PowerShell. Las propiedades estáticas son propiedades de clase, a diferencia de las propiedades estándar, que son propiedades de un objeto.

Para obtener las propiedades estáticas de una clase, use el parámetro Static del cmdlet Get-Member. Por ejemplo, el comando siguiente obtiene las propiedades estáticas de la clase System.DateTime.

Get-Date | Get-Member -MemberType Property -Static

TypeName: System.DateTime

Name     MemberType Definition
----     ---------- ----------
MaxValue Property   static datetime MaxValue {get;}
MinValue Property   static datetime MinValue {get;}
Now      Property   datetime Now {get;}
Today    Property   datetime Today {get;}
UtcNow   Property   datetime UtcNow {get;}

Para obtener el valor de una propiedad estática, use la sintaxis siguiente.

[<ClassName>]::<Property>

Por ejemplo, el comando siguiente obtiene el valor de la UtcNow propiedad estática de la clase System.DateTime.

[System.DateTime]::UtcNow

Enumeración de acceso a miembros

A partir de PowerShell 3.0, cuando se usa el operador de acceso a miembros (.) para tener acceso a una propiedad que no existe en una colección de listas, PowerShell enumera automáticamente los elementos de la colección y devuelve el valor de la propiedad en cada elemento. Para obtener más información, consulte about_Member-Access_Enumeration.

Ejemplos

Este comando devuelve el valor de propiedad DisplayName de cada servicio que Get-Service devuelve.

(Get-Service).DisplayName

Application Experience
Application Layer Gateway Service
Windows All-User Install Agent
Application Identity
Application Information
...

Todas las colecciones tienen una propiedad Count que devuelve el número de objetos de la colección.

(Get-Service).Count

A partir de PowerShell 3.0, puede obtener la propiedad Count o Length de los objetos singleton que no son colecciones.

(Get-Service Audiosrv).Count

Sin embargo, algunos objetos tienen una propiedad Length . Por ejemplo, la longitud de una cadena es el número de caracteres en la cadena. La propiedad Count es el número de instancias del objeto .

PS> $str = 'string'
PS> $str.Length
6
PS> $str.Count
1

Si existe una propiedad en los objetos individuales y en la colección, solo se devuelve la propiedad de la colección.

$collection = @(
    [pscustomobject]@{length = "foo"}
    [pscustomobject]@{length = "bar"}
)
# PowerShell returns the collection's Length.
$collection.length

Consulte también

Last updated on 2023-11-14

Compartir a través de