about_Hash_Tables
Descrição breve
Descreve como criar, usar e classificar hashtables no PowerShell.
Descrição longa
Uma hashtable, 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, onde os endereços IP são as chaves e os nomes de computador são os valores, ou vice-versa.
No PowerShell, cada hashtable é 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 porque 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 em hashtables 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 hashtables aninhadas, nas quais o valor de uma chave é outra hashtable.
Hashtables são usados com frequência porque são eficientes para localizar e recuperar dados. Você pode usar hashtables para armazenar listas e criar propriedades calculadas no PowerShell. Além disso, o PowerShell tem um cmdlet, ConvertFrom-StringData, que converte cadeias de caracteres em uma hashtable.
Sintaxe
A sintaxe de uma hashtable é 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 hashtables
Para criar uma tabela de hash, siga estas diretrizes:
- Inicie a hashtable com um sinal de arroba (
@). - Coloque a hashtable entre chaves (
{}). - Insira um ou mais pares chave-valor para o conteúdo da hashtable.
- 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 hashtable, salve-a em uma variável.
- Ao atribuir uma hashtable 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 hashtable 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 hashtables. 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 [ordenado].
$hash = [ordered]@{}
Você pode converter um dicionário ordenado em uma tabela de hash, mas não pode recuperar o atributo ordenado, mesmo se limpar a variável e inserir 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 hashtables é 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 hashtable, e seu valor é o valor da propriedade key name. Use o seguinte formato 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 chave-valor na hashtable.
$hash.count
3
As tabelas de hashtable não são matrizes, portanto, você não pode usar um inteiro como um índice na hashtable, mas pode usar um nome de chave para indexar na hashtable. 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 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 hashtables 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 através 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 sobre 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 hashtable, use o seguinte formato de comando.
$hash["<key>"] = "<value>"
Por exemplo, para adicionar uma chave "Time" com um valor de "Now" à hashtable, 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 à tabela de hash, use o seguinte formato de Now 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 à hashtable na $hash variável.
$hash = $hash + @{Time="Now"}
Você também pode adicionar valores que são armazenados em variáveis.
$t = "Today"
$now = (Get-Date)
$hash.Add($t, $now)
Não é possível usar um operador de subtração para remover um par chave-valor de uma tabela de hash, mas você 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 valores em uma hashtable podem ter qualquer tipo de objeto .NET, e uma única hashtable 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 hashtable e $p 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 hashtable 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 chave-valor usando os mesmos métodos usados 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 valores em uma hashtable também podem ser Hashtable objetos. A instrução a seguir adiciona o 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 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
Classificando chaves e valores
Os itens em uma tabela de hash 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 uma hashtable, você pode usar o método GetEnumerator de hashtables para enumerar as chaves e 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 a partir 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 usá-lo com o Import-LocalizedData cmdlet para exibir mensagens do usuário na cultura de interface do usuário (UI) do usuário atual.
Aqui-strings 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 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 aqui 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 cadeias de caracteres aqui, 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