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")
В PowerShell можно использовать все свойства и методы Hashtable объектов, включая Contains, Clear, Cloneи CopyTo. Дополнительные сведения об Hashtable объектах см. в разделе System.Collections.Hashtable.
Типы объектов в hashTables
Ключи и значения в хэш-таблицы могут иметь любой тип объекта .NET, а одна хэш-диаграмма может содержать ключи и значения нескольких типов.
Следующая инструкция создает хэш-таблицы из строк имени процесса и значений объекта процесса и сохраняет ее в переменной $p .
$p = @{"PowerShell" = (Get-Process PowerShell);
"Notepad" = (Get-Process notepad)}
Вы можете отобразить хэш-таблицы в $p и использовать свойства "ключ-имя" для отображения значений.
$p
Name Value
---- -----
PowerShell System.Diagnostics.Process (PowerShell)
Notepad System.Diagnostics.Process (notepad)
$p.PowerShell
Handles NPM(K) PM(K) WS(K) VM(M) CPU(s) Id ProcessName
------- ------ ----- ----- ----- ------ -- -----------
441 24 54196 54012 571 5.10 1788 PowerShell
$p.keys | foreach {$p.$_.handles}
441
251
Ключи в хэш-статье также могут иметь любой тип .NET. Следующая инструкция добавляет пару "ключ-значение" в хэш-таблица в переменной $p . Ключ — это объект Service , представляющий службу WinRM, а значение — текущее состояние службы.
$p = $p + @{(Get-Service WinRM) = ((Get-Service WinRM).Status)}
Вы можете отобразить новую пару "ключ-значение" и получить к ней доступ, используя те же методы, которые используются для других пар в хэш-сводке.
$p
Name Value
---- -----
PowerShell System.Diagnostics.Process (PowerShell)
Notepad System.Diagnostics.Process (notepad)
System.ServiceProcess.Servi... Running
$p.keys
PowerShell
Notepad
Status Name DisplayName
------ ---- -----------
Running winrm Windows Remote Management (WS-Manag...
$p.keys | foreach {$_.name}
winrm
Ключи и значения в хэш-таблицы также могут быть объектами Hashtable . Следующая инструкция добавляет пару "ключ-значение" к хэш-таблицам в $p переменной, в которой ключ является строкой, hash2, а значение — хэш-таблица с тремя парами "ключ-значение".
$p = $p + @{"Hash2"= @{a=1; b=2; c=3}}
Вы можете отобразить новые значения и получить доступ к ней с помощью одних и теми же методами.
$p
Name Value
---- -----
PowerShell System.Diagnostics.Process (PowerShell)
Notepad System.Diagnostics.Process (notepad)
System.ServiceProcess.Servi... Running
Hash2 {a, b, c}
$p.Hash2
Name Value
---- -----
a 1
b 2
c 3
$p.Hash2.b
2
Сортировка ключей и значений
Элементы в хэш-сводке по сути не упорядочены. Пары "ключ-значение" могут отображаться в другом порядке при каждом их отображении.
Хотя хэш-таблицы невозможно отсортировать, можно использовать метод GetEnumerator хэш-таблицы для перечисления ключей и значений, а затем с помощью командлета Sort-Object отсортировать перечисленные значения для отображения.
Например, следующие команды перечисляют ключи и значения в хэш-таблице в переменной $p , а затем сортируют ключи в алфавитном порядке.
$p.GetEnumerator() | Sort-Object -Property key
Name Value
---- -----
Notepad System.Diagnostics.Process (notepad)
PowerShell System.Diagnostics.Process (PowerShell)
System.ServiceProcess.Servi... Running
Следующая команда использует ту же процедуру для сортировки хэш-значений в порядке убывания.
$p.getenumerator() | Sort-Object -Property Value -Descending
Name Value
---- -----
PowerShell System.Diagnostics.Process (PowerShell)
Notepad System.Diagnostics.Process (notepad)
System.ServiceProcess.Servi... Running
Создание объектов из хэш-данных
Начиная с PowerShell 3.0, можно создать объект из хэш-таблицы свойств и значений свойств.
Синтаксис выглядит следующим образом:
[<class-name>]@{
<property-name>=<property-value>
<property-name>=<property-value>
}
Этот метод работает только для классов, имеющих конструктор без параметров. Свойства объекта должны быть открытыми и задаваться.
Дополнительные сведения см. в разделе about_Object_Creation.
ConvertFrom-StringData
Командлет ConvertFrom-StringData преобразует строку или строку здесь пар "ключ-значение" в хэш-строку. Командлет можно безопасно использовать ConvertFrom-StringData в разделе Данные скрипта, а также с командлетом Import-LocalizedData для отображения пользовательских сообщений в языке и региональных параметрах пользовательского интерфейса текущего пользователя.
Строки здесь особенно полезны, если значения в хэш-таблицы содержат кавычки. Дополнительные сведения о строках здесь см. в разделе about_Quoting_Rules.
В следующем примере показано, как создать строку здесь сообщений пользователя в предыдущем примере и как использовать ConvertFrom-StringData их для их преобразования из строки в хэш-схему.
Следующая команда создает строку здесь для пар "ключ-значение", а затем сохраняет ее в переменной $string .
$string = @"
Msg1 = Type "Windows".
Msg2 = She said, "Hello, World."
Msg3 = Enter an alias (or "nickname").
"@
Эта команда использует ConvertFrom-StringData командлет для преобразования строки here-string в хэш-сводку.
ConvertFrom-StringData $string
Name Value
---- -----
Msg3 Enter an alias (or "nickname").
Msg2 She said, "Hello, World."
Msg1 Type "Windows".
Дополнительные сведения о строках здесь см. в разделе about_Quoting_Rules.