about_Arrays

Artikel
05/09/2024

Kurze Beschreibung

Beschreibt Arrays, bei denen es sich um Datenstrukturen handelt, die zum Speichern von Auflistungen von Elementen konzipiert sind.

Lange Beschreibung

Ein Array ist eine Datenstruktur, die zum Speichern einer Auflistung von Elementen konzipiert ist. Bei den Elementen kann es sich um denselben Typ oder um unterschiedliche Typen handeln.

Ab Windows PowerShell 3.0 weist eine Auflistung von null oder einem Objekt einige Eigenschaften von Arrays auf.

Erstellen und Initialisieren eines Arrays

Um ein Array zu erstellen und zu initialisieren, weisen Sie einer Variablen mehrere Werte zu. Die im Array gespeicherten Werte werden durch ein Komma getrennt und vom Variablennamen durch den Zuweisungsoperator (=) getrennt.

Um beispielsweise ein Array mit dem Namen $A zu erstellen, das die sieben numerischen (ganzzahligen) Werte 22, 5, 10, 8, 12, 9 und 80 enthält, geben Sie Folgendes ein:

$A = 22,5,10,8,12,9,80

Das Komma kann auch verwendet werden, um ein einzelnes Elementarray zu initialisieren, indem das Komma vor dem einzelnen Element platziert wird.

Geben Sie beispielsweise Folgendes ein, um ein einzelnes Elementarray mit dem Namen $B zu erstellen, das den einzelnen Wert 7 enthält:

$B = ,7

Sie können ein Array auch mit dem Bereichsoperator (..) erstellen und initialisieren. Im folgenden Beispiel wird ein Array mit den Werten 5 bis 8 erstellt.

$C = 5..8

Enthält daher $C vier Werte: 5, 6, 7 und 8.

Wenn kein Datentyp angegeben wird, erstellt PowerShell jedes Array als Objektarray (System.Object[]). Verwenden Sie die -Methode, um den GetType() Datentyp eines Arrays zu bestimmen. Beispiel:

$A.GetType()

Um ein stark typisiertes Array zu erstellen, d. h. ein Array, das nur Werte eines bestimmten Typs enthalten kann, wandeln Sie die Variable als Arraytyp um, z. B. string[], long[]oder int32[]. Um ein Array umzuschichten, stellen Sie dem Variablennamen einen Arraytyp voran, der in Klammern eingeschlossen ist. Beispiel:

[int32[]]$ia = 1500, 2230, 3350, 4000

Daher kann das $ia Array nur ganze Zahlen enthalten.

Sie können Arrays erstellen, die in jeden unterstützten Typ in .NET umgewandelt werden. Beispielsweise sind die Objekte, die zur Darstellung von Prozessen abgerufen werden, Get-Process vom Typ System.Diagnostics.Process . Geben Sie den folgenden Befehl ein, um ein stark typisiertes Array von Prozessobjekten zu erstellen:

[Diagnostics.Process[]]$zz = Get-Process

Der Arrayunterausdruckoperator

Der Array-Unterausdruckoperator erstellt ein Array aus den darin enthaltenen Anweisungen. Unabhängig davon, was die Anweisung im Operator erzeugt, platziert der Operator sie in einem Array. Auch wenn es null oder ein Objekt gibt.

Die Syntax des Arrayoperators lautet wie folgt:

@( ... )

Sie können den Arrayoperator verwenden, um ein Array mit null oder einem Objekt zu erstellen. Beispiel:

$a = @("Hello World")
$a.Count

$b = @()
$b.Count

Der Arrayoperator ist in Skripts nützlich, wenn Sie Objekte erhalten, aber nicht wissen, wie viele zu erwarten sind. Beispiel:

$p = @(Get-Process Notepad)

Weitere Informationen zum Arrayunterausdruckoperator finden Sie unter about_Operators.

Zugreifen auf und Verwenden von Arrayelementen

Lesen eines Arrays

Sie können mithilfe des Variablennamens auf ein Array verweisen. Rufen Sie den Arraynamen auf, um alle Elemente im Array anzuzeigen. Beispiel $a : Ist ein Array der Zahlen 0 bis 9:

$a

Sie können mithilfe eines Indexes auf die Elemente in einem Array verweisen. Schließen Sie die Indexnummer in Klammern ein. Indexwerte beginnen bei 0. Geben Sie beispielsweise Folgendes ein, um das erste Element im $a Array anzuzeigen:

$a[0]

Geben Sie Folgendes ein, um das $a dritte Element im Array anzuzeigen:

$a[2]

Sie können einen Teil des Arrays mithilfe eines Bereichsoperators für den Index abrufen. Um beispielsweise die zweiten bis fünften Elemente des Arrays abzurufen, geben Sie Folgendes ein:

$a[1..4]

Anzahl negativer Zahlen vom Ende des Arrays. bezieht sich beispielsweise -1 auf das letzte Element des Arrays. Geben Sie folgendes ein, um die letzten drei Elemente des Arrays in aufsteigender Reihenfolge des Indexes anzuzeigen:

$a = 0 .. 9
$a[-3..-1]

7
8
9

Wenn Sie negative Indizes in absteigender Reihenfolge eingeben, ändert sich Ihre Ausgabe.

$a = 0 .. 9
$a[-1..-3]

9
8
7

Seien Sie jedoch vorsichtig, wenn Sie diese Notation verwenden. Die Notationszyklen von der Endgrenze bis zum Anfang des Arrays.

$a = 0 .. 9
$a[2..-2]

Außerdem besteht ein häufiger Fehler darin, davon auszugehen, dass $a[0..-2] sich auf alle Elemente des Arrays mit Ausnahme des letzten bezieht. Es bezieht sich auf die ersten, letzten und vorletzten Elemente im Array.

Sie können den Plusoperator (+) verwenden, um einen Bereich mit einer Liste von Elementen in einem Array zu kombinieren. Geben Sie beispielsweise Folgendes ein, um die Elemente an den Indexpositionen 0, 2 und 4 bis 6 anzuzeigen:

$a = 0 .. 9
$a[0,2+4..6]

Außerdem können Sie den Plusoperator verwenden, um mehrere Bereiche und einzelne Elemente aufzulisten. So listen Sie z. B. die Elemente null bis zwei, vier bis sechs und das Element an der achten Position ein:

$a = 0..9
$a[+0..2+4..6+8]

Iterationen über Arrayelemente

Sie können auch Schleifenkonstrukte wie foreach, forund while Schleifen verwenden, um auf die Elemente in einem Array zu verweisen. Um beispielsweise eine foreach Schleife zum Anzeigen der Elemente im $a Array zu verwenden, geben Sie Folgendes ein:

$a = 0..9
foreach ($element in $a) {
  $element
}

Die foreach Schleife durchläuft das Array und gibt jeden Wert im Array zurück, bis das Ende des Arrays erreicht wird.

Die for Schleife ist nützlich, wenn Sie Zähler erhöhen, während Sie die Elemente in einem Array untersuchen. Wenn Sie beispielsweise eine for Schleife verwenden möchten, um jeden anderen Wert in einem Array zurückzugeben, geben Sie Folgendes ein:

$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
  $a[$i]
}

Sie können eine while Schleife verwenden, um die Elemente in einem Array anzuzeigen, bis eine definierte Bedingung nicht mehr wahr ist. Geben Sie beispielsweise Folgendes ein, um die Elemente im $a Array anzuzeigen, während der Arrayindex kleiner als 4 ist:

$a = 0..9
$i=0
while($i -lt 4) {
  $a[$i]
  $i++
}

Eigenschaften von Arrays

Count oder Length oder LongLength

Um zu bestimmen, wie viele Elemente sich in einem Array befinden, verwenden Sie die -Eigenschaft oder den Length zugehörigen Count Alias. Longlength ist nützlich, wenn das Array mehr als 2.147.483.647 Elemente enthält.

$a = 0..9
$a.Count
$a.Length

10
10

Rank

Gibt die Anzahl der Dimensionen des Arrays zurück. Die meisten Arrays in PowerShell weisen nur eine Dimension auf. Auch wenn Sie denken, dass Sie ein mehrdimensionales Array wie im folgenden Beispiel erstellen:

$a = @(
  @(0,1),
  @("b", "c"),
  @(Get-Process)
)

"`$a rank: $($a.Rank)"
"`$a length: $($a.Length)"
"`$a[2] length: $($a[2].Length)"
"Process `$a[2][1]: $($a[2][1].ProcessName)"

In diesem Beispiel erstellen Sie ein eindimensionales Array, das andere Arrays enthält. Dies wird auch als gezacktes Array bezeichnet. Die Rank Eigenschaft hat bewiesen, dass dies eindimensional ist. Für den Zugriff auf Elemente in einem gezackten Array müssen sich die Indizes in separaten Klammern befinden ([]).

$a rank: 1
$a length: 3
$a[2] length: 348
Process $a[2][1]: AcroRd32

Mehrdimensionale Arrays werden in Zeilen-Hauptreihenfolge gespeichert. Das folgende Beispiel zeigt, wie Sie ein wirklich mehrdimensionales Array erstellen.

[string[,]]$rank2 = [string[,]]::New(3,2)
$rank2.rank
$rank2.Length
$rank2[0,0] = 'a'
$rank2[0,1] = 'b'
$rank2[1,0] = 'c'
$rank2[1,1] = 'd'
$rank2[2,0] = 'e'
$rank2[2,1] = 'f'
$rank2[1,1]

2
6
d

Um auf Elemente in einem mehrdimensionalen Array zuzugreifen, trennen Sie die Indizes mithilfe eines Kommas (,) innerhalb einer einzelnen Gruppe von Klammern ([]).

Für einige Vorgänge für ein mehrdimensionales Array, z. B. Replikation und Verkettung, muss dieses Array geflacht werden. Durch das Flatten wird das Array in ein 1-dimensionales Array des nicht eingeschränkten Typs umgewandelt. Das resultierende Array übernimmt alle Elemente in zeilengerichteter Reihenfolge. Betrachten Sie das folgenden Beispiel:

$a = "red",$true
$b = (New-Object 'int[,]' 2,2)
$b[0,0] = 10
$b[0,1] = 20
$b[1,0] = 30
$b[1,1] = 40
$c = $a + $b
$a.GetType().Name
$b.GetType().Name
$c.GetType().Name
$c

Die Ausgabe zeigt, dass es $c sich um ein 1-dimensionales Array handelt, das die Elemente aus $a und $b in Zeilen-Hauptreihenfolge enthält.

Object[]
Int32[,]
Object[]
red
True
10
20
30
40

Methoden von Arrays

Clear

Legt alle Elementwerte auf den Standardwert des Elementtyps des Arrays fest. Die Clear() -Methode setzt die Größe des Arrays nicht zurück.

Im folgenden Beispiel $a ist ein Array von -Objekten dargestellt.

$a = 1, 2, 3
$a.Clear()
$a | % { $null -eq $_ }

True
True
True

In diesem Beispiel wird explizit eingegeben, $intA um ganze Zahlen zu enthalten.

[int[]] $intA = 1, 2, 3
$intA.Clear()
$intA

0
0
0

ForEach()

Ermöglicht das Durchlaufen aller Elemente im Array und das Ausführen eines bestimmten Vorgangs für jedes Element des Arrays.

Die ForEach() Methode verfügt über mehrere Überladungen, die unterschiedliche Vorgänge ausführen.

ForEach(scriptblock expression)
ForEach(scriptblock expression, object[] arguments)
ForEach(type convertToType)
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
ForEach(string methodName)
ForEach(string methodName, object[] arguments)

ForEach(scriptblock-Ausdruck)

ForEach(scriptblock-Ausdruck, Object[]-Argumente)

Diese Methode wurde in PowerShell v4 hinzugefügt.

Hinweis

Die Syntax erfordert die Verwendung eines Skriptblocks. Klammern sind optional, wenn der scriptblock der einzige Parameter ist. Außerdem darf kein Leerzeichen zwischen der Methode und der öffnenden Klammer oder geschweiften Klammer vorhanden sein.

Das folgende Beispiel zeigt, wie die -Methode verwendet wird ForEach() . In diesem Fall besteht die Absicht darin, den Quadratwert der Elemente im Array zu generieren.

$a = @(0 .. 3)
$a.ForEach({ $_ * $_})

Genau wie der ArgumentList-Parameter von ForEach-Objectermöglicht der arguments Parameter die Übergabe eines Arrays von Argumenten an einen Skriptblock, der für deren Annahme konfiguriert ist.

Weitere Informationen zum Verhalten von ArgumentList finden Sie unter about_Splatting.

ForEach(typ convertToType)

Die ForEach() -Methode kann verwendet werden, um die Elemente in einen anderen Typ umzuwandeln. Das folgende Beispiel zeigt, wie eine Liste von Zeichenfolgendaten in einen [DateTime] Typ konvertiert wird.

("1/1/2017", "2/1/2017", "3/1/2017").ForEach([datetime])


Sunday, January 1, 2017 12:00:00 AM
Wednesday, February 1, 2017 12:00:00 AM
Wednesday, March 1, 2017 12:00:00 AM

ForEach(string propertyName)

ForEach(string propertyName, object[] newValue)

Die ForEach() -Methode kann auch verwendet werden, um Eigenschaftswerte für jedes Element in der Auflistung abzurufen oder festzulegen.

# Set all LastAccessTime properties of files to the current date.
(dir 'C:\Temp').ForEach('LastAccessTime', (Get-Date))
# View the newly set LastAccessTime of all items, and find Unique entries.
(dir 'C:\Temp').ForEach('LastAccessTime') | Get-Unique

Wednesday, June 20, 2018 9:21:57 AM

ForEach(string methodName)

ForEach(string methodName, object[] arguments)

Lastly, Methoden können verwendet werden, ForEach() um eine Methode für jedes Element in der Auflistung auszuführen.

("one", "two", "three").ForEach("ToUpper")

ONE
TWO
THREE

Genau wie der ArgumentList-Parameter von ForEach-Objectermöglicht der arguments Parameter die Übergabe eines Arrays von Werten an einen Skriptblock, der so konfiguriert ist, dass er sie akzeptiert.

Hinweis

Ab Windows PowerShell 3.0 können Eigenschaften und Ausführungsmethoden für jedes Element in einer Auflistung auch mithilfe von "Methoden von Skalarobjekten und Auflistungen" abgerufen werden. Weitere Informationen dazu finden Sie hier about_Methods.

Where()

Ermöglicht das Filtern oder Auswählen der Elemente des Arrays. Das Skript muss auf einen anderen Wert als null (0), leere Zeichenfolge oder $null für das Element ausgewertet werden, $false das nach dem Where()angezeigt wird. Weitere Informationen zur booleschen Auswertung finden Sie unter about_Booleans.

Es gibt eine Definition für die Where() -Methode.

Where(scriptblock expression[, WhereOperatorSelectionMode mode
                            [, int numberToReturn]])

Hinweis

ist Expression ein Skriptblock, der zum Filtern erforderlich ist, das mode optionale Argument ermöglicht zusätzliche Auswahlfunktionen, und das numberToReturn optionale Argument ermöglicht die Möglichkeit, die Anzahl der elemente zu begrenzen, die vom Filter zurückgegeben werden.

Der Wert von mode muss ein WhereOperatorSelectionMode-Enumerationswert sein:

Default (0) – Zurückgeben aller Elemente
First (1) – Zurückgeben des ersten Elements
Last (2) – Zurückgeben des letzten Elements
SkipUntil (3) – Elemente überspringen, bis die Bedingung wahr ist, alle verbleibenden Elemente zurückgeben (einschließlich des ersten Elements, für das die Bedingung wahr ist)
Until (4) – Gibt alle Elemente zurück, bis die Bedingung erfüllt ist.
Split (5) – Gibt ein Array von zwei Elementen zurück.
- Das erste Element enthält übereinstimmende Elemente.
- Das zweite Element enthält die verbleibenden Elemente.

Das folgende Beispiel zeigt, wie Sie alle ungeraden Zahlen aus dem Array auswählen.

(0..9).Where{ $_ % 2 }

In diesem Beispiel wird gezeigt, wie Die Zeichenfolgen ausgewählt werden, die nicht leer sind.

('hi', '', 'there').Where({$_.Length})

hi
there

Default

Der Default Modus filtert Elemente mithilfe des Expression Skriptblocks.

Wenn ein numberToReturn bereitgestellt wird, wird die maximale Anzahl von Elementen angegeben, die zurückgegeben werden sollen.

# Get the zip files in the current users profile, sorted by LastAccessTime
$Zips = dir $env:userprofile -Recurse '*.zip' | Sort-Object LastAccessTime
# Get the least accessed file over 100MB
$Zips.Where({$_.Length -gt 100MB}, 'Default', 1)

Hinweis

Sowohl der Modus als First auch der Default Modus geben die ersten (numberToReturn) Elemente zurück und können austauschbar verwendet werden.

Last

$h = (Get-Date).AddHours(-1)
$logs = dir 'C:\' -Recurse '*.log' | Sort-Object CreationTime
# Find the last 5 log files created in the past hour
$logs.Where({$_.CreationTime -gt $h}, 'Last', 5)

SkipUntil

Der SkipUntil Modus überspringt alle Objekte in einer Auflistung, bis ein Objekt den Skriptblockausdrucksfilter übergibt. Anschließend werden ALLE verbleibenden Sammlungselemente zurückgegeben, ohne sie zu testen. Es wird nur ein bestandenes Element getestet.

Dies bedeutet, dass die zurückgegebene Auflistung sowohl übergebende als auch nicht übergebende Elemente enthält, die NICHT getestet wurden.

Die Anzahl der zurückgegebenen Elemente kann begrenzt werden, indem ein Wert an das numberToReturn Argument übergeben wird.

$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)

localhost

Until

Der Until Modus invertiert den SkipUntil Modus. Es gibt ALLE Elemente in einer Auflistung zurück, bis ein Element den Skriptblockausdruck übergibt. Sobald ein Element den scriptblock-Ausdruck übergibt , beendet die Methode die Where() Verarbeitung von Elementen.

Dies bedeutet, dass Sie den ersten Satz nicht übergebener Elemente von der Where() -Methode erhalten. Nachdem ein Element bestanden wurde, wird der Rest NICHT getestet oder zurückgegeben.

Die Anzahl der zurückgegebenen Elemente kann begrenzt werden, indem ein Wert an das numberToReturn Argument übergeben wird.

# Retrieve the first set of numbers less than or equal to 10.
(1..50).Where({$_ -gt 10}, 'Until')
# This would perform the same operation.
(1..50).Where({$_ -le 10})

Hinweis

SkipUntil Sowohl als auch Until arbeiten unter der Prämisse, dass KEIN Batch von Elementen getestet wird.

Until gibt die Elemente VOR dem ersten PASS zurück. SkipUntil gibt alle Elemente nach dem ersten Durchlauf zurück, einschließlich des ersten Übergebens.

Split

Im Split Modus werden Sammlungselemente in zwei separate Auflistungen aufgeteilt oder gruppiert. Diejenigen, die den scriptblock-Ausdruck übergeben, und diejenigen, die dies nicht tun.

Wenn angegeben numberToReturn wird, enthält die erste Auflistung die übergebenden Elemente, die den angegebenen Wert nicht überschreiten sollen.

Die restlichen Objekte, auch diejenigen, die den Ausdrucksfilter übergeben , werden in der zweiten Auflistung zurückgegeben.

$running, $stopped = (Get-Service).Where({$_.Status -eq 'Running'}, 'Split')
$running

Status   Name               DisplayName
------   ----               -----------
Running  Appinfo            Application Information
Running  AudioEndpointBu... Windows Audio Endpoint Builder
Running  Audiosrv           Windows Audio
...

$stopped

Status   Name               DisplayName
------   ----               -----------
Stopped  AJRouter           AllJoyn Router Service
Stopped  ALG                Application Layer Gateway Service
Stopped  AppIDSvc           Application Identity
...

Hinweis

Sowohl als auch ForEach() methoden Where() sind systeminterne Member. Weitere Informationen zu systeminternen Membern finden Sie unter about_Instrinsic_Members.

Abrufen der Member eines Arrays

Verwenden Sie den InputObject-Parameter des Cmdlets, um die Eigenschaften und Methoden eines Arrays abzurufen, zLength. B. die -Eigenschaft und die Get-MemberSetValue-Methode.

Wenn Sie ein Array an Get-Memberübergeben, sendet PowerShell die Elemente einzeln und Get-Member gibt den Typ jedes Elements im Array zurück (Duplikate werden ignoriert).

Wenn Sie den InputObject-Parameter verwenden, Get-Member gibt die Member des Arrays zurück.

Der folgende Befehl ruft beispielsweise die Member der $a Arrayvariablen ab.

Get-Member -InputObject $a

Sie können auch die Member eines Arrays abrufen, indem Sie ein Komma (,) vor dem Wert eingeben, der an das Get-Member Cmdlet übergeben wird. Das Komma macht das Array zum zweiten Element in einem Array von Arrays. PowerShell leitet die Arrays einzeln weiter und Get-Member gibt die Member des Arrays zurück. Wie in den nächsten beiden Beispielen.

,$a | Get-Member

,(1,2,3) | Get-Member

Bearbeiten eines Arrays

Sie können die Elemente in einem Array ändern, einem Array ein Element hinzufügen und die Werte aus zwei Arrays in einem dritten Array kombinieren.

Um den Wert eines bestimmten Elements in einem Array zu ändern, geben Sie den Arraynamen und den Index des Elements an, das Sie ändern möchten, und verwenden Sie dann den Zuweisungsoperator (=), um einen neuen Wert für das Element anzugeben. Um beispielsweise den Wert des zweiten Elements im Array (Indexposition 1) in $a 10 zu ändern, geben Sie Folgendes ein:

$a[1] = 10

Sie können auch die SetValue-Methode eines Arrays verwenden, um einen Wert zu ändern. Im folgenden Beispiel wird der zweite Wert (Indexposition 1) des $a Arrays in 500 geändert:

$a.SetValue(500,1)

Sie können den += Operator verwenden, um einem Array ein Element hinzuzufügen. Das folgende Beispiel zeigt, wie Sie dem $a Array ein Element hinzufügen.

$a = @(0..4)
$a += 5

Hinweis

Wenn Sie den += Operator verwenden, erstellt PowerShell tatsächlich ein neues Array mit den Werten des ursprünglichen Arrays und dem hinzugefügten Wert. Dies kann zu Leistungsproblemen führen, wenn der Vorgang mehrmals wiederholt wird oder die Größe des Arrays zu groß ist.

Es ist nicht einfach, Elemente aus einem Array zu löschen, aber Sie können ein neues Array erstellen, das nur ausgewählte Elemente eines vorhandenen Arrays enthält. Um beispielsweise das $t Array mit allen Elementen im $a Array mit Ausnahme des Werts an Indexposition 2 zu erstellen, geben Sie Folgendes ein:

$t = $a[0,1 + 3..($a.length - 1)]

Um zwei Arrays in einem einzelnen Array zu kombinieren, verwenden Sie den Plusoperator (+). Im folgenden Beispiel werden zwei Arrays erstellt, kombiniert und dann das resultierende kombinierte Array angezeigt.

$x = 1,3
$y = 5,9
$z = $x + $y

Daher enthält das $z Array 1, 3, 5 und 9.

Um ein Array zu löschen, weisen Sie dem Array den Wert zu $null . Der folgende Befehl löscht das Array in der $a Variablen.

$a = $null

Sie können auch das Remove-Item Cmdlet verwenden, aber das Zuweisen des Werts von $null ist schneller, insbesondere für große Arrays.

Arrays von 0 oder 1

Ab Windows PowerShell 3.0 verfügt eine Auflistung von null oder einem Objekt über die Count Eigenschaften undLength. Außerdem können Sie in einem Array eines Objekts indiziert werden. Dieses Feature hilft Ihnen, Skriptfehler zu vermeiden, die auftreten, wenn ein Befehl, der eine Sammlung erwartet, weniger als zwei Elemente erhält.

Das folgende Beispiel zeigt, dass eine Variable, die keine -Objekte enthält, über und CountLength von 0 verfügt.

PS> $a = $null
PS> $a.Count
0
PS> $a.Length
0

Das folgende Beispiel zeigt, dass eine Variable, die ein -Objekt enthält, über und CountLength von 1 verfügt. Sie können auch die Arrayindizierung verwenden, um auf den Wert des Objekts zuzugreifen.

PS> $a = 4
PS> $a.Count
1
PS> $a.Length
1
PS> $a[0]
4
PS> $a[-1]
4

Wenn Sie einen Befehl ausführen, der eine Auflistung oder ein einzelnes Objekt zurückgeben kann, können Sie mithilfe der Arrayindizierung auf den Wert des Objekts zugreifen, ohne die Count Eigenschaften oder Length testen zu müssen. Wenn das Ergebnis jedoch ein einzelnes Objekt (Singleton) ist und dieses Objekt über eine - oder Length -CountEigenschaft verfügt, gehört der Wert dieser Eigenschaften zum Singletonobjekt und stellt nicht die Anzahl der Elemente in der Auflistung dar.

Im folgenden Beispiel gibt der Befehl ein einzelnes Zeichenfolgenobjekt zurück. Die Length dieser Zeichenfolge ist 4.

PS> $result = 'one','two','three','four' | Where-Object {$_ -like 'f*'}
PS> $result.GetType().FullName
System.String
PS> $result
four
PS> $result.Count
1
PS❯ $result.Length
4

Wenn Sie ein Array von Zeichenfolgen sein möchten $result , müssen Sie die Variable als Array deklarieren.

In diesem Beispiel $result ist ein Array von Zeichenfolgen. Das Count und Length des Arrays ist 1, und der Length des ersten Elements ist 4.

PS> [string[]]$result = 'one','two','three','four' |
    Where-Object {$_ -like 'f*'}
PS> $result.GetType().FullName
System.String[]
PS> $result
four
PS> $result.Count
1
PS> $result.Length
1
PS> $result[0].Length
4

Indizierungsunterstützung für System.Tuple Objekte

PowerShell 6.1 hat die Unterstützung für den indizierten Zugriff auf Tuple Objekte hinzugefügt, ähnlich wie arrays. Beispiel:

PS> $tuple = [Tuple]::Create(1, 'test')
PS> $tuple[0]
1
PS> $tuple[1]
test
PS> $tuple[0..1]
1
test
PS> $tuple[-1]
test

Im Gegensatz zu Arrays und anderen Auflistungsobjekten werden Objekte als einzelnes Objekt behandelt, Tuple wenn sie durch die Pipeline übergeben werden, oder durch Parameter, die Arrays von Objekten unterstützen.

Weitere Informationen finden Sie unter System.Tuple.

Indizieren von .NET-Typen, die implementieren `IDictionary<TKey, TValue>`

PowerShell ruft den true-Indexer eines Typs für Typen, die die generische IDictionary<TKey, TValue> Schnittstelle implementieren, nicht auf. Wenn sie einen Schlüssel erhalten, testet PowerShell stattdessen mithilfe von auf das Vorhandensein des Schlüssels TryGetValue(), der zurückgibt $null , wenn der Schlüssel nicht vorhanden ist.

Wenn Sie hingegen den true-Indexer des Typs mit Item(<key>)aufrufen, löst die -Methode eine Ausnahme aus, wenn der Schlüssel nicht vorhanden ist.

Der Unterschied wird im folgenden Beispiel veranschaulicht.

PS> [Collections.Generic.Dictionary[string, int]]::new()['nosuchkey']
# No output ($null)

PS> [Collections.Generic.Dictionary[string, int]]::new().Item('nosuchkey')
GetValueInvocationException: Exception getting "Item": "The given key 'nosuchkey'
 was not present in the dictionary."

Memberzugriffsenumeration

Wenn Sie ab PowerShell 3.0 den Memberzugriffsoperator verwenden, um auf ein Element zuzugreifen, das nicht in einer Listensammlung vorhanden ist, listet PowerShell automatisch die Elemente in der Auflistung auf und versucht, auf das angegebene Element für jedes Element zuzugreifen. Weitere Informationen finden Sie unter about_Member-Access_Enumeration.

Beispiele

Im folgenden Beispiel werden zwei neue Dateien erstellt und die resultierenden Objekte in der Arrayvariablen $filesgespeichert. Da das Arrayobjekt nicht über den LastWriteTime-Member verfügt, wird der Wert von LastWriteTime für jedes Element im Array zurückgegeben.

$files = (New-Item -Type File -Force '/temp/t1.txt'),
         (New-Item -Force -Type File '/temp/t2.txt')
$files.LastWriteTime

Friday, June 25, 2021 1:21:17 PM
Friday, June 25, 2021 1:21:17 PM

Mit der Memberzugriffsenumeration können Sie Werte aus Elementen in einer Auflistung abrufen , aber nicht Werte für Elemente in einer Auflistung festlegen . Beispiel:

$files.LastWriteTime = (Get-Date).AddDays(-1)

InvalidOperation: The property 'LastWriteTime' cannot be found on this object.
Verify that the property exists and can be set.

Zum Festlegen der Werte müssen Sie eine -Methode verwenden.

$files.set_LastWriteTime((Get-Date).AddDays(-1))
$files.LastWriteTime

Thursday, June 24, 2021 1:23:30 PM
Thursday, June 24, 2021 1:23:30 PM

Die set_LastWriteTime() -Methode ist ein ausgeblendetes Element des FileInfo-Objekts . Im folgenden Beispiel wird gezeigt, wie Sie Member mit einer ausgeblendetenset Methode finden.

$files | Get-Member | Where-Object Definition -like '*set;*'

   TypeName: System.IO.FileInfo

Name              MemberType Definition
----              ---------- ----------
Attributes        Property   System.IO.FileAttributes Attributes {get;set;}
CreationTime      Property   datetime CreationTime {get;set;}
CreationTimeUtc   Property   datetime CreationTimeUtc {get;set;}
IsReadOnly        Property   bool IsReadOnly {get;set;}
LastAccessTime    Property   datetime LastAccessTime {get;set;}
LastAccessTimeUtc Property   datetime LastAccessTimeUtc {get;set;}
LastWriteTime     Property   datetime LastWriteTime {get;set;}
LastWriteTimeUtc  Property   datetime LastWriteTimeUtc {get;set;}

Achtung

Da die -Methode für jedes Element in der Auflistung ausgeführt wird, sollte beim Aufrufen von Methoden mithilfe der Memberenumeration Vorsicht angezeigt werden.

Freigeben über

about_Arrays

Kurze Beschreibung

Lange Beschreibung

Erstellen und Initialisieren eines Arrays

Der Arrayunterausdruckoperator

Zugreifen auf und Verwenden von Arrayelementen

Lesen eines Arrays

Iterationen über Arrayelemente

Eigenschaften von Arrays

Count oder Length oder LongLength

Rank

Methoden von Arrays

Clear

ForEach()

ForEach(scriptblock-Ausdruck)

ForEach(scriptblock-Ausdruck, Object[]-Argumente)

ForEach(typ convertToType)

ForEach(string propertyName)

ForEach(string propertyName, object[] newValue)

ForEach(string methodName)

ForEach(string methodName, object[] arguments)

Where()

Default

Last

SkipUntil

Until

Split

Abrufen der Member eines Arrays

Bearbeiten eines Arrays

Arrays von 0 oder 1

Indizierungsunterstützung für System.Tuple Objekte

Indizieren von .NET-Typen, die implementieren `IDictionary<TKey, TValue>`

Memberzugriffsenumeration

Beispiele

Weitere Informationen

Zusätzliche Ressourcen

Freigeben über

about_Arrays

Kurze Beschreibung

Lange Beschreibung

Erstellen und Initialisieren eines Arrays

Der Arrayunterausdruckoperator

Zugreifen auf und Verwenden von Arrayelementen

Lesen eines Arrays

Iterationen über Arrayelemente

Eigenschaften von Arrays

Count oder Length oder LongLength

Rank

Methoden von Arrays

Clear

ForEach()

ForEach(scriptblock-Ausdruck)

ForEach(scriptblock-Ausdruck, Object[]-Argumente)

ForEach(typ convertToType)

ForEach(string propertyName)

ForEach(string propertyName, object[] newValue)

ForEach(string methodName)

ForEach(string methodName, object[] arguments)

Where()

Default

Last

SkipUntil

Until

Split

Abrufen der Member eines Arrays

Bearbeiten eines Arrays

Arrays von 0 oder 1

Indizierungsunterstützung für System.Tuple Objekte

Indizieren von .NET-Typen, die implementieren IDictionary<TKey, TValue>

Memberzugriffsenumeration

Beispiele

Weitere Informationen

Zusätzliche Ressourcen

Indizieren von .NET-Typen, die implementieren `IDictionary<TKey, TValue>`