about_Hash_Tables
Краткое описание
Описывает создание, использование и сортировку хэш-таблицей в PowerShell.
Подробное описание
Хэш-таблицей, также известной как словарь или ассоциативный массив, представляет собой компактную структуру данных, в котором хранится одна или несколько пар "ключ-значение". Например, хэш-таблица может содержать ряд IP-адресов и имен компьютеров, где IP-адреса являются ключами, а имена компьютеров — значениями или наоборот.
В PowerShell каждая хэш-сводка является Hashtable[System.Collections.Hashtable] объектом . Свойства и методы Hashtable объектов можно использовать в PowerShell.
Начиная с PowerShell 3.0, вы можете использовать [ordered] атрибут для создания [System.Collections.Specialized.OrderedDictionary] объекта в PowerShell.
Упорядоченные словари отличаются от хэш-списков тем, что ключи всегда отображаются в порядке их перечисления. Порядок ключей в хэш-сводке не определен.
Ключи и значения в хэш-сводках также являются объектами .NET. Чаще всего это строки или целые числа, но они могут иметь любой тип объекта. Вы также можете создавать вложенные хэш-данные, в которых значение ключа является другой хэш-сводкой.
Hashtableчасто используются, так как они эффективны для поиска и извлечения данных. Хэш-таблицей можно использовать для хранения списков и создания вычисляемых свойств в PowerShell. Кроме того, в PowerShell есть командлет ConvertFrom-StringData, который преобразует строки в хэш-строку.
Синтаксис
Синтаксис хэш-сводки выглядит следующим образом:
@{ <name> = <value>; [<name> = <value> ] ...}
Синтаксис упорядоченного словаря выглядит следующим образом:
[ordered]@{ <name> = <value>; [<name> = <value> ] ...}
Ускоритель [ordered] типов появился в PowerShell 3.0.
Создание хэш-данных
Чтобы создать хэш-сводку, следуйте приведенным ниже рекомендациям.
- Начните хэш-сводку со знака at (
@). - Заключите хэш-систему в фигурные скобки (
{}). - Введите одну или несколько пар "ключ-значение" для содержимого хэш-стоимости.
- Используйте знак равенства (
=), чтобы отделить каждый ключ от его значения. - Используйте точку с запятой (
;) или разрыв строки для разделения пар "ключ-значение". - Ключи, содержащие пробелы, должны быть заключены в кавычки. Значения должны быть допустимыми выражениями PowerShell. Строки должны отображаться в кавычках, даже если они не содержат пробелов.
- Чтобы управлять хэш-сводкой, сохраните ее в переменной.
- При назначении упорядоченной хэш-статьи переменной поместите
[ordered]тип перед символом@. Если поместить его перед именем переменной, команда завершается ошибкой.
Чтобы создать пустую хэш-сводку в значении $hash, введите:
$hash = @{}
Вы также можете добавить ключи и значения в хэш-таблицы при ее создании. Например, следующая инструкция создает хэш-сводку с тремя ключами.
$hash = @{ Number = 1; Shape = "Square"; Color = "Blue"}
Создание упорядоченных словарей
Вы можете создать упорядоченный словарь, добавив объект OrderedDictionary типа , но самый простой способ создать упорядоченный словарь — использовать [ordered] атрибут .
Атрибут [ordered] представлен в PowerShell 3.0.
Поместите атрибут непосредственно перед символом "@".
$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}
Упорядоченные словари можно использовать так же, как и хэш-сводки. Любой тип можно использовать в качестве значения параметров, которые принимают хэш-сводку или словарь (iDictionary).
Атрибут нельзя использовать для [ordered] преобразования или приведения хэш-сводки. Если поместить упорядоченный атрибут перед именем переменной, команда завершается ошибкой со следующим сообщением об ошибке.
[ordered]$hash = @{}
ParserError:
Line |
1 | [ordered]$hash = @{}
| ~~~~~~~~~~~~~~
| The ordered attribute can be specified only on a hash literal node.
Чтобы исправить выражение, переместите атрибут [упорядочено].
$hash = [ordered]@{}
Вы можете привести упорядоченный словарь к хэш-таблицы, но не сможете восстановить упорядоченный атрибут, даже если очистить переменную и ввести новые значения. Чтобы восстановить порядок, необходимо удалить и повторно создать переменную.
[hashtable]$hash = [ordered]@{
Number = 1; Shape = "Square"; Color = "Blue"}
$hash
Name Value
---- -----
Color Blue
Shape Square
Number 1
Отображение хэш-сводок
Чтобы отобразить хэш-сводку, сохраненную в переменной, введите имя переменной. По умолчанию хэш-таблица отображается в виде таблицы с одним столбцом для ключей и одним столбцом для значений.
$hash
Name Value
---- -----
Shape Square
Color Blue
Number 1
Хэш-таблицы имеют свойства Keys и Values . Используйте точечное нотирование для отображения всех ключей или всех значений.
$hash.keys
Number
Shape
Color
$hash.values
1
Square
Blue
Каждое имя ключа также является свойством хэш-сводки, а его значением является значение свойства имени ключа. Используйте следующий формат для отображения значений свойств.
$hashtable.<key>
<value>
Пример:
$hash.Number
1
$hash.Color
Blue
Хэш-данные имеют свойство Count , указывающее количество пар "ключ-значение" в хэш-подсчете.
$hash.count
3
Хэш-таблицы не являются массивами, поэтому вы не можете использовать целое число в качестве индекса в хэш-таблице, но вы можете использовать имя ключа для индексирования в хэш-таблице. Если ключ является строковым значением, заключите имя ключа в кавычки.
Пример:
$hash["Number"]
1
Обработка конфликтов имен свойств
Если имя ключа сталкивается с одним из имен свойств типа HashTable, для доступа к этим свойствам можно использовать встроенный членpsbase. Например, если ключ имеет keys имя и вы хотите вернуть коллекцию ключей HashTable , используйте следующий синтаксис:
$hashtable.psbase.Keys
Это относится к другим типам, реализующих System.Collections.IDictionary интерфейс, например OrderedDictionary.
Перебор ключей и значений
Вы можете выполнить итерацию по ключам в хэш-таблицы, чтобы обработать значения несколькими способами. Каждый из примеров в этом разделе имеет одинаковые выходные данные. Они выполняют итерацию по переменной, определенной $hash здесь:
$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}
Примечание
В этих примерах определяется как упорядоченный словарь, $hash чтобы гарантировать, что выходные данные всегда будут в одном порядке. Эти примеры работают одинаково для обычных хэш-расписаний, но порядок выходных данных не предсказуем.
Каждый пример возвращает сообщение для каждого ключа и его значения:
The value of 'Number' is: 1
The value of 'Shape' is: Square
The value of 'Color' is: Blue
В этом примере для перебора ключей используется блок foreach .
foreach ($Key in $hash.Keys) {
"The value of '$Key' is: $($hash[$Key])"
}
В этом примере используется ForEach-Object для перебора ключей.
$hash.Keys | ForEach-Object {
"The value of '$_' is: $($hash[$_])"
}
В этом примере метод GetEnumerator используется для отправки каждой пары "ключ-значение" через конвейер в ForEach-Object.
$hash.GetEnumerator() | ForEach-Object {
"The value of '$($_.Key)' is: $($_.Value)"
}
В этом примере используются методы GetEnumerator и ForEach для итерации по каждой паре "ключ-значение".
$hash.GetEnumerator().ForEach({"The value of '$($_.Key)' is: $($_.Value)"})
Добавление и удаление ключей и значений
Чтобы добавить ключи и значения в хэш-таблицы, используйте следующий формат команды.
$hash["<key>"] = "<value>"
Например, чтобы добавить ключ Time со значением Now в хэш-таблицы, используйте следующий формат инструкции.
$hash["Time"] = "Now"
Вы также можете добавить ключи и значения в хэш-таблицы с помощью Add метода System.Collections.Hashtable объекта . Метод Add имеет следующий синтаксис:
Add(Key, Value)
Например, чтобы добавить Time ключ со значением Now в хэш-таблицы, используйте следующий формат инструкции.
$hash.Add("Time", "Now")
Кроме того, вы можете добавить ключи и значения в хэш-таблицу с помощью оператора сложения (+), чтобы добавить хэш-таблицу в существующую хэш-таблицу. Например, следующая инструкция добавляет Time ключ со значением Now в хэш-таблица в переменной $hash .
$hash = $hash + @{Time="Now"}
Можно также добавить значения, хранящиеся в переменных.
$t = "Today"
$now = (Get-Date)
$hash.Add($t, $now)
Оператор вычитания нельзя использовать для удаления пары "ключ-значение" из хэш-таблицы, но можно использовать метод Hashtable Remove объекта . Метод Remove принимает ключ в качестве значения.
Метод Remove имеет следующий синтаксис:
Remove(Key)
Например, чтобы удалить Time=Now пару "ключ-значение" из хэш-столбца в значении переменной $hash , введите:
$hash.Remove("Time")
Вы можете использовать все свойства и методы Hashtable объектов в PowerShell, включая Contains, Clear, Cloneи CopyTo. Дополнительные сведения об Hashtable объектах см. в разделе System.Collections.Hashtable.
Типы объектов в hashTables
Ключи и значения в хэш-таблицы могут иметь любой тип объекта .NET, а один хэш-таблицы может иметь ключи и значения нескольких типов.
Следующая инструкция создает хэш-таблицы из строк имени процесса и значений объектов процесса и сохраняет ее в переменной $p .
$p = @{
"PowerShell" = (Get-Process PowerShell)
"Notepad" = (Get-Process notepad)
}
Хэш-таблицы можно отобразить в $p и использовать свойства key-name для отображения значений.
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
Ключи в хэш-сводке могут быть любого типа .NET. Следующая инструкция добавляет пару "ключ-значение" в хэш-таблица в переменной $p . Ключ — это объект Service , представляющий службу WinRM, а значение — текущее состояние службы.
$p = $p + @{
(Get-Service WinRM) = ((Get-Service WinRM).Status)
}
Вы можете отобразить новую пару "ключ-значение" и получить к ней доступ, используя те же методы, которые используются для других пар в хэш-сводке.
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
Ключи и значения в хэш-таблицы также могут быть объектами Hashtable . Следующая инструкция добавляет пару "ключ-значение" в хэш-таблица в $p переменной, в которой ключ является строкой, Hash2, а значение — хэш-таблица с тремя парами "ключ-значение".
$p = $p + @{
"Hash2"= @{a=1; b=2; c=3}
}
Вы можете отобразить новые значения и получить доступ к ней с помощью одних и того же метода.
PS> $p
Name Value
---- -----
PowerShell System.Diagnostics.Process (pwsh)
Hash2 {[b, 2], [c, 3], [a, 1]}
WinRM Running
Notepad System.Diagnostics.Process (Notepad)
PS> $p.Hash2
Name Value
---- -----
b 2
c 3
a 1
PS> $p.Hash2.b
2
Сортировка ключей и значений
Элементы в хэш-статье внутренне неупорядочены. Пары "ключ-значение" могут отображаться в другом порядке при каждом отображении.
Хотя хэш-таблицы невозможно отсортировать, можно использовать метод GetEnumerator хэш-таблицы для перечисления ключей и значений, а затем использовать Sort-Object командлет для сортировки перечисленных значений для отображения.
Например, следующие команды перечисляют ключи и значения в хэш-таблице в переменной $p , а затем сортируют ключи в алфавитном порядке.
PS> $p.GetEnumerator() | Sort-Object -Property key
Name Value
---- -----
Hash2 {[b, 2], [c, 3], [a, 1]}
Notepad System.Diagnostics.Process (Notepad)
PowerShell System.Diagnostics.Process (pwsh)
WinRM Running
Следующая команда использует ту же процедуру для сортировки хэш-значений в порядке убывания.
PS> $p.GetEnumerator() | Sort-Object -Property Value -Descending
Name Value
---- -----
PowerShell System.Diagnostics.Process (pwsh)
Notepad System.Diagnostics.Process (Notepad)
Hash2 {[b, 2], [c, 3], [a, 1]}
WinRM Running
Создание объектов из хэш-списков
Начиная с PowerShell 3.0, можно создать объект из хэш-таблицы свойств и значений свойств.
Синтаксис выглядит следующим образом:
[<class-name>]@{
<property-name>=<property-value>
<property-name>=<property-value>
}
Этот метод работает только для классов, имеющих конструктор без параметров. Свойства объекта должны быть открытыми и настраиваемыми.
Дополнительные сведения см. в разделе about_Object_Creation.
ConvertFrom-StringData
Командлет ConvertFrom-StringData преобразует строку или строку здесь пар "ключ-значение" в хэш-строку. Командлет можно безопасно использовать ConvertFrom-StringData в разделе Data скрипта, а также с командлетом Import-LocalizedData для отображения сообщений пользователя в соответствии с языком и региональными параметрами пользовательского интерфейса текущего пользователя.
Строки здесь особенно полезны, если значения в хэш-таблицы содержат кавычки. Дополнительные сведения о строках здесь см. в разделе about_Quoting_Rules.
В следующем примере показано, как создать строку here из сообщений пользователя в предыдущем примере и как использовать ConvertFrom-StringData их для преобразования из строки в хэш-таблице.
Следующая команда создает строку here из пар "ключ-значение", а затем сохраняет ее в переменной $string .
$string = @"
Msg1 = Type "Windows".
Msg2 = She said, "Hello, World."
Msg3 = Enter an alias (or "nickname").
"@
Эта команда использует ConvertFrom-StringData командлет для преобразования строки here в хэш-строку.
ConvertFrom-StringData $string
Name Value
---- -----
Msg3 Enter an alias (or "nickname").
Msg2 She said, "Hello, World."
Msg1 Type "Windows".
Дополнительные сведения о строках здесь см. в разделе about_Quoting_Rules.