Matrizes

Aplica-se a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1, Exchange Server 2007

Tópico modificado em: 2006-08-17

Uma matriz fornece uma estrutura de dados que pode ser usada para armazenar uma coleção de elementos de dados do mesmo tipo. O Shell de Gerenciamento do Exchange oferece suporte a todos os tipos de elementos de dados.

Para obter informações detalhadas sobre como usar matrizes, execute o seguinte comando no Shell de Gerenciamento do Exchange:

Get-Help About_Array

Criando matrizes

Você pode criar e inicializar matrizes atribuindo vários valores a uma variável. Os valores que são armazenados na matriz são delimitados usando vírgula e são separados do nome da variável pelo operador de atribuição =. Por exemplo, suponha que você deseja criar uma matriz chamada $Example que contenha os sete valores inteiros a seguir: 22, 5, 10, 8, 12, 9, 80. Para criar a matriz, digite o seguinte comando:

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

Na matriz, o primeiro elemento de dados está na posição de índice 0, o segundo está na posição 1 e assim por diante.

Lendo matrizes

Você pode fazer referência a uma matriz por seu nome de variável, como $Example. Você pode fazer referência a um valor específico dentro da matriz usando o número de índice da posição na matriz em que o valor é armazenado. Por exemplo, para fazer referência ao primeiro elemento de dados na matriz $Example, digite o seguinte comando:

Write-Host $Example[0]

O Shell de Gerenciamento do Exchange retornará o valor 22 porque ele é armazenado no primeiro elemento de matriz.

Manipulando matrizes

Para alterar o valor de um único item em uma matriz, especifique o nome da matriz, o índice a ser modificado, o operador de atribuição = e o novo valor a ser usado no lugar do valor existente. Por exemplo, para alterar o valor do segundo item na matriz $Example, a posição de índice 1, para 10, digite o seguinte comando:

$Example[1] = 10

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

$Example.SetValue(500,1)

Você pode anexar um valor ao fim de uma matriz existente. Por exemplo, para adicionar um outro inteiro, como 200, à matriz $Example, digite o seguinte comando:

$Example += 200

Matrizes associativas

As matrizes associativas são iguais às matrizes normais. No entanto, elas permitem a atribuição de pares chave-valor a uma variável. Por exemplo, você pode desejar atribuir valores a chaves em uma matriz para ser chamada quando um comando estiver sendo processado. O seguinte exemplo cria uma matriz associativa:

$Example = @{blue = 1; red = 2,3}

Quando digita $Example na linha de comando, você vê a seguinte saída:

Key                            Value
---                            -----
red                            {2, 3}
blue                           1

Você pode recuperar as informações que estão armazenadas na matriz chamando a matriz da seguinte maneira:

$Example.blue 

O exemplo anterior retorna um valor 1.

Como vários valores foram atribuídos à chave red, esses valores compõem uma matriz aninhada. Você pode fazer referência aos valores nessa matriz aninhada usando os respectivos valores de índice. Você pode recuperar as informações que são armazenadas na matriz aninhada de chave chamando a matriz associativa, $Example, com a chave red e o índice do local da matriz aninhada que você pode desejar recuperar 1, da seguinte maneira:

$Example.red[1]

O exemplo anterior retorna o valor 3.

Para obter mais informações sobre matrizes associativas, execute o seguinte comando no Shell de Gerenciamento do Exchange:

Get-Help About_Associative_Array