about_Hash_Tables
Krátký popis
Popisuje, jak vytvářet, používat a řadit hashovací tabulky v PowerShellu.
Dlouhý popis
A hashtable, také známý jako slovník nebo asociativní pole, je kompaktní datová struktura, která ukládá jeden nebo více párů klíč-hodnota. Například tabulka hash může obsahovat řadu IP adres a názvů počítačů, kde IP adresy jsou klíče a názvy počítačů jsou hodnoty nebo naopak.
V PowerShellu [System.Collections.Hashtable] je každý hashtable objekt. V PowerShellu můžete použít vlastnosti a metody Hashtable objektů.
Počínaje PowerShellem 3.0 můžete pomocí akcelerátoru [ordered] typů vytvořit objekt v PowerShellu [System.Collections.Specialized.OrderedDictionary] .
Seřazené slovníky se liší od hashovatelných tabulek v tom, že klíče se vždy zobrazují v pořadí, ve kterém je vypíšete. Pořadí klíčů v a hashtable není deterministické.
Klíče a hodnota v hashtables jsou také objekty .NET. Nejčastěji se jedná o řetězce nebo celá čísla, ale můžou mít libovolný typ objektu. Můžete také vytvořit vnořené hashtables, ve kterých je hodnota klíče další hashtable.
Hashtables se často používají, protože jsou efektivní pro hledání a načítání dat. K ukládání seznamů a vytváření počítaných vlastností v PowerShellu můžete použít hashovací tabulky. A rutina ConvertFrom-StringData převede strukturovaná řetězcová data na .hashtable
Syntaxe
Syntaxe a hashtable je následující:
@{ <name> = <value>; [<name> = <value> ] ...}
Syntaxe seřazeného slovníku je následující:
[ordered]@{ <name> = <value>; [<name> = <value> ] ...}
Akcelerátor [ordered] typů byl zaveden v PowerShellu 3.0.
Pokud chcete vytvořit , hashtablepostupujte podle těchto pokynů:
- hashtable Začněte znakem at (
@). - Uzavřete složené hashtable závorky (
{}). - Zadejte jeden nebo více párů klíč-hodnota pro obsah hashtablesouboru .
- K oddělení každého klíče od jeho hodnoty použijte znaménko rovná se (
=). - K oddělení párů klíč-hodnota použijte středník (
;) nebo konec řádku. - Klíče, které obsahují mezery, musí být uzavřeny v uvozovkách. Hodnoty musí být platné výrazy PowerShellu. Řetězce se musí zobrazovat v uvozovkách, i když neobsahují mezery.
- Pokud chcete spravovat hashtablesložku , uložte ji do proměnné.
- Při přiřazování seřazené hashtable proměnné umístěte
[ordered]typ před@symbol. Pokud ji umístíte před název proměnné, příkaz selže.
Uspořádané slovníky můžete používat stejným způsobem jako hashovací tabulky. Typ lze použít jako hodnotu parametrů, které přebírají hashtable objekty typu nebo slovník (iDictionary).
Vytváření hashovatelných tabulek a seřazených slovníků
Podívejte se na následující hashtable a seřazené příklady slovníku:
$hash = @{
1 = 'one'
2 = 'two'
'three' = 3
}
$hash
Name Value
---- -----
three 3
2 two
1 one
Jak vidíte, páry klíč-hodnota se hashtable nezobrazují v pořadí, v jakém byly definovány.
Nejjednodušší způsob, jak vytvořit uspořádaný slovník, je použít [ordered] atribut. Umístěte atribut bezprostředně před @ symbol.
$dictionary = [ordered]@{
1 = 'one'
2 = 'two'
'three' = 3
}
$dictionary
Name Value
---- -----
1 one
2 two
three 3
Na rozdíl odhashch
Převod hashovatelných tabulek a uspořádaných slovníků
Akcelerátor typů nelze použít k převodu [ordered] nebo přetypování hashtable.
Pokud před název proměnné umístíte objednaný atribut, příkaz selže s následující chybovou zprávou.
[ordered]$orderedhash = @{}
ParserError:
Line |
1 | [ordered]$orderedhash = @{}
| ~~~~~~~~~~~~~~
| The ordered attribute can be specified only on a hash literal node.
Pokud chcete výraz opravit, přesuňte atribut [objednaný].
$orderedhash = [ordered]@{}
Seřazený slovník můžete přetypovat na hashtable, ale nemůžete zaručit pořadí členů.
[hashtable]$newhash = [ordered]@{
Number = 1
Shape = "Square"
Color = "Blue"
}
$newhash
Name Value
---- -----
Color Blue
Shape Square
Number 1
Hashtable a vlastnosti slovníku
Hashtables and ordered dictionaries share několik vlastností. Vezměte v úvahu proměnné $hash $dictionary definované v předchozích příkladech.
$hash | Get-Member -MemberType Properties, ParameterizedProperty
TypeName: System.Collections.Hashtable
Name MemberType Definition
---- ---------- ----------
Item ParameterizedProperty System.Object Item(System.Object key) {get;set;}
Count Property int Count {get;}
IsFixedSize Property bool IsFixedSize {get;}
IsReadOnly Property bool IsReadOnly {get;}
IsSynchronized Property bool IsSynchronized {get;}
Keys Property System.Collections.ICollection Keys {get;}
SyncRoot Property System.Object SyncRoot {get;}
Values Property System.Collections.ICollection Values {get;}
$dictionary | Get-Member -MemberType Properties, ParameterizedProperty
TypeName: System.Collections.Specialized.OrderedDictionary
Name MemberType Definition
---- ---------- ----------
Item ParameterizedProperty System.Object Item(int index) {get;set;},
System.Object Item(System.Object key) {get;set;}
Count Property int Count {get;}
IsFixedSize Property bool IsFixedSize {get;}
IsReadOnly Property bool IsReadOnly {get;}
IsSynchronized Property bool IsSynchronized {get;}
Keys Property System.Collections.ICollection Keys {get;}
SyncRoot Property System.Object SyncRoot {get;}
Values Property System.Collections.ICollection Values {get;}
Nejčastěji používané vlastnosti jsou Počet, Klíče, Hodnoty a Položka.
Count vlastnost, která označuje počet párů klíč-hodnota v objektu.
Vlastnost Keys je kolekce názvů klíčů ve slovníku hashtable .
PS> $hash.Keys three 2 1 PS> $dictionary.Keys 1 2 threeVlastnost Values je kolekce hodnot ve slovníku hashtable .
PS> $hash.Values 3 two one PS> $dictionary.Values one two 3Vlastnost Item je parametrizovaná vlastnost, která vrací hodnotu položky, kterou zadáte. Hashtables používají klíč jako parametr parametrizované vlastnosti, zatímco slovníky používají index ve výchozím nastavení. Tento rozdíl má vliv na přístup k hodnotám pro každý typ.
Přístup k hodnotám
Existují dva běžné způsoby přístupu k hodnotám v nebo slovníku hashtable : zápis člena nebo zápis indexu pole.
Zápis člena – K hodnotám lze přistupovat pomocí názvu klíče jako vlastnosti člena objektu. Příklad:
PS> $hash.1 one PS> $dictionary.2 twoZápis indexu pole – k hodnotám lze přistupovat pomocí zápisu indexu. PowerShell převede zápis na volání item parametrizované vlastnosti objektu.
Pokud používáte zápis indexu s hashtables, hodnota uvnitř závorek je název klíče. Pokud je klíč řetězcovou hodnotou, uzavřete název klíče do uvozovek. Příklad:
PS> $hash['three'] 3 PS> $hash[2] 2V tomto příkladu není hodnota
2klíče indexem do kolekce hodnot. Jedná se o hodnotu klíče v páru klíč-hodnota. Můžete to prokázat indexováním do kolekce hodnot.PS> ([array]$hash.Values)[2] onePři použití zápisu indexu se slovníky, hodnota uvnitř závorek se interpretuje na základě jeho typu. Pokud je hodnota celé číslo, považuje se za index do kolekce hodnot. Pokud hodnota není celé číslo, považuje se za název klíče. Příklad:
PS> $dictionary[1] two PS> ([array]$dictionary.Values)[1] two PS> $dictionary[[object]1] one PS> $dictionary['three'] 3V tomto příkladu je maticová hodnota
[1]indexem do kolekce hodnot pomocíItem(int index)parametrizovaného přetížení vlastnosti. Hodnota[[object]1]pole není index, ale hodnota klíče využívajícíItem(System.Object key)přetížení.Poznámka:
Toto chování může být matoucí, pokud je hodnota klíče celé číslo. Pokud je to možné, neměli byste ve slovníkech používat celočíselné hodnoty klíče.
Zpracování kolizí názvů vlastností
Pokud název klíče koliduje s jedním z názvů HashTable vlastností typu, můžete pro přístup k těmto vlastnostem použít vnitřní člen psbase. Pokud je keys například název klíče a chcete vrátit kolekci HashTable klíčů, použijte tuto syntaxi:
$hashtable.psbase.Keys
Tento požadavek platí pro jiné typy, které implementují System.Collections.IDictionary rozhraní, například OrderedDictionary.
Iterace nad klíči a hodnotami
Klíče můžete iterovat několika hashtable způsoby. Každý z příkladů v této části má stejný výstup. Iterují proměnnou definovanou $hash zde:
$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}
Poznámka:
V těchto příkladech je definován jako seřazený slovník, aby se zajistilo, $hash že výstup bude vždy ve stejném pořadí. Tyto příklady fungují stejně pro standardní hashtables, ale pořadí výstupu není předvídatelné.
Každý příklad vrátí zprávu pro každý klíč a jeho hodnotu:
The value of 'Number' is: 1
The value of 'Shape' is: Square
The value of 'Color' is: Blue
V tomto příkladu foreach se k iteraci klíčů používá blok.
foreach ($Key in $hash.Keys) {
"The value of '$Key' is: $($hash[$Key])"
}
Tento příklad se používá ForEach-Object k iteraci klíčů.
$hash.Keys | ForEach-Object {
"The value of '$_' is: $($hash[$_])"
}
Tento příklad používá metodu GetEnumerator() k odeslání každého páru klíč-hodnota prostřednictvím kanálu do ForEach-Object.
$hash.GetEnumerator() | ForEach-Object {
"The value of '$($_.Key)' is: $($_.Value)"
}
V tomto příkladu GetEnumerator() se používají metody a ForEach() iterace nad jednotlivými páry klíč-hodnota.
$hash.GetEnumerator().ForEach({"The value of '$($_.Key)' is: $($_.Value)"})
Přidávání a odebírání klíčů a hodnot
Obvykle při vytváření hashtable párů klíč-hodnota v definici. Páry klíč-hodnota hashtable ale můžete kdykoli přidat a odebrat. Následující příklad vytvoří prázdnou hashtable.
$hash = @{}
Páry klíč-hodnota můžete přidat pomocí zápisu pole. Například následující příklad přidá Time klíč s hodnotou Now do hashtable.
$hash["Time"] = "Now"
Pomocí metody objektu System.Collections.Hashtable můžete také přidat klíče a hodnoty.Add() hashtable Metoda Add() má následující syntaxi:
Add(Key, Value)
Chcete-li například přidat Time klíč s hodnotou Now do hashtable, použijte následující formát příkazu.
$hash.Add("Time", "Now")
A pomocí operátoru hashtable+sčítání () můžete přidat klíče a hodnoty do existujícího hashtableoperátoru hashtable . Například následující příkaz přidá Time klíč s hodnotou Now do hashtable $hash proměnné.
$hash = $hash + @{Time="Now"}
Můžete také přidat hodnoty uložené v proměnných.
$t = "Today"
$now = (Get-Date)
$hash.Add($t, $now)
Operátor odčítání nelze použít k odebrání páru klíč-hodnota z tabulky hash, ale můžete použít Remove() metodu objektu hashtable . Metoda Remove má následující syntaxi:
$object.Remove(<key>)
Následující příklad odebere dvojici Time klíč-hodnota z $hash.
$hash.Remove("Time")
Typy objektů v tabulkách hash
Klíče a hodnoty v objektu hashtable mohou mít libovolný typ objektu .NET a jeden hashtable může obsahovat klíče a hodnoty více typů.
Následující příkaz vytvoří hashtable řetězce názvů procesů a hodnoty objektu procesu a uloží je do $p proměnné.
$p = @{
"PowerShell" = (Get-Process PowerShell)
"Notepad" = (Get-Process notepad)
}
Hodnoty můžete zobrazit hashtable $p a použít vlastnosti názvu klíče.
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
Klíče v libovolném hashtable typu .NET můžou být. Následující příkaz přidá pár klíč-hodnota do hashtable $p proměnné. Klíč je objekt služby , který představuje službu WinRM a hodnota je aktuální stav služby.
$p = $p + @{
(Get-Service WinRM) = ((Get-Service WinRM).Status)
}
Nový pár klíč-hodnota můžete zobrazit a získat k němu přístup pomocí stejných metod, které používáte pro jiné páry v souboru hashtable.
PS> $p
Name Value
---- -----
PowerShell System.Diagnostics.Process (PowerShell)
Notepad System.Diagnostics.Process (notepad)
System.ServiceProcess.Servi... Running
PS> $p.keys
PowerShell
Notepad
Status Name DisplayName
------ ---- -----------
Running winrm Windows Remote Management (WS-Manag...
PS> $p.keys | ForEach-Object {$_.name}
WinRM
Klíče a hodnoty v objektech hashtable mohou být Hashtable také objekty. Následující příkaz přidá pár klíč-hodnota do hashtable $p proměnné, ve které je klíč řetězec, Hash2 a hodnota je se hashtable třemi páry klíč-hodnota.
$p = $p + @{
"Hash2"= @{a=1; b=2; c=3}
}
K novým hodnotám můžete přistupovat stejnými metodami.
PS> $p
Name Value
---- -----
PowerShell System.Diagnostics.Process (pwsh)
Hash2 {[a, 1], [b, 2], [c, 3]}
Notepad System.Diagnostics.Process (Notepad)
WinRM Running
PS> $p.Hash2
Name Value
---- -----
a 1
b 2
c 3
PS> $p.Hash2.b
2
Řazení klíčů a hodnot
Položky v objektu hashtable jsou vnitřně neuspořádané. Páry klíč-hodnota se můžou zobrazovat v jiném pořadí pokaždé, když je zobrazíte.
I když nemůžete řadit hashtable, můžete použít GetEnumerator() metodu hashtables k vytvoření výčtu klíčů a hodnot a pak pomocí Sort-Object rutiny seřadit výčtové hodnoty pro zobrazení.
Například následující příkazy vyčíslí klíče a hodnoty v tabulce hash v $p proměnné a potom seřadí klíče v abecedním pořadí.
PS> $p.GetEnumerator() | Sort-Object -Property key
Name Value
---- -----
Hash2 {[a, 1], [b, 2], [c, 3]}
Notepad System.Diagnostics.Process (Notepad)
PowerShell System.Diagnostics.Process (pwsh)
WinRM Running
Následující příkaz používá stejný postup k seřazení hodnot hash v sestupném pořadí.
PS> $p.GetEnumerator() | Sort-Object -Property Value -Descending
Name Value
---- -----
PowerShell System.Diagnostics.Process (pwsh)
Notepad System.Diagnostics.Process (Notepad)
Hash2 {[a, 1], [b, 2], [c, 3]}
WinRM Running
Vytváření objektů z hashtables
Počínaje PowerShellem 3.0 můžete vytvořit objekt z hashtable vlastností a hodnot vlastností.
Syntaxe je následující:
[<class-name>]@{
<property-name>=<property-value>
<property-name>=<property-value>
}
Tato metoda funguje pouze pro třídy, které mají konstruktor, který nemá žádné parametry. Vlastnosti objektu musí být veřejné a nastavené.
Další informace najdete v tématu about_Object_Creation.
ConvertFrom-StringData
Rutina ConvertFrom-StringData převede řetězec nebo here-řetězec párů klíč-hodnota na hashtable. Rutinu ConvertFrom-StringData můžete bezpečně použít v části Data skriptu a pomocí této Import-LocalizedData rutiny můžete zobrazit uživatelské zprávy v jazykové verzi uživatelského rozhraní aktuálního uživatele.
Tady jsou řetězce užitečné zejména v případech hashtable , kdy hodnoty v uvozovkách obsahují. Další informace o tomto řetězci najdete v tématu about_Quoting_Rules.
Následující příklad ukazuje, jak vytvořit zde-řetězec zpráv uživatele v předchozím příkladu a jak je použít ConvertFrom-StringData k převodu z řetězce na .hashtable
Následující příkaz vytvoří zde řetězec párů klíč-hodnota a pak ho uloží do $string proměnné.
$string = @"
Msg1 = Type "Windows".
Msg2 = She said, "Hello, World."
Msg3 = Enter an alias (or "nickname").
"@
Tento příkaz pomocí rutiny ConvertFrom-StringData převede řetězec here-string na .hashtable
ConvertFrom-StringData $string
Name Value
---- -----
Msg3 Enter an alias (or "nickname").
Msg2 She said, "Hello, World."
Msg1 Type "Windows".
Další informace o tomto řetězci najdete v tématu about_Quoting_Rules.
