Compartilhar via

  • Artigo

New-CsStaticRoutingConfiguration

 

Tópico modificado em: 2012-03-26

Cria uma nova coleção de configurações de roteamento estático.

Sintaxe

New-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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é-determinados 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. Além disso, o cmdlet New-CsStaticRoutingConfiguration pode ser usado para criar coleções adicionais e o escopo de site ou o escopo de serviço (apenas para o serviço Registrador).

Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-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 "New-CsStaticRoutingConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Obrigatório

Xds Identity

Identificador único para a nova coleção de roteamento estático a ser criada. Só é possível criar novas coleções em escopo de serviço, e elas só podem ser atribuídas ao serviço Registrar. Por isso, a Identity de uma nova coleção precisa ser semelhante a: -Identity "service:Registrar:atl-cs-001.litwareinc.com"

Route

Opcional

PSList Modifier

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 obter detalhes, consulte a seção de Exemplos deste tópico.

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.

InMemory

Opcional

SwitchParameter

Cria uma referência de objeto, sem na verdade executar o objeto como uma alteração permanente. Se a saída deste cmdlet for atribuída, chamando-o com este parâmetro a uma variável, você poderá realizar alterações às propriedades da referência do objeto e executar estas alterações, chamando-se o cmdlet coincidente Set- deste cmdlet.

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

Nenhuma. New-CsStaticRoutingConfiguration não aceita entrada em pipeline.

Tipos de Retorno

New-CsStaticRoutingConfiguration cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemplo

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

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

O comando anterior cria uma nova coleção de configurações de roteamento estático com Identidade service:Registrar:atl-cs-001.litwareinc.com. Como o parâmetro Route não está incluído no comando, a nova coleção não terá nenhuma rota estática atribuída a ela.

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

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x

Os comandos mostrados no Exemplo 2 criam um novo roteador proxy SIP que usa o TCP como transporte; essa nova rota é adicionada a uma nova coleção de configurações de roteamento estático. Para fazer isso, o primeiro comando do exemplo usa o cmdlet New-CsStaticRoute para criar uma nova rota que aponte para o servidor do próximo salto com o endereço IP 192.168.1.100. Essa nova rota (armazenada em uma variável chamada $x) também usa a porta 8025 e MatchUri "*.litwareinc.com".

Depois disso, New-CsStaticRoutingConfiguration é chamado para criar uma nova coleção (com Identidade service:Registrar:atl-cs-001.litwareinc.com), atribuindo a rota armazenada na variável $x à propriedade Route da nova coleção.