about_Hash_Tables
Description courte
Décrit comment créer, utiliser et trier des tables de hachage dans PowerShell.
Description longue
Une table de hachage, également appelée dictionnaire ou tableau associatif, est une structure de données compacte qui stocke une ou plusieurs paires clé/valeur. Par exemple, une table de hachage peut contenir une série d’adresses IP et de noms d’ordinateurs, où les adresses IP sont les clés et les noms d’ordinateurs sont les valeurs, ou vice versa.
Dans PowerShell, chaque table de hachage est un objet Hashtable (System.Collections.Hashtable). Vous pouvez utiliser les propriétés et les méthodes des objets Hashtable dans PowerShell.
À compter de PowerShell 3.0, vous pouvez utiliser l’attribut [ordered] pour créer un dictionnaire ordonné (System.Collections.Specialized.OrderedDictionary) dans PowerShell.
Les dictionnaires triés diffèrent des tables de hachage en ce que les clés apparaissent toujours dans l’ordre dans lequel vous les répertoriez. L’ordre des clés dans une table de hachage n’est pas déterminé.
Les clés et la valeur dans les tables de hachage sont également des objets .NET. Il s’agit le plus souvent de chaînes ou d’entiers, mais ils peuvent avoir n’importe quel type d’objet. Vous pouvez également créer des tables de hachage imbriquées, dans lesquelles la valeur d’une clé est une autre table de hachage.
Les tables de hachage sont fréquemment utilisées, car elles sont très efficaces pour rechercher et récupérer des données. Vous pouvez utiliser des tables de hachage pour stocker des listes et créer des propriétés calculées dans PowerShell. Et, PowerShell a une applet de commande, ConvertFrom-StringData, qui convertit les chaînes en table de hachage.
Syntax
La syntaxe d’une table de hachage est la suivante :
@{ <name> = <value>; [<name> = <value> ] ...}
La syntaxe d’un dictionnaire ordonné est la suivante :
[ordered]@{ <name> = <value>; [<name> = <value> ] ...}
L’attribut [ordered] a été introduit dans PowerShell 3.0.
Création de tables de hachage
Pour créer une table de hachage, suivez ces instructions :
- Commencez la table de hachage avec un signe at (
@). - Placez la table de hachage entre accolades (
{}). - Entrez une ou plusieurs paires clé/valeur pour le contenu de la table de hachage.
- Utilisez un signe égal (
=) pour séparer chaque clé de sa valeur. - Utilisez un point-virgule (
;) ou un saut de ligne pour séparer les paires clé/valeur. - Les clés qui contiennent des espaces doivent être placées entre guillemets. Les valeurs doivent être des expressions PowerShell valides. Les chaînes doivent apparaître entre guillemets, même si elles n’incluent pas d’espaces.
- Pour gérer la table de hachage, enregistrez-la dans une variable.
- Lorsque vous affectez une table de hachage ordonnée à une variable, placez l’attribut [ordonné] avant le
@symbole. Si vous le placez avant le nom de la variable, la commande échoue.
Pour créer une table de hachage vide dans la valeur de $hash, tapez :
$hash = @{}
Vous pouvez également ajouter des clés et des valeurs à une table de hachage lorsque vous la créez. Par exemple, l’instruction suivante crée une table de hachage avec trois clés.
$hash = @{ Number = 1; Shape = "Square"; Color = "Blue"}
Création de dictionnaires triés
Vous pouvez créer un dictionnaire ordonné en ajoutant un objet de type OrderedDictionary , mais le moyen le plus simple de créer un dictionnaire ordonné est d’utiliser l’attribut [ordered] .
L’attribut [ordered] est introduit dans PowerShell 3.0.
Placez l’attribut juste avant le symbole « @ ».
$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}
Vous pouvez utiliser des dictionnaires ordonnés de la même façon que vous utilisez des tables de hachage. Les deux types peuvent être utilisés comme valeur de paramètres qui prennent une table de hachage ou un dictionnaire (iDictionary).
Vous ne pouvez pas utiliser l’attribut [ordered] pour convertir ou convertir une table de hachage. Si vous placez l’attribut ordonné avant le nom de la variable, la commande échoue avec le message d’erreur suivant.
[ordered]$hash = @{}
ParserError:
Line |
1 | [ordered]$hash = @{}
| ~~~~~~~~~~~~~~
| The ordered attribute can be specified only on a hash literal node.
Pour corriger l’expression, déplacez l’attribut [ordonné].
$hash = [ordered]@{}
Vous pouvez convertir un dictionnaire ordonné en table de hachage, mais vous ne pouvez pas récupérer l’attribut ordonné, même si vous effacez la variable et entrez de nouvelles valeurs. Pour rétablir l’ordre, vous devez supprimer et recréer la variable.
[hashtable]$hash = [ordered]@{
Number = 1; Shape = "Square"; Color = "Blue"}
$hash
Name Value
---- -----
Color Blue
Shape Square
Number 1
Affichage des tables de hachage
Pour afficher une table de hachage enregistrée dans une variable, tapez le nom de la variable. Par défaut, une table de hachage est affichée sous la forme d’une table avec une colonne pour les clés et une colonne pour les valeurs.
$hash
Name Value
---- -----
Shape Square
Color Blue
Number 1
Les tables de hachage ont des propriétés Clés et Valeurs. Utilisez la notation par points pour afficher toutes les clés ou toutes les valeurs.
$hash.keys
Number
Shape
Color
$hash.values
1
Square
Blue
Chaque nom de clé est également une propriété de la table de hachage, et sa valeur est la valeur de la propriété key-name. Utilisez le format suivant pour afficher les valeurs de propriété.
$hashtable.<key>
<value>
Par exemple :
$hash.Number
1
$hash.Color
Blue
Si le nom de clé entre en collision avec l’un des noms de propriété du type HashTable, vous pouvez utiliser PSBase pour accéder à ces propriétés. Par exemple, si le nom de la clé est keys et que vous souhaitez retourner la collection de clés, utilisez la syntaxe suivante :
$hashtable.PSBase.Keys
Les tables de hachage ont une propriété Count qui indique le nombre de paires clé-valeur dans la table de hachage.
$hash.count
3
Les tables de table de hachage ne sont pas des tableaux. Vous ne pouvez donc pas utiliser un entier comme index dans la table de hachage, mais vous pouvez utiliser un nom de clé pour indexer dans la table de hachage. Si la clé est une valeur de chaîne, placez le nom de la clé entre guillemets.
Par exemple :
$hash["Number"]
1
Ajout et suppression de clés et de valeurs
Pour ajouter des clés et des valeurs à une table de hachage, utilisez le format de commande suivant.
$hash["<key>"] = "<value>"
Par exemple, pour ajouter une clé « Heure » avec la valeur « Maintenant » à la table de hachage, utilisez le format d’instruction suivant.
$hash["Time"] = "Now"
Vous pouvez également ajouter des clés et des valeurs à une table de hachage à l’aide de la méthode Add de l’objet System.Collections.Hashtable. La méthode Add a la syntaxe suivante :
Add(Key, Value)
Par exemple, pour ajouter une clé « Heure » avec la valeur « Maintenant » à la table de hachage, utilisez le format d’instruction suivant.
$hash.Add("Time", "Now")
Vous pouvez également ajouter des clés et des valeurs à une table de hachage à l’aide de l’opérateur d’ajout (+) pour ajouter une table de hachage à une table de hachage existante. Par exemple, l’instruction suivante ajoute une clé « Time » avec la valeur « Now » à la table de hachage dans la variable $hash.
$hash = $hash + @{Time="Now"}
Vous pouvez également ajouter des valeurs stockées dans des variables.
$t = "Today"
$now = (Get-Date)
$hash.Add($t, $now)
Vous ne pouvez pas utiliser un opérateur de soustraction pour supprimer une paire clé/valeur d’une table de hachage, mais vous pouvez utiliser la méthode Remove de l’objet Hashtable. La méthode Remove prend la clé comme valeur.
La méthode Remove a la syntaxe suivante :
Remove(Key)
Par exemple, pour supprimer la paire clé/valeur Time=Now de la table de hachage dans la valeur de la variable $hash, tapez :
$hash.Remove("Time")
Vous pouvez utiliser toutes les propriétés et méthodes des objets Hashtable dans PowerShell, notamment Contains, Clear, Clone et CopyTo. Pour plus d’informations sur les objets Hashtable, consultez System.Collections.Hashtable.
Types d’objets dans HashTables
Les clés et les valeurs d’une table de hachage peuvent avoir n’importe quel type d’objet .NET, et une table de hachage unique peut avoir des clés et des valeurs de plusieurs types.
L’instruction suivante crée une table de hachage de chaînes de noms de processus et de valeurs d’objet de processus et l’enregistre dans la $p variable.
$p = @{"PowerShell" = (Get-Process PowerShell);
"Notepad" = (Get-Process notepad)}
Vous pouvez afficher la table de hachage dans $p et utiliser les propriétés key-name pour afficher les valeurs.
$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
Les clés d’une table de hachage peuvent également être n’importe quel type .NET. L’instruction suivante ajoute une paire clé/valeur à la table de hachage dans la $p variable. La clé est un objet Service qui représente le service WinRM, et la valeur est la status actuelle du service.
$p = $p + @{(Get-Service WinRM) = ((Get-Service WinRM).Status)}
Vous pouvez afficher la nouvelle paire clé/valeur et y accéder à l’aide des mêmes méthodes que celles que vous utilisez pour d’autres paires dans la table de hachage.
$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
Les clés et les valeurs d’une table de hachage peuvent également être des objets Hashtable. L’instruction suivante ajoute une paire clé/valeur à la table de hachage dans la $p variable dans laquelle la clé est une chaîne, Hash2, et la valeur est une table de hachage avec trois paires clé/valeur.
$p = $p + @{"Hash2"= @{a=1; b=2; c=3}}
Vous pouvez afficher les nouvelles valeurs et y accéder à l’aide des mêmes méthodes.
$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
Tri des clés et des valeurs
Les éléments d’une table de hachage sont intrinsèquement non triés. Les paires clé/valeur peuvent apparaître dans un ordre différent chaque fois que vous les affichez.
Bien que vous ne puissiez pas trier une table de hachage, vous pouvez utiliser la méthode GetEnumerator des tables de hachage pour énumérer les clés et les valeurs, puis utiliser l’applet de commande Sort-Object pour trier les valeurs énumérées à afficher.
Par exemple, les commandes suivantes énumèrent les clés et les valeurs de la table de hachage dans la $p variable, puis trient les clés par ordre alphabétique.
$p.GetEnumerator() | Sort-Object -Property key
Name Value
---- -----
Notepad System.Diagnostics.Process (notepad)
PowerShell System.Diagnostics.Process (PowerShell)
System.ServiceProcess.Servi... Running
La commande suivante utilise la même procédure pour trier les valeurs de hachage dans l’ordre décroissant.
$p.getenumerator() | Sort-Object -Property Value -Descending
Name Value
---- -----
PowerShell System.Diagnostics.Process (PowerShell)
Notepad System.Diagnostics.Process (notepad)
System.ServiceProcess.Servi... Running
Création d’objets à partir de tables de hachage
À partir de PowerShell 3.0, vous pouvez créer un objet à partir d’une table de hachage de propriétés et de valeurs de propriété.
La syntaxe est la suivante :
[<class-name>]@{
<property-name>=<property-value>
<property-name>=<property-value>
}
Cette méthode fonctionne uniquement pour les classes qui ont un constructeur null, c’est-à-dire un constructeur qui n’a aucun paramètre. Les propriétés de l’objet doivent être publiques et paramétrables.
Pour plus d’informations, consultez about_Object_Creation.
ConvertFrom-StringData
L’applet ConvertFrom-StringData de commande convertit une chaîne ou une chaîne ici de paires clé/valeur en table de hachage. Vous pouvez utiliser l’applet ConvertFrom-StringData de commande en toute sécurité dans la section Données d’un script, et vous pouvez l’utiliser avec l’applet Import-LocalizedData de commande pour afficher les messages utilisateur dans la culture de l’interface utilisateur de l’utilisateur actuel.
Les chaînes here sont particulièrement utiles lorsque les valeurs de la table de hachage incluent des guillemets. Pour plus d’informations sur les chaînes here, consultez about_Quoting_Rules.
L’exemple suivant montre comment créer une chaîne here des messages utilisateur dans l’exemple précédent et comment les convertir ConvertFrom-StringData à partir d’une chaîne en table de hachage.
La commande suivante crée une chaîne here des paires clé/valeur, puis l’enregistre dans la $string variable.
$string = @"
Msg1 = Type "Windows".
Msg2 = She said, "Hello, World."
Msg3 = Enter an alias (or "nickname").
"@
Cette commande utilise l’applet de ConvertFrom-StringData commande pour convertir la chaîne here en table de hachage.
ConvertFrom-StringData $string
Name Value
---- -----
Msg3 Enter an alias (or "nickname").
Msg2 She said, "Hello, World."
Msg1 Type "Windows".
Pour plus d’informations sur les chaînes here, consultez about_Quoting_Rules.