PowerShell
Trabajando con objetos

Actualizando objetos

Añadiendo propiedades

Si desea agregar propiedades a un objeto existente, puede usar el cmdlet Add-Member. Con PSObjects, los valores se mantienen en un tipo de "Propiedades de nota"

$object = New-Object -TypeName PSObject -Property @{
        Name = $env:username
        ID = 12
        Address = $null
    }

Add-Member -InputObject $object -Name "SomeNewProp" -Value "A value" -MemberType NoteProperty

# Returns
PS> $Object
Name ID Address SomeNewProp
---- -- ------- -----------
nem  12         A value

También puede agregar propiedades con el Cmdlet Select-Object (denominados propiedades calculadas):

$newObject = $Object | Select-Object *, @{label='SomeOtherProp'; expression={'Another value'}}

# Returns
PS> $newObject
Name ID Address SomeNewProp SomeOtherProp
---- -- ------- ----------- -------------
nem  12         A value     Another value

El comando anterior se puede acortar a esto:

$newObject = $Object | Select *,@{l='SomeOtherProp';e={'Another value'}}

Eliminando propiedades

Puede usar el Cmdlet Seleccionar objeto para eliminar propiedades de un objeto:

$object = $newObject | Select-Object * -ExcludeProperty ID, Address

# Returns
PS> $object
Name SomeNewProp SomeOtherProp
---- ----------- -------------
nem  A value     Another value

Creando un nuevo objeto

PowerShell, a diferencia de otros lenguajes de scripting, envía objetos a través de la tubería. Lo que esto significa es que cuando envía datos de un comando a otro, es esencial poder crear, modificar y recopilar objetos.

Crear un objeto es simple. La mayoría de los objetos que cree serán objetos personalizados en PowerShell, y el tipo a usar para eso es PSObject. PowerShell también te permitirá crear cualquier objeto que puedas crear en .NET.

Aquí hay un ejemplo de cómo crear nuevos objetos con algunas propiedades:

Opción 1: Nuevo objeto

$newObject = New-Object -TypeName PSObject -Property @{
    Name = $env:username
    ID = 12
    Address = $null
}

# Returns
PS> $newObject
Name ID Address
---- -- -------
nem  12

Puede almacenar el objeto en una variable precediendo el comando con $newObject =

También puede ser necesario almacenar colecciones de objetos. Esto se puede hacer creando una variable de colección vacía y agregando objetos a la colección, así:

$newCollection = @()
$newCollection += New-Object -TypeName PSObject -Property @{
    Name = $env:username
    ID = 12
    Address = $null
}

Es posible que desee recorrer esta colección objeto por objeto. Para ello, localice la sección Loop en la documentación.

Opción 2: Seleccionar objeto

Una forma menos común de crear objetos que todavía encontrará en Internet es la siguiente:

$newObject = 'unuseddummy' | Select-Object -Property Name, ID, Address
$newObject.Name = $env:username
$newObject.ID = 12

# Returns
PS> $newObject
Name ID Address
---- -- -------
nem  12

Opción 3: acelerador de tipo pscustomobject (se requiere PSv3 +)

El acelerador de tipo ordenado obliga a PowerShell a mantener nuestras propiedades en el orden en que las definimos. No necesita el acelerador de tipos ordenado para usar [PSCustomObject] :

$newObject = [PSCustomObject][Ordered]@{
    Name = $env:Username
    ID = 12
    Address = $null
}

# Returns
PS> $newObject
Name ID Address
---- -- -------
nem  12

Examinando un objeto

Ahora que tiene un objeto, podría ser bueno averiguar qué es. Puede usar el cmdlet Get-Member para ver qué es un objeto y qué contiene:

Get-Item c:\windows | Get-Member

Esto produce:

TypeName: System.IO.DirectoryInfo

Seguido de una lista de propiedades y métodos que tiene el objeto.

Otra forma de obtener el tipo de un objeto es usar el método GetType, así:

C:\> $Object = Get-Item C:\Windows
C:\> $Object.GetType()

IsPublic IsSerial Name                                     BaseType
-------- -------- ----                                     --------
True     True     DirectoryInfo                            System.IO.FileSystemInfo

Para ver una lista de propiedades que tiene el objeto, junto con sus valores, puede usar el cmdlet Format-List con su parámetro de propiedad establecido en: * (es decir, todo).

Aquí hay un ejemplo, con el resultado resultante:

C:\> Get-Item C:\Windows | Format-List -Property *


PSPath            : Microsoft.PowerShell.Core\FileSystem::C:\Windows
PSParentPath      : Microsoft.PowerShell.Core\FileSystem::C:\
PSChildName       : Windows
PSDrive           : C
PSProvider        : Microsoft.PowerShell.Core\FileSystem
PSIsContainer     : True
Mode              : d-----
BaseName          : Windows
Target            : {}
LinkType          :
Name              : Windows
Parent            :
Exists            : True
Root              : C:\
FullName          : C:\Windows
Extension         :
CreationTime      : 30/10/2015 06:28:30
CreationTimeUtc   : 30/10/2015 06:28:30
LastAccessTime    : 16/08/2016 17:32:04
LastAccessTimeUtc : 16/08/2016 16:32:04
LastWriteTime     : 16/08/2016 17:32:04
LastWriteTimeUtc  : 16/08/2016 16:32:04
Attributes        : Directory

Creación de instancias de clases genéricas

Nota: ejemplos escritos para PowerShell 5.1. Puede crear instancias de clases genéricas.

#Nullable System.DateTime
[Nullable[datetime]]$nullableDate = Get-Date -Year 2012
$nullableDate
$nullableDate.GetType().FullName
$nullableDate = $null
$nullableDate

#Normal System.DateTime
[datetime]$aDate = Get-Date -Year 2013
$aDate
$aDate.GetType().FullName
$aDate = $null #Throws exception when PowerShell attempts to convert null to 

Da la salida:

Saturday, 4 August 2012 08:53:02
System.DateTime
Sunday, 4 August 2013 08:53:02
System.DateTime
Cannot convert null to type "System.DateTime".
At line:14 char:1
+ $aDate = $null
+ ~~~~~~~~~~~~~~
    + CategoryInfo          : MetadataError: (:) [], ArgumentTransformationMetadataException
    + FullyQualifiedErrorId : RuntimeException

Colecciones genéricas también son posibles

[System.Collections.Generic.SortedDictionary[int, String]]$dict = [System.Collections.Generic.SortedDictionary[int, String]]::new()
$dict.GetType().FullName

$dict.Add(1, 'a')
$dict.Add(2, 'b')
$dict.Add(3, 'c')


$dict.Add('4', 'd') #powershell auto converts '4' to 4
$dict.Add('5.1', 'c') #powershell auto converts '5.1' to 5

$dict

$dict.Add('z', 'z') #powershell can't convert 'z' to System.Int32 so it throws an error

Da la salida:

System.Collections.Generic.SortedDictionary`2[[System.Int32, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089],[System.String, mscorlib, Version=4.0.0.0, Culture=neutral, PublicKeyToken=b77a5c561934e089]]

Key Value
--- -----
  1 a
  2 b
  3 c
  4 d
  5 c
Cannot convert argument "key", with value: "z", for "Add" to type "System.Int32": "Cannot convert value "z" to type "System.Int32". Error: "Input string was not in a correct format.""
At line:15 char:1
+ $dict.Add('z', 'z') #powershell can't convert 'z' to System.Int32 so  ...
+ ~~~~~~~~~~~~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [], MethodException
    + FullyQualifiedErrorId : MethodArgumentConversionInvalidCastArgument