PowerShell
Praca z obiektami

Aktualizowanie obiektów

Dodawanie właściwości

Jeśli chcesz dodać właściwości do istniejącego obiektu, możesz użyć polecenia cmdlet Add-Member. W przypadku obiektów PSO wartości są przechowywane w rodzaju „właściwości notatki”

$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

Możesz także dodać właściwości za pomocą polecenia cmdlet Select-Object (tak zwane właściwości obliczone):

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

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

Powyższe polecenie można skrócić do tego:

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

Usuwanie właściwości

Można użyć polecenia cmdlet Select-Object, aby usunąć właściwości z obiektu:

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

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

Tworzenie nowego obiektu

PowerShell, w przeciwieństwie do niektórych innych języków skryptowych, wysyła obiekty przez potok. Oznacza to, że gdy wysyłasz dane z jednego polecenia do drugiego, niezbędna jest możliwość tworzenia, modyfikowania i gromadzenia obiektów.

Tworzenie obiektu jest proste. Większość tworzonych obiektów będzie niestandardowymi obiektami w programie PowerShell, a typem do tego jest PSObject. PowerShell pozwoli ci również utworzyć dowolny obiekt, który możesz utworzyć w .NET.

Oto przykład tworzenia nowych obiektów z kilkoma właściwościami:

Opcja 1: nowy obiekt

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

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

Możesz zapisać obiekt w zmiennej, zastępując polecenie $newObject =

Może być również konieczne przechowywanie kolekcji obiektów. Można to zrobić, tworząc pustą zmienną kolekcji i dodając obiekty do kolekcji, na przykład:

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

Następnie możesz iterować przez ten obiekt kolekcji po obiekcie. Aby to zrobić, znajdź sekcję Pętla w dokumentacji.

Opcja 2: Wybierz obiekt

Mniej powszechny sposób tworzenia obiektów, które nadal można znaleźć w Internecie, to:

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

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

Opcja 3: akcelerator typu pscustomobject (wymagany PSv3 +)

Uporządkowany typ akceleratora zmusza PowerShell do utrzymania naszych właściwości w kolejności, w której je zdefiniowaliśmy. Nie potrzebujesz akceleratora typu uporządkowanego, aby korzystać z [PSCustomObject] :

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

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

Badanie obiektu

Teraz, gdy masz już przedmiot, warto dowiedzieć się, co to jest. Możesz użyć polecenia cmdlet Get-Member, aby zobaczyć, czym jest obiekt i co zawiera:

Get-Item c:\windows | Get-Member

Daje to:

TypeName: System.IO.DirectoryInfo

Następuje lista właściwości i metod obiektu.

Innym sposobem uzyskania typu obiektu jest użycie metody GetType, na przykład:

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

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

Aby wyświetlić listę właściwości obiektu, wraz z ich wartościami, możesz użyć polecenia cmdlet Format-List z parametrem właściwości ustawionym na: * (co oznacza wszystko).

Oto przykład z wynikowym wynikiem:

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

Tworzenie wystąpień klas ogólnych

Uwaga: przykłady napisane dla PowerShell 5.1 Możesz tworzyć instancje klas ogólnych

#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 

Daje wynik:

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

Możliwe są również kolekcje ogólne

[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

Daje wynik:

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