Compartilhar via

  • Artigo

Set-CsStaticRoutingConfiguration

 

Tópico modificado em: 2012-03-26

Modifica uma coleção existente de configurações de roteamento estático.

Sintaxe

Set-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsStaticRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Quando você envia uma mensagem de protocolo SIP para alguém, ela precisa percorrer várias sub-redes e redes antes de ser entregue; o caminho percorrido pela mensagem costuma ser conhecido como rota. Em redes, há dois tipos de rotas: dinâmicas e estáticas. No roteamento dinâmico, os servidores usam algoritmos para determinar o próximo local (ou próximo salto) onde uma mensagem deve ser encaminhada. No roteamento estático, os caminhos de mensagens são pré-determinado pelos administradores do sistema. Quando uma mensagem é recebida por um servidor, esse servidor verifica o endereço da mensagem e a encaminha para o servidor do próximo salto que foi pré-configurado por um administrador. Se configuradas corretamente, as rotas estáticas ajudam a garantir entregas precisas e no horário certo das mensagens, com uma sobrecarga mínima imposta aos servidores. O lado negativo das rotas estáticas é que as mensagens não são reencaminhadas dinamicamente se houver uma falha na rede.

Ao instalar o Microsoft Lync Server 2010, uma coleção global de rotas estáticas é criada automaticamente. (a coleção é criada, mas não há rotas atribuídas a essa coleção). Além disso, o software permite a criação de coleções adicionais aplicadas ao escopo de serviço (essas novas coleções só podem ser atribuídas ao serviço Registrador). O cmdlet Set-CsStaticRoutingConfiguration permite modificar os valores de propriedades de uma coleção de rotas estáticas existentes. Isso significa que o cmdlet pode ser usado para adicionar novas rotas a uma coleção, ou para excluir rotas existentes de uma coleção.

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Set-CsStaticRoutingConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:

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

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

Identidade Xds

Identificador único da coleção de configurações de roteamento estático a ser modificada. Para modificar a coleção global, use esta sintaxe: -Identity global. Para modificar uma coleção aplicada em escopo de serviço, use uma sintaxe semelhante a esta: -Identity "service:Registrar:atl-cs-001.litwareinc.com" Curingas não podem ser usados para especificar a identidade.

Se este parâmetro não for incluído, Set-CsStaticRoutingConfiguration irá modificar automaticamente a coleção global.

Instance

Opcional

Objeto RoutingSettings

Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais.

Route

Opcional

Modificador de lista PS

Rotas estáticas individuais mantidas na coleção. As rotas a serem adicionadas a uma coleção precisam ser copiadas de outra coleção ou criadas com o cmdlet New-CsStaticRoute; para excluir uma rota de uma coleção, é preciso criar primeiro uma referência de objeto para essa rota. Para detalhes, consulte a seção de Exemplos do tópico de ajuda.

Force

Opcional

Parâmetros de opção

Suprime a exibição de mensagens de erro não fatais que possam ocorrer na execução do comando.

WhatIf

Opcional

Parâmetros de opção

Descreve o que aconteceria se o comando fosse executado sem ser executado de fato.

Confirm

Opcional

Parâmetros de opção

Solicita confirmação antes da execução do comando.

Tipos de Entrada

Objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings. Set-CsStaticRoutingConfiguration aceita instâncias em pipeline do objeto de configurações de roteamento estático.

Tipos de Retorno

Set-CsStaticRoutingConfiguration não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemplo

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

$x = Get-CsStaticRoutingConfiguration -Identity global | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Add=$x}

Os comandos mostrados no Exemplo 1 copiam uma rota da coleção de roteamento estático global e atribuem essa rota a uma segunda coleção de roteamento estático, que possua a Identidade service:Registrar:atl-cs-001.litwareinc.com. Para realizar essa tarefa, o primeiro comando do exemplo conecta à coleção global e retorna uma referência de objeto à rota com MatchUri litwareinc.com e MatchOnlyPhoneUri igual a True.

Para fazer isso, o comando chama Get-CsStaticRoutingConfiguration para retornar informações da coleção de configurações estáticas de roteamento global. Esses dados são canalizados para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para expandir os valores da propriedade Route. Esses valores expandidos (que representam as rotas individuais atribuídas à coleção) são canalizados para o cmdlet Where-Object, que seleciona apenas a rota na qual a propriedade MatchUri seja igual a litwareinc.com e MatchOnlyPhoneUri igual a True. A rota retornada é armazenada em uma variável chamada $x.

Depois que a rota é recuperada, o segundo comando do exemplo adiciona essa rota ao serviço: Coleção Registrar:atl-cs-001.litwareinc.com. Para isso, Set-CsStaticRoutingConfiguration é chamado com o parâmetro Route; o valor de parâmetro @{Add=$x} diz a Set-CsStaticRoutingConfiguration para anexar a rota armazenada na variável $x à coleção de rotas mantidas na propriedade Route.

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

$x = Get-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Remove=$x}

O comando anterior exclui uma rota de uma coleção de roteamento estático. Para fazer isso, o primeiro comando do exemplo conecta à coleção com Identidade service:Registrar:atl-cs-001.litwareinc.com e retorna uma referência de objeto à rota com MatchUri litwareinc.com e MatchOnlyPhoneUri igual a True. Para fazer isso, o comando chama Get-CsStaticRoutingConfiguration para retornar informações da coleção service:Registrar:atl-cs-001.litwareinc.com. Esses dados são canalizados para o cmdlet Select-Object, que usa o parâmetro ExpandProperty para expandir os valores da propriedade Route. Esses valores expandidos (que representam as rotas individuais atribuídas à coleção) são canalizados para o cmdlet Where-Object, que seleciona apenas a rota na qual a propriedade MatchUri seja igual a litwareinc.com e MatchOnlyPhoneUri igual a True. A rota retornada é então armazenada em uma variável chamada $x.

Depois que a rota é recuperada, o segundo comando exclui essa rota da coleção. Para isso, Set-CsStaticRoutingConfiguration é chamado com o parâmetro Route; o valor de parâmetro @{Remove=$x} diz a Set-CsStaticRoutingConfiguration para excluir a rota armazenada na variável $x.

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

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route $Null

O Exemplo 3 mostra como remover todas as rotas atribuídas a uma coleção de configurações de roteamento estático. Para isso, basta incluir o parâmetro Route e definir o valor do parâmetro como nulo. Depois que o comando é concluído, a coleção continuará existindo, mas não terá mais nenhuma rota atribuída a ela.