Freigeben über


about_Hash_Tables

Kurze Beschreibung

Beschreibt, wie Hashtables in PowerShell erstellt, verwendet und sortiert werden.

Lange Beschreibung

Eine Hashtabelle, auch als Wörterbuch oder assoziatives Array bezeichnet, ist eine kompakte Datenstruktur, die ein oder mehrere Schlüsselwertpaare speichert. Beispielsweise kann eine Hashtabelle eine Reihe von IP-Adressen und Computernamen enthalten, wobei die IP-Adressen die Schlüssel und die Computernamen die Werte sind oder umgekehrt.

In PowerShell ist jede Hashtable ein Hashtable[System.Collections.Hashtable] Objekt. Sie können die Eigenschaften und Methoden von Hashtable Objekten in PowerShell verwenden.

Ab PowerShell 3.0 können Sie das [ordered] Attribut verwenden, um ein [System.Collections.Specialized.OrderedDictionary] Objekt in PowerShell zu erstellen.

Sortierte Wörterbücher unterscheiden sich von Hashtables darin, dass die Schlüssel immer in der Reihenfolge angezeigt werden, in der Sie sie auflisten. Die Reihenfolge der Schlüssel in einer Hashtabelle wird nicht bestimmt.

Die Schlüssel und der Wert in Hashtables sind auch .NET-Objekte. Sie sind am häufigsten Zeichenfolgen oder ganze Zahlen, aber sie können einen beliebigen Objekttyp aufweisen. Sie können auch geschachtelte Hashtables erstellen, bei denen der Wert eines Schlüssels eine andere Hashtabelle ist.

Hashtablehäufig verwendet werden, da sie effizient zum Suchen und Abrufen von Daten sind. Sie können Hashtables verwenden, um Listen zu speichern und berechnete Eigenschaften in PowerShell zu erstellen. Außerdem verfügt PowerShell über ein Cmdlet, ConvertFrom-StringDatadas Zeichenfolgen in eine Hashtabelle konvertiert.

Syntax

Die Syntax einer Hashtabelle lautet wie folgt:

@{ <name> = <value>; [<name> = <value> ] ...}

Die Syntax eines sortierten Wörterbuchs lautet wie folgt:

[ordered]@{ <name> = <value>; [<name> = <value> ] ...}

Die [ordered] Typbeschleuniger wurde in PowerShell 3.0 eingeführt.

Erstellen von Hashtables

Befolgen Sie die folgenden Richtlinien, um eine Hashtabelle zu erstellen:

  • Beginnen Sie die Hashtable mit einem At-Zeichen (@).
  • Schließen Sie die Hashtabelle in geschweifte Klammern ({}) ein.
  • Geben Sie ein oder mehrere Schlüsselwertpaare für den Inhalt der Hashtabelle ein.
  • Verwenden Sie ein Gleichheitszeichen (=), um jeden Schlüssel vom Wert zu trennen.
  • Verwenden Sie ein Semikolon (;) oder einen Zeilenumbruch, um die Schlüsselwertpaare zu trennen.
  • Schlüssel, die Leerzeichen enthalten, müssen in Anführungszeichen eingeschlossen werden. Werte müssen gültige PowerShell-Ausdrücke sein. Zeichenfolgen müssen in Anführungszeichen angezeigt werden, auch wenn sie keine Leerzeichen enthalten.
  • Um die Hashtabelle zu verwalten, speichern Sie sie in einer Variablen.
  • Wenn Sie einer Variablen eine geordnete Hashtable zuweisen, platzieren Sie den [ordered] Typ vor dem @ Symbol. Wenn Sie ihn vor dem Variablennamen platzieren, schlägt der Befehl fehl.

Um eine leere Hashtabelle im Wert von $hash zu erstellen, geben Sie Folgendes ein:

$hash = @{}

Sie können einer Hashtable auch Schlüssel und Werte hinzufügen, wenn Sie sie erstellen. Die folgende Anweisung erstellt beispielsweise eine Hashtabelle mit drei Schlüsseln.

$hash = @{ Number = 1; Shape = "Square"; Color = "Blue"}

Erstellen von geordneten Wörterbüchern

Sie können ein sortiertes Wörterbuch erstellen, indem Sie ein Objekt des OrderedDictionary Typs hinzufügen, aber die einfachste Möglichkeit zum Erstellen eines sortierten Wörterbuchs ist die Verwendung des [ordered] Attributs.

Das [ordered] Attribut wird in PowerShell 3.0 eingeführt.

Platzieren Sie das Attribut unmittelbar vor dem Symbol "@".

$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}

Sie können sortierte Wörterbücher auf die gleiche Weise wie Hashtables verwenden. Jeder Typ kann als Wert von Parametern verwendet werden, die eine Hashtabelle oder ein Wörterbuch (iDictionary) verwenden.

Sie können das [ordered] Attribut nicht zum Konvertieren oder Umwandeln einer Hashtabelle verwenden. Wenn Sie das sortierte Attribut vor dem Variablennamen platzieren, schlägt der Befehl mit der folgenden Fehlermeldung fehl.

[ordered]$hash = @{}
At line:1 char:1
+ [ordered]$hash = @{}
+ ~~~~~~~~~~~~~~
The ordered attribute can be specified only on a hash literal node.
    + CategoryInfo          : ParserError: (:) [], ParentContainsErrorRecordException
    + FullyQualifiedErrorId : OrderedAttributeOnlyOnHashLiteralNode

Um den Ausdruck zu korrigieren, verschieben Sie das [sortierte] Attribut.

$hash = [ordered]@{}

Sie können ein sortiertes Wörterbuch in eine Hashtabelle umwandeln, aber Sie können das sortierte Attribut nicht wiederherstellen, auch wenn Sie die Variable löschen und neue Werte eingeben. Um die Reihenfolge erneut herzustellen, müssen Sie die Variable entfernen und neu erstellen.

[hashtable]$hash = [ordered]@{
  Number = 1; Shape = "Square"; Color = "Blue"}
$hash
Name                           Value
----                           -----
Color                          Blue
Shape                          Square
Number                         1

Anzeigen von Hashtables

Geben Sie den Variablennamen ein, um eine Hashtabelle anzuzeigen, die in einer Variablen gespeichert ist. Standardmäßig wird eine Hashtabelle als Tabelle mit einer Spalte für Schlüssel und eine für Werte angezeigt.

$hash
Name                           Value
----                           -----
Shape                          Square
Color                          Blue
Number                         1

Hashtables weisen Schlüssel - und Werteeigenschaften auf. Verwenden Sie die Punktnotation, um alle Tasten oder alle Werte anzuzeigen.

$hash.keys
Number
Shape
Color
$hash.values
1
Square
Blue

Jeder Schlüsselname ist auch eine Eigenschaft der Hashtable, und sein Wert ist der Wert der Schlüsselnameneigenschaft. Verwenden Sie das folgende Format, um die Eigenschaftswerte anzuzeigen.

$hashtable.<key>
<value>

Zum Beispiel:

$hash.Number
1

$hash.Color
Blue

Hashtables verfügen über eine Count-Eigenschaft , die die Anzahl der Schlüsselwertpaare in der Hashtabelle angibt.

$hash.count
3

Hashtabellen sind keine Arrays, sodass Sie keine ganze Zahl als Index in der Hashtabelle verwenden können, aber Sie können einen Schlüsselnamen zum Indizieren in der Hashtabelle verwenden. Wenn der Schlüssel ein Zeichenfolgenwert ist, schließen Sie den Schlüsselnamen in Anführungszeichen ein.

Zum Beispiel:

$hash["Number"]
1

Behandeln von Eigenschaftennamenskonflikten

Wenn der Schlüsselname mit einem der Eigenschaftennamen des HashTable-Typs kollidiert, können Sie das systeminterne Psbase-Element verwenden, um auf diese Eigenschaften zuzugreifen. Wenn der Schlüsselname beispielsweise lautet keys und Sie die Sammlung der HashTable-Schlüssel zurückgeben möchten, verwenden Sie die folgende Syntax:

$hashtable.psbase.Keys

Dies gilt für andere Typen, die die System.Collections.IDictionary Schnittstelle implementieren, z OrderedDictionary. B. .

Durchlaufen von Schlüsseln und Werten

Sie können die Schlüssel in einer Hashtabelle durchlaufen, um die Werte auf verschiedene Arten zu verarbeiten. Jedes der Beispiele in diesem Abschnitt hat eine identische Ausgabe. Sie durchlaufen die $hash hier definierte Variable:

$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}

Hinweis

In diesen Beispielen wird als sortiertes Wörterbuch definiert, um sicherzustellen, $hash dass die Ausgabe immer in derselben Reihenfolge ist. Diese Beispiele funktionieren für normale Hashtables identisch, aber die Reihenfolge der Ausgabe ist nicht vorhersehbar.

Jedes Beispiel gibt eine Nachricht für jeden Schlüssel und dessen Wert zurück:

The value of 'Number' is: 1
The value of 'Shape' is: Square
The value of 'Color' is: Blue

In diesem Beispiel wird ein Foreachblock verwendet, um die Tasten zu durchlaufen.

foreach ($Key in $hash.Keys) {
    "The value of '$Key' is: $($hash[$Key])"
}

In diesem Beispiel werden ForEach-Object die Tasten durchlaufen.

$hash.Keys | ForEach-Object {
    "The value of '$_' is: $($hash[$_])"
}

In diesem Beispiel wird die GetEnumerator-Methode verwendet, um jedes Schlüssel-Wert-Paar über die Pipeline zu ForEach-Objectsenden.

$hash.GetEnumerator() | ForEach-Object {
    "The value of '$($_.Key)' is: $($_.Value)"
}

In diesem Beispiel werden die Methoden GetEnumerator und ForEach verwendet, um jedes Schlüssel-Wert-Paar zu durchlaufen.

$hash.GetEnumerator().ForEach({"The value of '$($_.Key)' is: $($_.Value)"})

Hinzufügen und Entfernen von Schlüsseln und Werten

Verwenden Sie das folgende Befehlsformat, um einer Hashtabelle Schlüssel und Werte hinzuzufügen.

$hash["<key>"] = "<value>"

Wenn Sie beispielsweise der Hashtable einen "Time"-Schlüssel mit dem Wert "Now" hinzufügen möchten, verwenden Sie das folgende Anweisungsformat.

$hash["Time"] = "Now"

Sie können einer Hashtable auch Schlüssel und Werte hinzufügen, indem Sie die Add Methode des System.Collections.Hashtable Objekts verwenden. Die Add Methode weist die folgende Syntax auf:

Add(Key, Value)

Wenn Sie beispielsweise einen Time Schlüssel mit einem Wert Now der Hashtabelle hinzufügen möchten, verwenden Sie das folgende Anweisungsformat.

$hash.Add("Time", "Now")

Außerdem können Sie einer Hashtable Schlüssel und Werte hinzufügen, indem Sie den Additionsoperator (+) verwenden, um einer vorhandenen Hashtable eine Hashtable hinzuzufügen. Die folgende Anweisung fügt z. B. einen Time Schlüssel mit dem Wert der Now Hashtable in der $hash Variablen hinzu.

$hash = $hash + @{Time="Now"}

Sie können auch Werte hinzufügen, die in Variablen gespeichert sind.

$t = "Today"
$now = (Get-Date)

$hash.Add($t, $now)

Sie können keinen Subtraktionsoperator verwenden, um ein Schlüssel-Wert-Paar aus einer Hashtabelle zu entfernen, aber Sie können die Remove-Methode des Hashtable Objekts verwenden. Die Remove-Methode verwendet den Schlüssel als Wert.

Die Remove Methode weist die folgende Syntax auf:

Remove(Key)

Um beispielsweise das Time=Now Schlüssel-Wert-Paar aus der Hashtable im Wert der $hash Variablen zu entfernen, geben Sie Folgendes ein:

$hash.Remove("Time")

Sie können alle Eigenschaften und Methoden von Hashtable Objekten in PowerShell verwenden, einschließlich Contains, , Clear, Cloneund CopyTo. Weitere Informationen zu Hashtable Objekten finden Sie unter System.Collections.Hashtable.

Objekttypen in HashTables

Die Schlüssel und Werte in einer Hashtabelle können einen beliebigen .NET-Objekttyp aufweisen, und eine einzelne Hashtabelle kann Schlüssel und Werte mehrerer Typen aufweisen.

Die folgende Anweisung erstellt eine Hashtabelle mit Prozessnamenzeichenfolgen und Prozessobjektwerten und speichert sie in der $p Variablen.

$p = @{
    "PowerShell" = (Get-Process PowerShell)
    "Notepad" = (Get-Process notepad)
}

Sie können die Hashtabelle anzeigen $p und die Schlüsselnameneigenschaften verwenden, um die Werte anzuzeigen.

PS> $p

Name                           Value
----                           -----
PowerShell                     System.Diagnostics.Process (PowerShell)
Notepad                        System.Diagnostics.Process (notepad)

PS> $p.PowerShell

Handles  NPM(K)    PM(K)      WS(K) VM(M)   CPU(s)     Id ProcessName
-------  ------    -----      ----- -----   ------     -- -----------
    441      24    54196      54012   571     5.10   1788 PowerShell

PS> $p.keys | ForEach-Object {$p.$_.handles}
441
251

Die Schlüssel in einer Hashtabelle können einen beliebigen .NET-Typ sein. Die folgende Anweisung fügt der Hashtable in der $p Variablen ein Schlüssel-Wert-Paar hinzu. Der Schlüssel ist ein Service -Objekt, das den WinRM-Dienst darstellt, und der Wert ist der aktuelle Status des Diensts.

$p = $p + @{
    (Get-Service WinRM) = ((Get-Service WinRM).Status)
}

Sie können das neue Schlüssel-Wert-Paar mit den gleichen Methoden anzeigen und darauf zugreifen, die Sie für andere Paare in der Hashtabelle verwenden.

PS> $p

Name                           Value
----                           -----
PowerShell                     System.Diagnostics.Process (powershell)
Notepad                        System.Diagnostics.Process (Notepad)
WinRM                          Running

PS> $p.keys
PowerShell
Notepad

Status   Name               DisplayName
------   ----               -----------
Running  winrm              Windows Remote Management (WS-Manag...

PS> $p.keys | ForEach-Object {$_.name}
WinRM

Die Schlüssel und Werte in einer Hashtabelle können auch Objekte sein Hashtable . Die folgende Anweisung fügt der Hashtable in der $p Variablen, in der der Schlüssel eine Zeichenfolge, Hash2 und der Wert eine Hashtable mit drei Schlüsselwertpaaren ist, hinzu.

$p = $p + @{
    "Hash2"= @{a=1; b=2; c=3}
}

Sie können die neuen Werte mit den gleichen Methoden anzeigen und auf sie zugreifen.

PS> $p

Name                           Value
----                           -----
PowerShell                     System.Diagnostics.Process (powershell)
Notepad                        System.Diagnostics.Process (Notepad)
WinRM                          Running
Hash2                          {c, b, a}

PS> $p.Hash2

Name                           Value
----                           -----
c                              3
b                              2
a                              1

PS> $p.Hash2.b
2

Sortieren von Schlüsseln und Werten

Die Elemente in einer Hashtabelle sind systemintern ungeordnet. Die Schlüsselwertpaare können bei jeder Anzeige in einer anderen Reihenfolge angezeigt werden.

Obwohl Sie eine Hashtabelle nicht sortieren können, können Sie die GetEnumerator-Methode von Hashtables verwenden, um die Schlüssel und Werte aufzulisten, und verwenden Sie dann das Sort-Object Cmdlet, um die aufgezählten Werte für die Anzeige zu sortieren.

Mit den folgenden Befehlen werden beispielsweise die Schlüssel und Werte in der Hashtabelle in der $p Variablen aufgelistet und dann die Tasten in alphabetischer Reihenfolge sortiert.

PS> $p.GetEnumerator() | Sort-Object -Property key

Name                           Value
----                           -----
Hash2                          {c, b, a}
Notepad                        System.Diagnostics.Process (Notepad)
PowerShell                     System.Diagnostics.Process (powershell)
WinRM                          Running

Der folgende Befehl verwendet dieselbe Prozedur, um die Hashwerte in absteigender Reihenfolge zu sortieren.

PS> $p.GetEnumerator() | Sort-Object -Property Value -Descending

Name                           Value
----                           -----
PowerShell                     System.Diagnostics.Process (powershell)
Notepad                        System.Diagnostics.Process (Notepad)
Hash2                          {c, b, a}
WinRM                          Running

Erstellen von Objekten aus Hashtables

Ab PowerShell 3.0 können Sie ein Objekt aus einer Hashtabelle von Eigenschaften und Eigenschaftswerten erstellen.

Die Syntax lautet wie folgt:

[<class-name>]@{
  <property-name>=<property-value>
  <property-name>=<property-value>
}

Diese Methode funktioniert nur für Klassen mit einem Konstruktor ohne Parameter. Die Objekteigenschaften müssen öffentlich und festgelegt sein.

Weitere Informationen finden Sie unter about_Object_Creation.

ConvertFrom-StringData

Das ConvertFrom-StringData Cmdlet konvertiert eine Zeichenfolge oder eine here-Zeichenfolge von Schlüsselwertpaaren in eine Hashtabelle. Sie können das ConvertFrom-StringData Cmdlet sicher im Abschnitt "Daten" eines Skripts verwenden, und Sie können es mit dem Import-LocalizedData Cmdlet verwenden, um Benutzermeldungen in der Benutzeroberflächenkultur des aktuellen Benutzers anzuzeigen.

Hier sind Zeichenfolgen besonders hilfreich, wenn die Werte in der Hashtabelle Anführungszeichen enthalten. Weitere Informationen zu den hier aufgeführten Zeichenfolgen finden Sie unter about_Quoting_Rules.

Das folgende Beispiel zeigt, wie Sie eine hier-Zeichenfolge der Benutzernachrichten im vorherigen Beispiel erstellen und wie ConvertFrom-StringData Sie diese aus einer Zeichenfolge in eine Hashtabelle konvertieren.

Der folgende Befehl erstellt eine here-Zeichenfolge der Schlüsselwertpaare und speichert sie dann in der $string Variablen.

$string = @"
Msg1 = Type "Windows".
Msg2 = She said, "Hello, World."
Msg3 = Enter an alias (or "nickname").
"@

Dieser Befehl verwendet das ConvertFrom-StringData Cmdlet, um die hier-Zeichenfolge in eine Hashtabelle zu konvertieren.

ConvertFrom-StringData $string

Name                           Value
----                           -----
Msg3                           Enter an alias (or "nickname").
Msg2                           She said, "Hello, World."
Msg1                           Type "Windows".

Weitere Informationen zu den hier aufgeführten Zeichenfolgen finden Sie unter about_Quoting_Rules.

Weitere Informationen