PowerShell
Lavorare con gli oggetti

Aggiornamento degli oggetti

Aggiungere proprietà

Se si desidera aggiungere proprietà a un oggetto esistente, è possibile utilizzare il cmdlet Add-Member. Con PSObjects, i valori vengono mantenuti in un tipo di "Proprietà 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

È anche possibile aggiungere proprietà con Cmdlet Select-Object (le cosiddette proprietà calcolate):

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

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

Il comando sopra può essere abbreviato a questo:

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

Rimozione delle proprietà

È possibile utilizzare il cmdlet Select-Object per rimuovere le proprietà da un oggetto:

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

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

Creare un nuovo oggetto

PowerShell, a differenza di altri linguaggi di scripting, invia oggetti attraverso la pipeline. Ciò significa che quando si inviano dati da un comando a un altro, è essenziale essere in grado di creare, modificare e raccogliere oggetti.

Creare un oggetto è semplice. La maggior parte degli oggetti che crei sono oggetti personalizzati in PowerShell e il tipo da utilizzare è PSObject. PowerShell ti permetterà anche di creare qualsiasi oggetto che potresti creare in .NET.

Ecco un esempio di creazione di nuovi oggetti con alcune proprietà:

Opzione 1: nuovo oggetto

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

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

È possibile memorizzare l'oggetto in una variabile precedendo il comando con $newObject =

Potrebbe anche essere necessario memorizzare raccolte di oggetti. Questo può essere fatto creando una variabile di raccolta vuota e aggiungendo oggetti alla raccolta, in questo modo:

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

Si può quindi desiderare di ripetere questo oggetto di raccolta per oggetto. Per fare ciò, individuare la sezione Loop nella documentazione.

Opzione 2: Select-Object

Un modo meno comune di creare oggetti che troverai ancora su Internet è il seguente:

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

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

Opzione 3: acceleratore di tipo pscustomobject (richiesto PSV3 +)

L'acceleratore di tipo ordinato forza PowerShell a mantenere le nostre proprietà nell'ordine in cui le abbiamo definite. Non è necessario l'acceleratore di tipo ordinato per utilizzare [PSCustomObject] :

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

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

Esaminando un oggetto

Ora che hai un oggetto, potrebbe essere bello capire di cosa si tratta. È possibile utilizzare il cmdlet Get-Member per vedere cosa è un oggetto e cosa contiene:

Get-Item c:\windows | Get-Member

Questo produce:

TypeName: System.IO.DirectoryInfo

Seguito da un elenco di proprietà e metodi che l'oggetto ha.

Un altro modo per ottenere il tipo di un oggetto è utilizzare il metodo GetType, in questo modo:

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

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

Per visualizzare un elenco di proprietà che l'oggetto ha, insieme ai relativi valori, è possibile utilizzare il cmdlet Format-List con il parametro Property impostato su: * (che significa tutto).

Ecco un esempio, con l'output risultante:

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

Creazione di istanze di classi generiche

Nota: esempi scritti per PowerShell 5.1 È possibile creare istanze di Classi generiche

#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 

Fornisce l'output:

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

Sono anche possibili raccolte generiche

[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

Fornisce l'output:

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