Sobre matrizes

Descrição breve

Descreve matrizes, que são estruturas de dados projetadas para armazenar coleções de itens.

Descrição longa

Uma matriz é uma estrutura de dados que é projetada para armazenar uma coleção de itens. Os itens podem ser do mesmo tipo ou tipos diferentes.

A partir do Windows PowerShell 3,0, uma coleção de zero ou um objeto tem algumas propriedades de matrizes.

Criando e inicializando uma matriz

Para criar e inicializar uma matriz, atribua vários valores a uma variável. Os valores armazenados na matriz são delimitados por uma vírgula e separados do nome da variável pelo operador de atribuição (=).

Por exemplo, para criar uma matriz chamada $A que contenha os sete valores numéricos (int) de 22, 5, 10, 8, 12, 9 e 80, digite:

$A = 22,5,10,8,12,9,80

Você também pode criar e inicializar uma matriz usando o operador de intervalo (..). Por exemplo, para criar e inicializar uma matriz denominada "$B" que contém os valores de 5 a 8, digite:

$B = 5..8

Como resultado, $B contém quatro valores: 5, 6, 7 e 8.

Quando nenhum tipo de dados é especificado, o PowerShell cria cada matriz como uma matriz de objetos (tipo: System. Object []). Para determinar o tipo de dados de uma matriz, use o método GetType (). Por exemplo, para determinar o tipo de dados da matriz de $a, digite:

$a.GetType()

Para criar uma matriz fortemente tipada, ou seja, uma matriz que possa conter apenas valores de um tipo específico, converta a variável como um tipo de matriz, como String [], Long [] ou Int32 []. Para converter uma matriz, preceda o nome da variável com um tipo de matriz entre colchetes. Por exemplo, para criar uma matriz de inteiros de 32 bits chamada $ia contendo quatro inteiros (1500, 2230, 3350 e 4000), digite:

[int32[]]$ia = 1500,2230,3350,4000

Como resultado, a matriz de $ia pode conter apenas números inteiros.

Você pode criar matrizes que são convertidas para qualquer tipo com suporte na estrutura de Microsoft .NET. Por exemplo, os objetos que o Get-Process recupera para representar processos são do tipo System. Diagnostics. Process. Para criar uma matriz fortemente tipada de objetos de processo, digite o seguinte comando:

[Diagnostics.Process[]]$zz = Get-Process

O operador de subexpressão de matriz

O operador de subexpressão de matriz cria uma matriz, mesmo que contenha zero ou um objeto.

A sintaxe do operador de matriz é a seguinte:

@( ... )

Você pode usar o operador de matriz para criar uma matriz de zero ou um objeto. Por exemplo:

PS> $a = @("Hello World")
PS> $a.Count
1

PS> $b = @()
PS> $b.Count
0

O operador de matriz é particularmente útil em scripts quando você está obtendo objetos, mas não sabe quantos objetos serão obtidos. Por exemplo:

$p = @(Get-Process Notepad)

Para obter mais informações sobre o operador de subexpressão de matriz, consulte about_Operators.

Acessando e usando elementos de matriz

Lendo uma matriz

Você pode fazer referência a uma matriz usando seu nome de variável. Para exibir todos os elementos na matriz, digite o nome da matriz. Por exemplo, supondo que $a seja uma matriz contendo inteiros 0, 1, 2, até 9; digitando:

$a

0
1
2
3
4
5
6
7
8
9

Você pode consultar os elementos em uma matriz usando um índice, começando na posição 0. Coloque o número de índice entre colchetes. Por exemplo, para exibir o primeiro elemento na $a matriz, digite:

$a[0]

0

Para exibir o terceiro elemento na $a matriz, digite:

$a[2]

2

Você pode recuperar parte da matriz usando um operador de intervalo para o índice. Por exemplo, para recuperar o segundo para o quinto elementos da matriz, você digitaria:

$a[1..4]

1
2
3
4

Contagem de números negativos do final da matriz. Por exemplo, "-1" refere-se ao último elemento da matriz. Para exibir os três últimos elementos da matriz, em ordem crescente de índice, digite:

$a = 0 .. 9
$a[-3..-1]

7
8
9

Se você digitar índices negativos em ordem decrescente, sua saída será alterada.

$a = 0 .. 9
$a[-1..-3]

9
8
7

No entanto, tenha cuidado ao usar essa notação. A notação percorre o limite final até o início da matriz.

$a = 0 .. 9
$a[2..-2]

2
1
0
9
8

Além disso, um erro comum é assumir a $a[0..-2] referência a todos os elementos da matriz, exceto para o último. Refere-se ao primeiro, ao último e ao último elemento da matriz.

Você pode usar o operador de adição (+) para combinar intervalos com uma lista de elementos em uma matriz. Por exemplo, para exibir os elementos nas posições de índice 0, 2 e 4 a 6, digite:

$a = 0 .. 9
$a[0,2+4..6]

0
2
4
5
6

Além disso, para listar vários intervalos e elementos individuais, você pode usar o operador de adição. Por exemplo, para listar os elementos de zero a dois, quatro a seis e o elemento em um oitavo tipo posicional:

$a = 0..9
$a[+0..2+4..6+8]

0
1
2
4
5
6
8

Iterações sobre elementos de matriz

Você também pode usar constructos de loop, como ForEach, for e loops while, para se referir aos elementos em uma matriz. Por exemplo, para usar um loop ForEach para exibir os elementos na $a matriz, digite:

$a = 0..9
foreach ($element in $a) {
  $element
}

0
1
2
3
4
5
6
7
8
9

O loop foreach itera na matriz e retorna cada valor na matriz até chegar ao final da matriz.

O loop for é útil quando você está incrementando contadores ao examinar os elementos em uma matriz. Por exemplo, para usar um loop for para retornar todos os outros valores em uma matriz, digite:

$a = 0..9
for ($i = 0; $i -le ($a.length - 1); $i += 2) {
  $a[$i]
}

0
2
4
6
8

Você pode usar um loop while para exibir os elementos em uma matriz até que uma condição definida não seja mais verdadeira. Por exemplo, para exibir os elementos na $a matriz enquanto o índice de matriz é menor que 4, digite:

$a = 0..9
$i=0
while($i -lt 4) {
  $a[$i];
  $i++
}

0
1
2
3

Propriedades de matrizes

Contagem ou comprimento ou LongLength

Para determinar quantos itens estão em uma matriz, use a Length propriedade ou seu Count alias. Longlengthserá útil se a matriz contiver mais de 2.147.483.647 elementos.

$a = 0..9
$a.Count
$a.Length

10
10

Classificação

Retorna o número de dimensões na matriz. A maioria das matrizes no PowerShell tem apenas uma dimensão. Mesmo quando você acredita que está criando uma matriz multidimensional; semelhante ao exemplo a seguir:

$a = @(
  @(0,1),
  @("b", "c"),
  @(Get-Process)
)

[int]$r = $a.Rank
"`$a rank: $r"

$a rank: 1

Criar uma matriz verdadeiramente multidimensional, no PowerShell, requer a assistência do .NET Framework. Como no exemplo a seguir:

[int[,]]$rank2 = [int[,]]::new(5,5)
$rank2.rank

2

Métodos de matrizes

Liberada

Define todos os valores de elemento como o valor padrão do tipo de elemento da matriz. O método Clear () não redefine o tamanho da matriz.

No exemplo a seguir, $a há uma matriz de objetos.

$a = 1, 2, 3
$a.Clear()
$a | % { $null -eq $_ }

True
True
True

Neste exemplo, $intA é digitado explicitamente para conter inteiros.

[int[]] $intA = 1, 2, 3
$intA.Clear()
$intA

0
0
0

ForEach

Permite iterar em todos os elementos na matriz e executar uma determinada operação para cada elemento da matriz.

O método ForEach tem várias sobrecargas que executam operações diferentes.

ForEach(scriptblock expression)
ForEach(type convertToType)
ForEach(string propertyName)
ForEach(string propertyName, object[] newValue)
ForEach(string methodName)
ForEach(string methodName, object[] arguments)
ForEach(scriptblock expression, object[] arguments)

ForEach (expressão scriptblock)

ForEach (expressão scriptblock, argumentos Object [])

O exemplo a seguir mostra como usar o método ForEach. Nesse caso, a intenção é gerar o valor quadrado dos elementos na matriz.

Observe que esse método foi adicionado no PowerShell v4 e não está disponível nas versões abaixo disso. Para versões anteriores, use o método de pipeline para o cmdlet ForEach-Object

$a = @(0 .. 3)
$a.ForEach({ $_ * $_})

0
1
4
9

Assim como o -ArgumentList parâmetro de ForEach-Object , o arguments parâmetro permite a passagem de uma matriz de argumentos para um bloco de script configurado para aceitá-los.

ForEach (tipo convertTotype)

O ForEach método pode ser usado para converter rapidamente os elementos em um tipo diferente; o exemplo a seguir mostra como converter uma lista de datas de cadeia de caracteres para [DateTime] tipo.

@("1/1/2017", "2/1/2017", "3/1/2017").ForEach([datetime])

Sunday, January 1, 2017 12:00:00 AM
Wednesday, February 1, 2017 12:00:00 AM
Wednesday, March 1, 2017 12:00:00 AM

ForEach (cadeia de caracteres propertyName)

ForEach (String propertyName, Object [] newValue)

O ForEach método também pode ser usado para recuperar rapidamente ou definir valores de propriedade para cada item na coleção.

# Set all LastAccessTime properties of files to the current date.
(dir 'C:\Temp').ForEach('LastAccessTime', (Get-Date))
# View the newly set LastAccessTime of all items, and find Unique entries.
(dir 'C:\Temp').ForEach('LastAccessTime') | Get-Unique

Wednesday, June 20, 2018 9:21:57 AM

ForEach (cadeia de caracteres methodName)

ForEach (cadeia de caracteres methodName, argumentos Object [])

Por fim, os ForEach métodos podem ser usados para executar um método em cada item da coleção.

("one", "two", "three").ForEach("ToUpper")

ONE
TWO
THREE

Assim como o -ArgumentList parâmetro de ForEach-Object , o arguments parâmetro permite a passagem de uma matriz de argumentos para um bloco de script configurado para aceitá-los.

Where

Permite filtrar ou selecionar os elementos da matriz. O script deve ser avaliado como algo diferente de: zero (0), Cadeia de caracteres vazia $false ou $null para o elemento a ser mostrado após oWhere

Há uma definição para o Where método.

Where(scriptblock expression[, WhereOperatorSelectionMode mode
                            [, int numberToReturn]])

O Expression scriptblock is é necessário para a filtragem, o mode argumento opcional permite recursos de seleção adicionais e o numberToReturn argumento opcional permite limitar quantos itens são retornados do filtro.

O exemplo a seguir mostra como selecionar todos os números ímpares da matriz.

(0..9).Where{ $_ % 2 }

1
3
5
7
9

Os modos de seleção a seguir estão disponíveis.

Padrão

O Default modo filtra itens usando o Expression scriptblock.

Se um numberToReturn for fornecido, ele especificará o número máximo de itens a serem retornados.

# Get the zip files in the current users profile, sorted by LastAccessTime.
$Zips = dir $env:userprofile -Recurse '*.zip' | Sort-Object LastAccessTime
# Get the least accessed file over 100MB
$Zips.Where({$_.Length -gt 100MB}, 'Default', 1)

Último

$h = (Get-Date).AddHours(-1)
$logs = dir 'C:\' -Recurse '*.log' | Sort-Object CreationTime
# Find the last 5 log files created in the past hour.
$logs.Where({$_.CreationTime -gt $h}, 'Last', 5)

SkipUntil

O SkipUntil modo ignora todos os objetos em uma coleção até que um objeto passe o filtro de expressão de bloco de script. Em seguida, ele retorna todos os itens de coleta restantes sem testá-los. Apenas um item de passagem é testado

Isso significa que a coleção retornada conterá itens de passagem e não APROVADOs que não foram testados.

O número de itens retornados pode ser limitado passando um valor para o numberToReturn argumento.

$computers = "Server01", "Server02", "Server03", "localhost", "Server04"
# Find the first available online server.
$computers.Where({ Test-Connection $_ }, 'SkipUntil', 1)

localhost

Haja

O Until modo inverte o SkipUntil modo. Ele retorna todos os itens em uma coleção até que um item passe a expressão de bloco de script. Depois que um item passa a expressão scriptblock, o Where método interrompe o processamento de itens.

Isso significa que você receberá o primeiro conjunto de itens que não são aprovados do Where método. Depois que um item passa, o restante não será testado nem retornado.

O número de itens retornados pode ser limitado passando um valor para o numberToReturn argumento.

# Retrieve the first set of numbers less than or equal to 10.
(1..50).Where({$_ -gt 10}, 'Until')
# This would perform the same operation.
(1..50).Where({$_ -le 10})

1
2
3
4
5
6
7
8
9
10

Divisão

O Split modo divide ou agrupa itens de coleção em duas coleções separadas. Aqueles que passam a expressão scriptblock e os que não fazem.

Se um numberToReturn for especificado, a primeira coleção conterá os itens de passagem , não para exceder o valor especificado.

Os objetos restantes, até aqueles que passam o filtro de expressão, serão retornados na segunda coleção.

$running, $stopped = (Get-Service).Where({$_.Status -eq 'Running'}, 'Split')
$running

Status   Name               DisplayName
------   ----               -----------
Running  Appinfo            Application Information
Running  AudioEndpointBu... Windows Audio Endpoint Builder
Running  Audiosrv           Windows Audio
...

$stopped

Status   Name               DisplayName
------   ----               -----------
Stopped  AJRouter           AllJoyn Router Service
Stopped  ALG                Application Layer Gateway Service
Stopped  AppIDSvc           Application Identity
...

Obter os membros de uma matriz

Para obter as propriedades e os métodos de uma matriz, como a propriedade Length e o método SetValue, use o parâmetro InputObject do cmdlet Get-Member.

Quando você canaliza uma matriz para Get-Member o, o PowerShell envia os itens um de cada vez e Get-Member retorna o tipo de cada item na matriz (ignorando duplicatas).

Quando você usa o parâmetro -InputObject , Get-Member o retorna os membros da matriz.

Por exemplo, o comando a seguir obtém os membros da $a variável de matriz.

Get-Member -InputObject $a

Você também pode obter os membros de uma matriz digitando uma vírgula (,) antes do valor que é canalizado para o cmdlet Get-Member. A vírgula torna a matriz o segundo item em uma matriz de matrizes. O Windows PowerShell canaliza as matrizes uma de cada vez e Get-Member retorna os membros da matriz. Como os dois exemplos a seguir.

,$a | Get-Member

,(1,2,3) | Get-Member

Manipulando uma matriz

Você pode alterar os elementos em uma matriz, adicionar um elemento a uma matriz e combinar os valores de duas matrizes em uma terceira matriz.

Para alterar o valor de um elemento específico em uma matriz, especifique o nome da matriz e o índice do elemento que você deseja alterar e, em seguida, use o operador de atribuição (=) para especificar um novo valor para o elemento. Por exemplo, para alterar o valor do segundo item na $a matriz (posição de índice 1) para 10, digite:

$a[1] = 10

Você também pode usar o método SetValue de uma matriz para alterar um valor. O exemplo a seguir altera o segundo valor (posição de índice 1) da $a matriz para 500:

$a.SetValue(500,1)

Você pode usar o operador + = para adicionar um elemento a uma matriz. O exemplo a seguir mostra como adicionar um elemento à $a matriz.

$a = @(0..4)
$a += 5

Não é fácil excluir elementos de uma matriz, mas você pode criar uma nova matriz que contém apenas os elementos selecionados de uma matriz existente. Por exemplo, para criar a $t matriz com todos os elementos na $a matriz, exceto para o valor na posição do índice 2, digite:

$t = $a[0,1 + 3..($a.length - 1)]

Para combinar duas matrizes em uma única matriz, use o operador de adição (+). O exemplo a seguir cria duas matrizes, combina-as e, em seguida, exibe a matriz combinada resultante.

$x = 1,3
$y = 5,9
$z = $x + $y

Como resultado, a $z matriz contém 1, 3, 5 e 9.

Para excluir uma matriz, atribua um valor de $null à matriz. O comando a seguir exclui a matriz na $a variável.

$a = $null

Você também pode usar o Remove-Item cmdlet, mas atribuir um valor $null é mais rápido, especialmente para matrizes grandes.

Matrizes de zero ou uma

A partir do Windows PowerShell 3,0, uma coleção de zero ou um objeto tem a propriedade Count e length. Além disso, você pode indexar em uma matriz de um objeto. Esse recurso ajuda a evitar erros de script que ocorrem quando um comando que espera uma coleção tem menos de dois itens.

Os exemplos a seguir demonstram esse recurso.

Zero objetos

$a = $null
$a.Count
$a.Length

0
0

Um objeto

$a = 4
$a.Count
$a.Length
$a[0]
$a[-1]

1
1
4
4

Veja também

• about_Assignment_Operators
• about_Hash_Tables
• about_Operators
• about_For
• about_Foreach
• about_While