===>>GO TO THE STORE<<===
п»їabout_Hash_Tables.
Describes how to create, use, and sort hashtables in PowerShell.
Long description.
A hashtable, also known as a dictionary or associative array, is a compact data structure that stores one or more key-value pairs. For example, a hash table might contain a series of IP addresses and computer names, where the IP addresses are the keys and the computer names are the values, or vice versa.
In PowerShell, each hashtable is a Hashtable [System.Collections.Hashtable] object. You can use the properties and methods of Hashtable objects in PowerShell.
Beginning in PowerShell 3.0, you can use the [ordered] attribute to create an [System.Collections.Specialized.OrderedDictionary] object in PowerShell.
Ordered dictionaries differ from hashtables in that the keys always appear in the order in which you list them. The order of keys in a hashtable isn't determined.
The keys and value in hashtables are also .NET objects. They're most often strings or integers, but they can have any object type. You can also create nested hashtables, in which the value of a key is another hashtable.
Hashtables are frequently used because they're efficient for finding and retrieving data. You can use hashtables to store lists and to create calculated properties in PowerShell. And, PowerShell has a cmdlet, ConvertFrom-StringData , that converts strings to a hashtable.
Syntax.
The syntax of a hashtable is as follows:
The syntax of an ordered dictionary is as follows:
[ordered]@
The [ordered] type accelerator was introduced in PowerShell 3.0.
Creating hashtables.
To create a hashtable, follow these guidelines:
Begin the hashtable with an at sign ( @ ). Enclose the hashtable in braces ( <> ). Enter one or more key-value pairs for the content of the hashtable. Use an equal sign ( = ) to separate each key from its value. Use a semicolon ( ; ) or a line break to separate the key-value pairs. Keys that contain spaces must be enclosed in quotation marks. Values must be valid PowerShell expressions. Strings must appear in quotation marks, even if they don't include spaces. To manage the hashtable, save it in a variable. When assigning an ordered hashtable to a variable, place the [ordered] type before the @ symbol. If you place it before the variable name, the command fails.
To create an empty hashtable in the value of $hash, type:
$hash = @<>
You can also add keys and values to a hashtable when you create it. For example, the following statement creates a hashtable with three keys.
$hash = @
Creating ordered dictionaries.
You can create an ordered dictionary by adding an object of the OrderedDictionary type, but the easiest way to create an ordered dictionary is use the [ordered] attribute.
The [ordered] attribute is introduced in PowerShell 3.0.
Place the attribute immediately before the "@" symbol.
$hash = [ordered]@
You can use ordered dictionaries in the same way that you use hashtables. Either type can be used as the value of parameters that take a hashtable or dictionary ( iDictionary ).
You can't use the [ordered] attribute to convert or cast a hashtable. If you place the ordered attribute before the variable name, the command fails with the following error message.
[ordered]$hash = @<> ParserError: Line | 1 | [ordered]$hash = @<> | ~~~~~~~~~~~~~~ | The ordered attribute can be specified only on a hash literal node.
To correct the expression, move the [ordered] attribute.
$hash = [ordered]@<>
You can cast an ordered dictionary to a hashtable, but you can't recover the ordered attribute, even if you clear the variable and enter new values. To re-establish the order, you must remove and recreate the variable.
[hashtable]$hash = [ordered]@ $hash.
Name Value ---- ----- Color Blue Shape Square Number 1.
Displaying hashtables.
To display a hashtable that's saved in a variable, type the variable name. By default, a hashtables is displayed as a table with one column for keys and one for values.
$hash.
Name Value ---- ----- Shape Square Color Blue Number 1.
hashtables have Keys and Values properties. Use dot notation to display all the keys or all the values.
$hash.keys.
Number Shape Color.
$hash.values.
1 Square Blue.
Each key name is also a property of the hashtable, and its value is the value of the key name property. Use the following format to display the property values.
$hashtable.
$hash.Number 1 $hash.Color Blue.
hashtables have a Count property that indicates the number of key-value pairs in the hashtable.
$hash.count 3.
hashtable tables aren't arrays, so you can't use an integer as an index into the hashtable, but you can use a key name to index into the hashtable. If the key is a string value, enclose the key name in quotation marks.
$hash["Number"] 1.
Handling property name collisions.
If the key name collides with one of the property names of the HashTable type, you can use the psbase intrinsic member to access those properties. For example, if the key name is keys and you want to return the collection of the HashTable keys, use this syntax:
$hashtable.psbase.Keys.
This applies for other types which implement the System.Collections.IDictionary interface, like OrderedDictionary .
Iterating over keys and values.
You can iterate over the keys in a hashtable to process the values in several ways. Each of the examples in this section has identical output. They iterate over the $hash variable defined here:
$hash = [ordered]@
In these examples, $hash is defined as an ordered dictionary to ensure the output is always in the same order. These examples work the same for normal hashtables, but the order of the output isn't predictable.
Each example returns a message for every key and its value:
The value of 'Number' is: 1 The value of 'Shape' is: Square The value of 'Color' is: Blue.
This example uses a foreach block to iterate over the keys.
foreach ($Key in $hash.Keys)
This example uses ForEach-Object to iterate over the keys.
$hash.Keys | ForEach-Object.
This example uses the GetEnumerator method to send each key-value pair through the pipeline to ForEach-Object .
$hash.GetEnumerator() | ForEach-Object.
This example uses the GetEnumerator and ForEach methods to iterate over each key-value pair.
$hash.GetEnumerator().ForEach()
Adding and Removing Keys and Values.
To add keys and values to a hashtable, use the following command format.
$hash[""] = ""
For example, to add a "Time" key with a value of "Now" to the hashtable, use the following statement format.
$hash["Time"] = "Now"
You can also add keys and values to a hashtable using the Add method of the System.Collections.Hashtable object. The Add method has the following syntax:
Add(Key, Value)
For example, to add a Time key with a value of Now to the hashtable, use the following statement format.
$hash.Add("Time", "Now")
And, you can add keys and values to a hashtable using the addition operator ( + ) to add a hashtable to an existing hashtable. For example, the following statement adds a Time key with a value of Now to the hashtable in the $hash variable.
$hash = $hash + @
You can also add values that are stored in variables.
$t = "Today" $now = (Get-Date) $hash.Add($t, $now)
You can't use a subtraction operator to remove a key-value pair from a hash table, but you can use the Remove method of the Hashtable object. The Remove method takes the key as its value.
The Remove method has the following syntax:
Remove(Key)
For example, to remove the Time=Now key-value pair from the hashtable in the value of the $hash variable, type:
$hash.Remove("Time")
You can use all of the properties and methods of Hashtable objects in PowerShell, including Contains , Clear , Clone , and CopyTo . For more information about Hashtable objects, see System.Collections.Hashtable.
Object Types in HashTables.
The keys and values in a hashtable can have any .NET object type, and a single hashtable can have keys and values of multiple types.
The following statement creates a hashtable of process name strings and process object values and saves it in the $p variable.
You can display the hashtable in $p and use the key-name properties to display the values.
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 441 251.
The keys in a hashtable can be any .NET type. The following statement adds a key-value pair to the hashtable in the $p variable. The key is a Service object that represents the WinRM service, and the value is the current status of the service.
$p = $p + @
You can display and access the new key-value pair using the same methods that you use for other pairs in the 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 WinRM.
The keys and values in a hashtable can also be Hashtable objects. The following statement adds key-value pair to the hashtable in the $p variable in which the key is a string, Hash2, and the value is a hashtable with three key-value pairs.
$p = $p + @
You can display and access the new values using the same methods.
PS> $p Name Value ---- ----- PowerShell System.Diagnostics.Process (pwsh) Hash2 Notepad System.Diagnostics.Process (Notepad) WinRM Running PS> $p.Hash2 Name Value ---- ----- a 1 b 2 c 3 PS> $p.Hash2.b 2.
Sorting Keys and Values.
The items in a hashtable are intrinsically unordered. The key-value pairs might appear in a different order each time that you display them.
Although you can't sort a hashtable, you can use the GetEnumerator method of hashtables to enumerate the keys and values, and then use the Sort-Object cmdlet to sort the enumerated values for display.
For example, the following commands enumerate the keys and values in the hash table in the $p variable and then sort the keys in alphabetical order.
PS> $p.GetEnumerator() | Sort-Object -Property key Name Value ---- ----- Hash2 Notepad System.Diagnostics.Process (Notepad) PowerShell System.Diagnostics.Process (pwsh) WinRM Running.
The following command uses the same procedure to sort the hash values in descending order.
PS> $p.GetEnumerator() | Sort-Object -Property Value -Descending Name Value ---- ----- PowerShell System.Diagnostics.Process (pwsh) Notepad System.Diagnostics.Process (Notepad) Hash2 WinRM Running.
Creating Objects from hashtables.
Beginning in PowerShell 3.0, you can create an object from a hashtable of properties and property values.
The syntax is as follows:
This method works only for classes that have a constructor that has no parameters. The object properties must be public and settable.
ConvertFrom-StringData.
The ConvertFrom-StringData cmdlet converts a string or a here-string of key-value pairs into a hashtable. You can use the ConvertFrom-StringData cmdlet safely in the Data section of a script, and you can use it with the Import-LocalizedData cmdlet to display user messages in the user-interface (UI) culture of the current user.
Here-strings are especially useful when the values in the hashtable include quotation marks. For more information about here-strings, see about_Quoting_Rules.
The following example shows how to create a here-string of the user messages in the previous example and how to use ConvertFrom-StringData to convert them from a string into a hashtable.
The following command creates a here-string of the key-value pairs and then saves it in the $string variable.
$string = @" Msg1 = Type "Windows". Msg2 = She said, "Hello, World." Msg3 = Enter an alias (or "nickname"). "@
This command uses the ConvertFrom-StringData cmdlet to convert the here-string into a hashtable.
ConvertFrom-StringData $string Name Value ---- ----- Msg3 Enter an alias (or "nickname"). Msg2 She said, "Hello, World." Msg1 Type "Windows".
For more information about here-strings, see about_Quoting_Rules.
See also.
about_Arrays about_Intrinsic_Members about_Object_Creation about_Quoting_Rules about_Script_Internationalization Import-LocalizedData ConvertFrom-StringData System.Collections.Hashtable.
Collaborate with us on GitHub.
The source for this content can be found on GitHub, where you can also create and review issues and pull requests. For more information, see our contributor guide.
unordered set example hash
marijuana strain review sites
weed seeds shop bg
the acacia strain merch store
invariant plane strain martensite
average price of weed in california
price for 1/4 weed
moon rock weed for sale online
where to buy marijuana seeds nj
coffee shop sittard skunk
buy medical weed online quickbooks
illegal to buy marijuana seeds online
grams of weed and prices
how to get medical marijuana card maine
cbd marketing wiki
kush cargo shop
highest thc seeds for sale
weed eater sale ebay
buy cannabis seeds online spain
buying weed in albany ny
blunt power wholesale
how to get medical marijuana in north carolina
buy durban poison uk
cannabis stocks to buy now
sydney cbd restaurants cheap
selling girl scout cookies on ebay
shisha shop brisbane
prices of weed weight
weed store orange county
grow shops uk cannabis seeds
train wreck weed price per gram
Dispensary kief prices
Atv weed wipers for
Where do you buy medical marijuana in georgia
Synthetic cannabis australia for sale
Buy marijuana online in the united states
Can pennsylvanians buy weed in new jersey
Buy hemp seed oil nz
Marijuana perfume to buy 1
How old to buy weed montreal 1
1kg weed price uk
Synthetic cannabis melbourne buy
Siser easy weed wholesale 1
Weed store lac la biche
Where to buy fresh dill weed near me
Grade a weed price
Indica cars for sale in bangalore
Where can i buy worx weed eater
Medical marijuana card louisiana online 1
Backwoods blunt wholesale
How to get moon rocks dst
Breckenridge cannabis club prices
Medical marijuana massachusetts price
Where to buy thc vape cartridges in massachusetts
Thc stock price target
Meat market melbourne cbd
Dirass order weed
Weed seed shop nl 1