about_Hash_Tables
Descrição breve
Descreve como criar, usar e classificar tabelas de hash no PowerShell.
Descrição longa
Uma tabela de hash, também conhecida como dicionário ou matriz associativa, é uma estrutura de dados compacta que armazena um ou mais pares chave-valor. Por exemplo, uma tabela de hash pode conter uma série de endereços IP e nomes de computador, em que os endereços IP são as chaves e os nomes dos computadores são os valores ou vice-versa.
No PowerShell, cada tabela de hash é um Hashtable[System.Collections.Hashtable] objeto . Você pode usar as propriedades e os métodos de Hashtable objetos no PowerShell.
A partir do PowerShell 3.0, você pode usar o [ordered] atributo para criar um [System.Collections.Specialized.OrderedDictionary] objeto no PowerShell.
Os dicionários ordenados diferem das tabelas de hash, em que as chaves sempre aparecem na ordem em que você os lista. A ordem das chaves em uma tabela de hash não é determinada.
As chaves e o valor em tabelas de hash também são objetos .NET. Eles geralmente são cadeias de caracteres ou inteiros, mas podem ter qualquer tipo de objeto. Você também pode criar tabelas de hash aninhadas, nas quais o valor de uma chave é outra tabela de hash.
Hashtables são usados com frequência porque são eficientes para localizar e recuperar dados. Você pode usar tabelas de hash para armazenar listas e criar propriedades calculadas no PowerShell. E o PowerShell tem um cmdlet, ConvertFrom-StringData, que converte cadeias de caracteres em uma tabela de hash.
Syntax
A sintaxe de uma tabela de hash é a seguinte:
@{ <name> = <value>; [<name> = <value> ] ...}
A sintaxe de um dicionário ordenado é a seguinte:
[ordered]@{ <name> = <value>; [<name> = <value> ] ...}
O [ordered] acelerador de tipo foi introduzido no PowerShell 3.0.
Criando tabelas de hash
Para criar uma tabela de hash, siga estas diretrizes:
- Inicie a tabela de hash com um sinal (
@). - Coloque a tabela de hash entre chaves (
{}). - Insira um ou mais pares chave-valor para o conteúdo da tabela de hash.
- Use um sinal de igual (
=) para separar cada chave de seu valor. - Use um ponto e vírgula (
;) ou uma quebra de linha para separar os pares chave-valor. - As chaves que contêm espaços devem ser colocadas entre aspas. Os valores devem ser expressões válidas do PowerShell. As cadeias de caracteres devem aparecer entre aspas, mesmo que não incluam espaços.
- Para gerenciar a tabela de hash, salve-a em uma variável.
- Ao atribuir uma tabela de hash ordenada a uma variável, coloque o
[ordered]tipo antes do@símbolo. Se você colocá-lo antes do nome da variável, o comando falhará.
Para criar uma tabela de hash vazia no valor de $hash, digite:
$hash = @{}
Você também pode adicionar chaves e valores a uma tabela de hash ao criá-la. Por exemplo, a instrução a seguir cria uma tabela de hash com três chaves.
$hash = @{ Number = 1; Shape = "Square"; Color = "Blue"}
Criando dicionários ordenados
Você pode criar um dicionário ordenado adicionando OrderedDictionary um objeto do tipo , mas a maneira mais fácil de criar um dicionário ordenado é usar o [ordered] atributo .
O [ordered] atributo é introduzido no PowerShell 3.0.
Coloque o atributo imediatamente antes do símbolo "@".
$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}
Você pode usar dicionários ordenados da mesma maneira que usa tabelas de hash. Qualquer tipo pode ser usado como o valor dos parâmetros que utilizam uma tabela de hash ou um dicionário (iDictionary).
Você não pode usar o [ordered] atributo para converter ou converter uma tabela de hash. Se você colocar o atributo ordenado antes do nome da variável, o comando falhará com a mensagem de erro a seguir.
[ordered]$hash = @{}
ParserError:
Line |
1 | [ordered]$hash = @{}
| ~~~~~~~~~~~~~~
| The ordered attribute can be specified only on a hash literal node.
Para corrigir a expressão, mova o atributo [ordenado].
$hash = [ordered]@{}
Você pode converter um dicionário ordenado em uma tabela de hash, mas não pode recuperar o atributo ordenado, mesmo que limpe a variável e insira novos valores. Para restabelecer a ordem, você deve remover e recriar a variável.
[hashtable]$hash = [ordered]@{
Number = 1; Shape = "Square"; Color = "Blue"}
$hash
Name Value
---- -----
Color Blue
Shape Square
Number 1
Exibindo tabelas de hash
Para exibir uma tabela de hash salva em uma variável, digite o nome da variável. Por padrão, uma tabela de hash é exibida como uma tabela com uma coluna para chaves e outra para valores.
$hash
Name Value
---- -----
Shape Square
Color Blue
Number 1
tabelas de hash têm propriedades Keys e Values . Use a notação de ponto para exibir todas as chaves ou todos os valores.
$hash.keys
Number
Shape
Color
$hash.values
1
Square
Blue
Cada nome de chave também é uma propriedade da tabela de hash e seu valor é o valor da propriedade de nome da chave. Use o formato a seguir para exibir os valores da propriedade.
$hashtable.<key>
<value>
Por exemplo:
$hash.Number
1
$hash.Color
Blue
hashtables têm uma propriedade Count que indica o número de pares chave-valor na tabela de hash.
$hash.count
3
tabelas hashtable não são matrizes, portanto, você não pode usar um inteiro como um índice na tabela de hash, mas você pode usar um nome de chave para indexar na tabela de hash. Se a chave for um valor de cadeia de caracteres, coloque o nome da chave entre aspas.
Por exemplo:
$hash["Number"]
1
Manipulando colisões de nome de propriedade
Se o nome da chave colidir com um dos nomes de propriedade do tipo HashTable, você poderá usar o membro intrínsecopsbase para acessar essas propriedades. Por exemplo, se o nome da chave for keys e você quiser retornar a coleção das chaves HashTable , use esta sintaxe:
$hashtable.psbase.Keys
Isso se aplica a outros tipos que implementam a System.Collections.IDictionary interface, como OrderedDictionary.
Iterando sobre chaves e valores
Você pode iterar sobre as chaves em uma tabela de hash para processar os valores de várias maneiras. Cada um dos exemplos nesta seção tem uma saída idêntica. Eles iteram sobre a $hash variável definida aqui:
$hash = [ordered]@{ Number = 1; Shape = "Square"; Color = "Blue"}
Observação
Nesses exemplos, $hash é definido como um dicionário ordenado para garantir que a saída esteja sempre na mesma ordem. Esses exemplos funcionam da mesma forma para tabelas de hash normais, mas a ordem da saída não é previsível.
Cada exemplo retorna uma mensagem para cada chave e seu valor:
The value of 'Number' is: 1
The value of 'Shape' is: Square
The value of 'Color' is: Blue
Este exemplo usa um bloco foreach para iterar sobre as chaves.
foreach ($Key in $hash.Keys) {
"The value of '$Key' is: $($hash[$Key])"
}
Este exemplo usa ForEach-Object para iterar sobre as chaves.
$hash.Keys | ForEach-Object {
"The value of '$_' is: $($hash[$_])"
}
Este exemplo usa o método GetEnumerator para enviar cada par chave-valor por meio do pipeline para ForEach-Object.
$hash.GetEnumerator() | ForEach-Object {
"The value of '$($_.Key)' is: $($_.Value)"
}
Este exemplo usa os métodos GetEnumerator e ForEach para iterar em cada par chave-valor.
$hash.GetEnumerator().ForEach({"The value of '$($_.Key)' is: $($_.Value)"})
Adicionando e removendo chaves e valores
Para adicionar chaves e valores a uma tabela de hash, use o seguinte formato de comando.
$hash["<key>"] = "<value>"
Por exemplo, para adicionar uma chave "Time" com um valor de "Now" à tabela de hash, use o seguinte formato de instrução.
$hash["Time"] = "Now"
Você também pode adicionar chaves e valores a uma tabela de hash usando o Add método do System.Collections.Hashtable objeto . O Add método tem a seguinte sintaxe:
Add(Key, Value)
Por exemplo, para adicionar uma Time chave com um valor de Now à tabela de hash, use o seguinte formato de instrução.
$hash.Add("Time", "Now")
Além disso, você pode adicionar chaves e valores a uma tabela de hash usando o operador de adição (+) para adicionar uma tabela de hash a uma tabela de hash existente. Por exemplo, a instrução a seguir adiciona uma Time chave com um valor de Now à tabela de hash na $hash variável .
$hash = $hash + @{Time="Now"}
Você também pode adicionar valores armazenados em variáveis.
$t = "Today"
$now = (Get-Date)
$hash.Add($t, $now)
Você não pode usar um operador de subtração para remover um par chave-valor de uma tabela de hash, mas pode usar o método Remove do Hashtable objeto . O método Remove usa a chave como seu valor.
O Remove método tem a seguinte sintaxe:
Remove(Key)
Por exemplo, para remover o Time=Now par chave-valor da tabela de hash no valor da $hash variável, digite:
$hash.Remove("Time")
Você pode usar todas as propriedades e métodos de Hashtable objetos no PowerShell, incluindo Contains, Clear, Clonee CopyTo. Para obter mais informações sobre Hashtable objetos, consulte System.Collections.Hashtable.
Tipos de objeto em HashTables
As chaves e os valores em uma tabela de hash podem ter qualquer tipo de objeto .NET e uma única tabela de hash pode ter chaves e valores de vários tipos.
A instrução a seguir cria uma tabela de hash de cadeias de caracteres de nome de processo e processa valores de objeto e salva-a na $p variável .
$p = @{
"PowerShell" = (Get-Process PowerShell)
"Notepad" = (Get-Process notepad)
}
Você pode exibir a tabela de hash em $p e usar as propriedades key-name para exibir os valores.
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
As chaves em uma tabela de hash podem ser qualquer tipo .NET. A instrução a seguir adiciona um par chave-valor à tabela de hash na $p variável . A chave é um objeto Service que representa o serviço WinRM e o valor é o status atual do serviço.
$p = $p + @{
(Get-Service WinRM) = ((Get-Service WinRM).Status)
}
Você pode exibir e acessar o novo par chave-valor usando os mesmos métodos usados para outros pares no 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
As chaves e os valores em uma tabela de hash também podem ser Hashtable objetos. A instrução a seguir adiciona o par chave-valor ao hashtable na variável na $p qual a chave é uma cadeia de caracteres, Hash2 e o valor é um hashtable com três pares chave-valor.
$p = $p + @{
"Hash2"= @{a=1; b=2; c=3}
}
Você pode exibir e acessar os novos valores usando os mesmos métodos.
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
Classificando chaves e valores
Os itens em um hashtable são intrinsecamente não ordenados. Os pares chave-valor podem aparecer em uma ordem diferente cada vez que você os exibe.
Embora não seja possível classificar um hashtable, você pode usar o método GetEnumerator de hashtables para enumerar as chaves e os valores e, em seguida, usar o Sort-Object cmdlet para classificar os valores enumerados para exibição.
Por exemplo, os comandos a seguir enumeram as chaves e os valores na tabela de hash na variável e, em $p seguida, classificam as chaves em ordem alfabética.
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
O comando a seguir usa o mesmo procedimento para classificar os valores de hash em ordem decrescente.
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
Criando objetos de tabelas de hash
A partir do PowerShell 3.0, você pode criar um objeto com base em um hash de propriedades e valores de propriedade.
A sintaxe é mostrada a seguir:
[<class-name>]@{
<property-name>=<property-value>
<property-name>=<property-value>
}
Esse método funciona apenas para classes que têm um construtor que não tem parâmetros. As propriedades do objeto devem ser públicas e configuráveis.
Para obter mais informações, consulte about_Object_Creation.
ConvertFrom-StringData
O ConvertFrom-StringData cmdlet converte uma cadeia de caracteres ou uma cadeia de caracteres aqui de pares chave-valor em um hashtable. Você pode usar o ConvertFrom-StringData cmdlet com segurança na seção Dados de um script e usá-lo com o Import-LocalizedData cmdlet para exibir mensagens do usuário na cultura da interface do usuário do usuário atual.
As cadeias de caracteres aqui são especialmente úteis quando os valores na tabela de hash incluem aspas. Para obter mais informações sobre cadeias de caracteres aqui, consulte about_Quoting_Rules.
O exemplo a seguir mostra como criar uma cadeia de caracteres aqui das mensagens do usuário no exemplo anterior e como usá-las ConvertFrom-StringData para convertê-las de uma cadeia de caracteres em uma tabela de hash.
O comando a seguir cria uma cadeia de caracteres aqui dos pares chave-valor e, em seguida, salva-o na $string variável .
$string = @"
Msg1 = Type "Windows".
Msg2 = She said, "Hello, World."
Msg3 = Enter an alias (or "nickname").
"@
Esse comando usa o ConvertFrom-StringData cmdlet para converter a cadeia de caracteres aqui em um hashtable.
ConvertFrom-StringData $string
Name Value
---- -----
Msg3 Enter an alias (or "nickname").
Msg2 She said, "Hello, World."
Msg1 Type "Windows".
Para obter mais informações sobre cadeias de caracteres aqui, consulte about_Quoting_Rules.