Compartilhar via

  • Artigo

Get-CsStaticRoutingConfiguration

 

Tópico modificado em: 2012-03-23

Retorna informações sobre as definições de configuração de rotas estáticas utilizadas na organização.

Sintaxe

Get-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsStaticRoutingConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Quando uma mensagem SIP é enviada para alguém, é possível que essa mensagem precise atravessar diversas sub-redes e redes antes que seja entregue; o caminho percorrido pela mensagem é geralmente denominado rota. No sistema de redes, há dois tipos de rotas: dinâmica e estática. Com o roteamento dinâmico, os servidores usam algoritmos para determinar o próximo local (o próximo salto) ao qual a mensagem deverá ser encaminhada. Com o roteamento estático, os caminhos das mensagens são predeterminados pelos administradores do sistema. Quando uma mensagem é recebida por um servidor, ele verifica o endereço da mensagem e a encaminha para o servidor do próximo salto que tiver sido pré-configurado por um administrador. Se forem configuradas corretamente, as rotas estáticas ajudam a garantir a entrega precisa e pontual das mensagens, com o mínimo de sobrecarga aos servidores. A desvantagem da rota estática é que as mensagens não são roteadas novamente de maneira dinâmica no caso de uma falha de rede.

Ao se instalar o Microsoft Lync Server 2010, é criada automaticamente uma coleção global de rotas estáticas. (a coleção é criada, mas não há rotas atribuídas a ela.) Além disso, o software permite criar outras coleções aplicadas ao escopo de serviço (essas novas coleções podem ser atribuídas apenas ao serviço Registrador). O cmdlet Get-CsStaticRoutingConfiguration fornece uma maneira de retornar as informações sobre todas as coleções de configurações de roteamento estático em uso na organização. Isto inclui a capacidade de retornar informações detalhadas sobre cada rota atribuída à coleção.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsStaticRoutingConfiguration localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do controle de acesso baseado em função (RBAC) que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando do prompt Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsStaticRoutingConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade de Xds

Identificador exclusivo da coleção de configurações de roteamento estático. Para retornar informações sobre a coleção global, utilize esta sintaxe: -Identity global. Para recuperar informações sobre uma coleção configurada no escopo de serviço, utilize uma sintaxe similar a esta: -Identity "service:Registrar:atl-cs-001.litwareinc.com". Observe que não é possível utilizar caracteres curinga ao se especificar uma identidade. Se precisar utilizar caracteres curinga, inclua o parâmetro Filter no seu lugar.

Se os parâmetros Identity ou Filter não forem incluídos, Get-CsStaticRoutingConfiguration retornará informações sobre todas as coleções de configurações de roteamento estático.

Filter

Opcional

Cadeia de caracteres

Permite utilizar caracteres curinga ao especificar a coleção (ou coleções) de configurações de roteamento estático a ser retornada. Por exemplo, esta sintaxe retorna todas as coleções de roteamento estático configuradas no escopo de serviço: -Filter "service:*".

Observe que não é possível utilizar os parâmetros Filter e Identity no mesmo comando.

LocalStore

Opcional

Parâmetro de opção

Recupera os dados da configuração de roteamento estático da réplica local do Repositório de Gerenciamento Central em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma. Get-CsStaticRoutingConfiguration não aceita a entrada em pipeline.

Tipos de Retorno

Get-CsStaticRoutingConfiguration retorna instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemplo

-------------------------- Exemplo 1 ------------------------

Get-CsStaticRoutingConfiguration

O comando exibido no Exemplo 1 retorna informações sobre todas as coleções de configurações de roteamento estático em uso na organização.

-------------------------- Exemplo 2 ------------------------

Get-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

No Exemplo 2, as informações sobre uma coleção de configurações de roteamento estático são retornadas: a coleção com a identidade "service:Registrar:atl-cs-001.litwareinc.com".

-------------------------- Exemplo 3 ------------------------

Get-CsStaticRoutingConfiguration -Filter "service:*"

O Exemplo 3 utiliza o parâmetro Filter para retornar informações sobre as coleções de configurações de roteamento estático atribuídas ao escopo de serviço. O valor de filtro "service:*" limita os dados retornados às coleções que tiverem uma identidade que iniciada pelo valor da cadeia de caracteres "service:".

-------------------------- Exemplo 4 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route

O comando anterior retorna informações de rota detalhadas para todas as coleções de configurações de roteamento estático em uso na organização. Para fazer isso, o comando chama primeiramente o Get-CsStaticRoutingConfiguration sem quaisquer parâmetros para retornar informações completas sobre cada coleção de roteamento estático. Estas informações são canalizadas para o cmdlet Select-Object, que utiliza o parâmetro ExpandProperty para "expandir" o valor da propriedade Route. Ao se expandir uma propriedade, todos os objetos e valores contidos nela serão exibidos na tela e terão fácil leitura.

-------------------------- Exemplo 5 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route | Where-Object {$_.MatchOnlyPhoneUri -eq $True}

O comando exibido no Exemplo 5 retorna informações sobre todos os roteamentos estáticos que estiverem configurados para coincidir apenas com os URIs de telefones. Para realizar essa tarefa, o comando chama primeiramente o Get-CsStaticRoutingConfiguration sem quaisquer parâmetros; isto retorna todos os conjuntos de configurações de roteamento estático e seus roteamentos associados. Este conjunto será canalizado para o cmdlet Select-Object, que utiliza o parâmetro ExpandProperty para "expandir" todos os objetos armazenados na propriedade Route. Esses objetos de roteamento serão canalizados para o cmdlet Where-Object, que selecionará apenas os roteamentos cuja propriedade MatchOnlyPhoneUri for igual a True.