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 de valores-chave. 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 de computador 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, pois as chaves sempre aparecem na ordem em que você as lista. A ordem das chaves em uma tabela de hash não é determinada.
As chaves e o valor nas tabelas de hash também são objetos .NET. Na maioria das vezes, 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 frequentemente usados 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.
Sintaxe
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:
- Comece a tabela de hash com um sinal de arroba (
@). - Coloque a tabela de hash entre chaves (
{}). - Insira um ou mais pares de valores-chave 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 de valores-chave. - 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 um objeto do OrderedDictionary 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 forma que usa tabelas de hash. Qualquer tipo pode ser usado como o valor de parâmetros que usam uma tabela de hash ou dicionário (iDictionary).
Não é possível 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 seguinte mensagem de erro.
[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 [ordered].
$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
hashtables 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 do nome da chave. Use o formato a seguir para exibir os valores de 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 de chave-valor na tabela de hash.
$hash.count
3
As tabelas de tabela de hash não são matrizes, portanto, você não pode usar um número inteiro como um índice na tabela de hash, mas 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ínseco psbase 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 saída idêntica. Eles repetem 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 de 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 de 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 formato de comando a seguir.
$hash["<key>"] = "<value>"
Por exemplo, para adicionar uma chave "Time" com um valor de "Now" à tabela de hash, use o formato de instrução a seguir.
$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 à tabela de hash, use o formato de Now instrução a seguir.
$hash.Add("Time", "Now")
E 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 para a tabela de Now 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 de valores-chave de uma tabela de hash, mas pode usar o Hashtable método Remove do 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, Clone, e 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 valores de objeto de processo e a salva na $p variável.
$p = @{
"PowerShell" = (Get-Process PowerShell)
"Notepad" = (Get-Process notepad)
}
Você pode exibir a tabela de hash e $p usar as propriedades do nome da chave 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 de 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 de valores-chave usando os mesmos métodos que usa para outros pares na tabela de hash.
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 um par chave-valor à tabela de hash na $p variável na qual a chave é uma cadeia de caracteres, Hash2, e o valor é uma tabela de hash com três pares de 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 {[a, 1], [b, 2], [c, 3]}
Notepad System.Diagnostics.Process (Notepad)
WinRM Running
PS> $p.Hash2
Name Value
---- -----
a 1
b 2
c 3
PS> $p.Hash2.b
2
Ordenando chaves e valores
Os itens em uma tabela de hash são intrinsecamente não ordenados. Os pares de chave-valor podem aparecer em uma ordem diferente cada vez que você os exibe.
Embora não seja possível classificar uma tabela de hash, você pode usar o método GetEnumerator de tabelas de hash 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 {[a, 1], [b, 2], [c, 3]}
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 {[a, 1], [b, 2], [c, 3]}
WinRM Running
Criando objetos a partir de tabelas de hash
A partir do PowerShell 3.0, você pode criar um objeto de uma tabela de hash de propriedades e valores de propriedade.
A sintaxe dela é a seguinte:
[<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 uma tabela de hash. Você pode usar o ConvertFrom-StringData cmdlet com segurança na seção Dados de um script e pode usá-lo com o Import-LocalizedData cmdlet para exibir mensagens do usuário na cultura da interface 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 here-strings, consulte about_Quoting_Rules.
O exemplo a seguir mostra como criar uma cadeia de caracteres here 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 de valores-chave e a salva 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 here em uma tabela de hash.
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 here-strings, consulte about_Quoting_Rules.
Confira também
Comentários
Em breve: Ao longo de 2024, eliminaremos os problemas do GitHub como o mecanismo de comentários para conteúdo e o substituiremos por um novo sistema de comentários. Para obter mais informações, consulte https://aka.ms/ContentUserFeedback.
Enviar e exibir comentários de