New-CsStaticRoute
Tópico modificado em: 2012-03-26
Cria uma nova rota de telefone estática.
Sintaxe
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]
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, existem 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.
Novas rotas estáticas são criadas usando-se o cmdlet New-CsStaticRoute. Depois de criar uma rota usando New-CsStaticRoute, você deve adicioná-la a uma coleção de definições de configuração de roteamento usando o cmdlet Set-CsStaticRoutingConfiguration.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet New-CsStaticRoute 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-CsStaticRoute"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Destination |
Obrigatório |
Cadeia de caracteres |
Se a rota usar TLS como o protocolo de transporte, o Destino será o FQDN (nome de domínio totalmente qualificado) do servidor de próximo salto. Por exemplo: -Destination "atl-proxy-001.litwareinc.com". Se a rota usar TCP como o protocolo de transporte, o Destino será o endereço IP do roteador de próximo salto. Por exemplo: -Destination "192.168.0.240". |
MatchUri |
Obrigatório |
Cadeia de caracteres |
FQDN ou sufixo do domínio usado para determinar se a mensagem está sendo enviada a um usuário tratado por essa rota. Por exemplo, você pode usar o FQDN "litwareinc.com". Esse padrão corresponde a qualquer usuário com um endereço SIP que termine com o nome de domínio "litwareinc.com". Para que haja correspondência com domínios filhos de um domínio, é possível usar um valor curinga como "*.litwareinc.com". O valor corresponde a qualquer domínio que termine com o sufixo "litwareinc.com". Por exemplo: northamerica.litwareinc.com; asia.litwareinc.com; e europe.litwareinc.com. |
Enabled |
Opcional |
Booleano |
Se definido como True, a rota estará habilitada, e todas as mensagens correspondentes ao padrão MatchURI serão roteadas para o servidor de próximo salto. Se definido como False, a rota estará desabilitada e não será usada no roteamento de mensagens. O valor padrão é True. |
MatchOnlyPhoneUri |
Opcional |
Booleano |
Se definido como True, apenas mensagens endereçadas a URIs de telefone (por exemplo, sip:kenmmyer@litwareinc.com;user=phone) serão correspondidas e potencialmente roteadas. Se definido como False (o valor padrão), haverá correspondência para todas as mensagens. |
Port |
Obrigatório |
Inteiro |
Número de porta usado para o roteamento SIP. Por exemplo: -Port 7742. |
ReplaceHostInRequestUri |
Opcional |
Booleano |
Se definido como True ($True), a parte de host de um Request-URI será substituída pelo endereço do servidor de próximo salto. Se definido como False, Request-URI será usado como está. Request-URI representa o URI do usuário ou serviço a quem a solicitação (mensagem) se destina. O valor padrão é False. |
TCPRoute |
Opcional |
Parâmetros de opção |
Configura o protocolo TCP como o protocolo de transporte para a nova rota. |
TLSCertIssuer |
Opcional |
Cadeia de caracteres |
Nome da CA (autoridade de certificação) que emitiu o certificado a ser usado na rota estática. Esse parâmetro não será usado se você tiver configurado o TCP como o protocolo de transporte. Se incluir o parâmetro TLSCertIssuer, você também deverá usar o parâmetro TLSCertSerialNumber. |
TLSCertSerialNumber |
Opcional |
Matriz de bytes |
Número de série do certificado TLS a ser usado na rota estática. Os números de série devem ser passados como uma matriz de bytes; isso significa que você deve passar o número de série como uma matriz de valores com dois caracteres. Por exemplo: -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89. Esse parâmetro não será usado se você tiver configurado o TCP como o protocolo de transporte. Se incluir o parâmetro TLSCertSerialNumber, você também deverá usar o parâmetro TLSCertIssuer. |
TLSRoute |
Opcional |
Parâmetros de opção |
Configura o protocolo TLS como o protocolo de transporte para a nova rota. |
UseDefaultCertificate |
Opcional |
Booleano |
Configura a rota para usar seu certificado padrão do Lync Server 2010 como seu certificado de autenticação. Se não quiser usar o certificado padrão, você deverá especificar um certificado diferente usando os parâmetros TLSCertIssuer e TLSCertSerialNumber. Para exibir o certificado padrão, use o seguinte comando: Get-CsCertificate | Where-Object {$_.Use –eq "urn:certref:Default"} |
Tipos de Entrada
Nenhuma. New-CsStaticRoute não aceita entrada em pipeline.
Tipos de Retorno
New-CsStaticRoute cria novas instâncias do objeto Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route.
Exemplo
-------------------------- Exemplo 1 ------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
Os comandos mostrados no Exemplo 1 criam uma nova rota estática e adicionam essa rota à coleção de configurações de roteamento estático globais. Para realizar essa tarefa, o primeiro comando usa New-CsStaticRoute para criar uma rota apenas na memória que usa TCP como seu protocolo de transporte. A rota aponta para o endereço IP de próximo salto 192.168.0.100, usa a porta 8025 e corresponde a qualquer URI do domínio litwareinc.com. O objeto de rota resultante é armazenado em uma variável chamada $x.
Em seguida, o segundo comando do exemplo adiciona a nova rota à coleção de configurações de roteamento estático globais. Isso é feito chamando-se Set-CsStaticRoutingConfiguration com o parâmetro Route. O valor do parâmetro @{Add=$x} adiciona o objeto de rota armazenado em $x ao conjunto existente de rotas já presentes na coleção global.
-------------------------- Exemplo 2 ------------------------
$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
O Exemplo 2 mostra como criar uma nova rota estática que use TLS como protocolo de transporte e, em seguida, adiciona essa rota à coleção de configurações de roteamento estático globais. Para isso, o primeiro comando do exemplo usa New-CsStaticRoute para criar uma rota apenas na memória que use TLS como seu protocolo de transporte. A rota aponta para "atl-proxy-001.litwareinc.com" como destino, usa a porta 8025 e corresponde a qualquer URI que use o sufixo de domínio "litwareinc.com". Além disso, o novo objeto de rota, armazenado na variável chamada $x, usa o certificado padrão para fins de autenticação (-UseDefaultCertificate $True).
Depois que o objeto de rota é criado, o segundo comando do exemplo adiciona a nova rota à coleção de configurações de roteamento estático globais.