New-CsTrunkConfiguration
Tópico modificado em: 2012-03-27
Cria uma nova configuração de tronco que descreve as definições de uma entidade de mesmo nível de tronco, como um gateway de rede telefônica pública comutada (PSTN), Central privada de comutação de (PBX) IP ou Controlador de borda de sessão (SBC) no provedor de serviços.
Sintaxe
New-CsTrunkConfiguration -Identity <XdsIdentity> [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Utilize esse cmdlet para criar uma nova configuração de tronco que se aplique a entidades de Gateway da PSTN. Cada configuração contém definições específicas de uma entidade de mesmo nível de tronco, como um gateway da PSTN, IP-PBX ou SBC no provedor de serviços. Essas definições configuram aspectos como a habilitação (ou não) do desvio de mídia nesse tronco, o envio (ou não) dos pacotes RTCP sob determinadas condições e a exigência de se efetuar (ou não) a criptografia SRTP (protocolo em tempo real seguro).
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet New-CsTrunkConfiguration localmente: RTCUniversalServerAdmins. Para retornar uma lista de todas as funções de controle de acesso baseado em função (RBAC) às quais este cmdlet tiver sido atribuído (inclusive qualquer função RBAC personalizada que tiver sido criada por você), execute o seguinte comando no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsTrunkConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Digite | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Um identificador exclusivo que inclui o escopo da configuração de troncos. As configurações de tronco podem ser criadas no escopo de site ou de serviço, no caso de um serviço de gateway da PSTN. (por padrão, já existe uma configuração global, que não pode ser removida ou recriada). Por exemplo, site:Redmond (no escopo de site) ou PstnGateway:Redmond.litwareinc.com (no escopo de serviço). |
ConcentratedTopology |
Opcional |
Booleano |
O valor desse parâmetro determina se há um ponto de terminação de mídia conhecido. (Um exemplo de ponto de terminação de mídia conhecido seria um Gateway da PSTN, no qual a terminação de mídia possui o mesmo IP que a terminação de sinalização). Defina esse valor como False, se o tronco não possuir um ponto de terminação de mídia conhecido. Padrão: True |
Description |
Opcional |
Cadeia de caracteres |
Uma cadeia de caracteres que descreve o propósito da configuração de tronco. |
EnableBypass |
Opcional |
Booleano |
O valor desse parâmetro determina se o desvio de mídia está habilitado nesse tronco. Defina este valor como True, para habilitar o desvio. Observe que, para que o desvio de mídia funcione corretamente, é necessário que determinadas capacidades sejam suportadas pelos gateways da PSTN, SBCs e PBXs, incluindo: - a capacidade de receber respostas bifurcadas a um Convite. - É necessário que os clientes do Microsoft Lync Server 2010 e o ponto de terminação de mídia sejam capazes de se comunicarem diretamente, sem precisar passar por um Servidor de Mediação. - a sub-rede do gateway deve ser definida como estando no mesmo site que a sub-rede do cliente ou, se estiver em um site diferente, os sites não devem ser separados por links WAN com largura de banda limitada. O desvio de mídia pode ser habilitado apenas sob as seguintes circunstâncias: - o parâmetro ConcentratedTopology está definido como True - o parâmetro EnableReferSupport está definido como False, e RTCPActiveCalls e RTCPCallsOnHold estão definidos como False, ou EnableReferSupport está definido como True Observe que se EnableBypass for True e EnableReferSupport for False, as chamadas de desvio que serão subsequentemente transferidas tornar-se-ão de não-desvio. Para que o desvio de mídia funcione em um determinado tronco, é necessário que ele esteja habilitado globalmente, assim como para o tronco em questão. Use o cmdlet New-CsNetworkMediaBypassConfiguration para habilitar o desvio de mídia globalmente. Padrão: False |
EnableMobileTrunkSupport |
Opcional |
Booleano |
Define se o provedor de serviços é uma operadora de telefonia celular. Padrão: False |
EnablePIDFLOSupport |
Opcional |
Booleano |
Define se o roteamento ou não de chamadas de emergência será efetuado com o objeto Local de formato de dados de informação de presença (PIDF-LO) no gateway definido. Defina esse parâmetro como True, se as chamadas de emergência tiverem de ser roteadas para um provedor de serviços de emergência certificado. (o local será transmitido com a chamada). Padrão: False |
EnableReferSupport |
Opcional |
Booleano |
Define se esse tronco apoia o recebimento de solicitações de Referência vindas do Servidor de Mediação. O desvio de mídia pode ser habilitado apenas sob as seguintes circunstâncias: - o parâmetro ConcentratedTopology está definido como True - o parâmetro EnableReferSupport está definido como False, e RTCPActiveCalls e RTCPCallsOnHold estão definidos como False, ou EnableReferSupport está definido como True Observe que se EnableBypass for True e EnableReferSupport for False, as chamadas de desvio que serão subsequentemente transferidas tornar-se-ão de não-desvio. Padrão: True |
EnableSessionTimer |
Opcional |
Booleano |
Especifica se o cronômetro da sessão estará habilitado. Os cronômetros de sessão são utilizados para determinar se uma determinada sessão ainda está ativa. Observe que, mesmo se esse parâmetro for definido como False, os cronômetros de sessão poderão ser aplicáveis, caso a conexão remota possua um cronômetro de sessão habilitado. Nesse caso, o Servidor de Mediação responderá a testes do cronômetro de sessão da entidade remota. Padrão: False |
EnableSignalBoost |
Opcional |
Booleano |
Quando esse parâmetro for definido como True, o gateway da PSTN, IP-PBX ou SBC no provedor de serviço aumentará o volume do áudio nos fluxos de voz que forem enviados aos clientes da Servidor de Mediação ou Microsoft Lync Server 2010. Se esse valor for definido como False, o áudio será aumentado no Servidor de Mediação (nas chamadas de não-desvio) ou em clientes Lync Server 2010 (nad chamadas de desvio). Padrão: False |
MaxEarlyDialogs |
Opcional |
Int64 |
O número máximo de respostas bifurcadas que um Gateway PSTN, IP-PBX ou SBC no provedor de serviços pode receber a um convite que ele enviou à Servidor de Mediação. Padrão: 20 |
OutboundTranslationRulesList |
Opcional |
PSListModifier |
Uma coleção de regras de conversão de números de telefone que se aplicam a chamadas gerenciadas pelo Roteamento de Saída (chamadas roteadas para destinos de PBX ou PSTN). Embora esta lista e essas regras possam ser criadas diretamente com este cmdlet, é recomendável se criar as regras de conversão de saída com o cmdlet New-CsOutboundTranslationRule, que criará a regra e a atribuirá à configuração de tronco com o escopo correspondente. |
RemovePlusFromUri |
Opcional |
Booleano |
A definição deste parâmetro como True fará o Servidor de Mediação remover os sinais de adição (+) dos Identificadores de recursos uniformes (URIs) antes de enviá-los ao provedor de serviços. Padrão: False |
RTCPActiveCalls |
Opcional |
Booleano |
Esse parâmetro determina se, nas chamadas ativas, os pacotes RTCP serão enviados do gateway da PSTN, IP-PBX ou SBC no provedor de serviços. Nesse contexto, uma chamada ativa é uma chamada na qual a mídia pode partir em pelo menos uma direção. Se RTCPActiveCalls for definido comoTrue, o cliente Servidor de Mediação ou Lync Server poderá terminar uma chamada, caso ela não receba pacotes RTCP por um período superior a 30 segundos. Observe que a desabilitação das verificações para mídia RTCP recebida em chamadas ativas nos elementos do Lync Server removerá uma salvaguarda importante para a detecção de pontos perdidos e só deve ser feita se houver necessidade. Padrão: True |
RTCPCallsOnHold |
Opcional |
Booleano |
Esse parâmetro determina se os pacotes RTCP de chamadas que foram colocadas em espera continuarão a ser enviados no tronco e nenhum pacote de mídia deverá passar nas duas direções. Se Música em espera estiver habilitado no cliente Lync Server ou no tronco, a chamada será considerada ativa e essa propriedade será ignorada. Nessas circunstâncias, utilize o cmdlet RTCPActiveCalls. Observe que a desabilitação das verificações para mídia RTCP recebida em chamadas ativas nos elementos do Lync Server removerá uma salvaguarda importante para a detecção de pontos perdidos e só deve ser feita se houver necessidade. Padrão: True |
SipResponseCodeTranslationRulesList |
Opcional |
PSListModifier |
Uma lista de regras de conversão do código de resposta de SIP que se aplicam aos códigos de resposta recebidos de um gateway da PSTN, IP-PBX ou SBC no provedor de serviços. Essas regras permitem que o administrador mapeie os códigos de resposta de SIP, com valores entre 400 e 699 e recebidos através de um tronco, com novos valores, mais consistentes com Lync Server. É possível criar essa lista e as regras correspondentes diretamente com esse cmdlet. No entanto, é recomendável criar as regras de conversão do código de resposta de SIP chamando-se o cmdlet New-CsSipResponseCodeTranslationRule. Esse cmdlet criará a regra e a atribuirá à configuração do tronco que apresentar o escopo correspondente. |
SRTPMode |
Opcional |
SRTPMode |
O valor desse parâmetro determina o nível do suporte a SRTP, para proteger o tráfego de mídia entre o Servidor de Mediação e o gateway da PSTN, IP-PBX ou SBC no provedor de serviços. Nos casos de desvio de mídia, este valor deve ser compatível com a definição EncryptionLevel da configuração de mídia. A configuração de mídia é definida utilizando-se os cmdlets New-CsMediaConfiguration e Set-CsMediaConfiguration). Valores válidos: - Required: Deve se utilizar a criptografia SRTP. - Optional: O SRTP será utilizado se o gateway lhe fornecer apoio. - NotSupported: Não há apoio à criptografia SRTP e, portanto, ela não será utilizada. Observação: SRTPMode é utilizado apenas se o gateway estiver configurado para usar a Segurança de camada de transporte (TLS). Se o gateway estiver configurado com o Protocolo de controle de transmissão (TCP) como transporte, SRTPMode será internamente definido como NotSupported. Padrão: Obrigatório |
Force |
Opcional |
SwitchParameter |
Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de se realizar as alterações. |
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 |
SwitchParameter |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
SwitchParameter |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Nenhuma.
Tipos de Retorno
Cria um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
Exemplo
-------------------------- Exemplo 1 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond
Esse exemplo cria uma nova configuração do tronco cuja Identidade for site:Redmond. As demais propriedades dessa nova configuração serão preenchidas com os valores padrão.
-------------------------- Exemplo 2 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
Esse exemplo cria uma nova configuração do tronco cuja Identidade for site:Redmond e habilita o desvio de mídia. O desvio de mídia é habilitado pela atribuição do valor $True ao parâmetro EnableBypass. As demais propriedades dessa nova configuração serão preenchidas com os valores padrão.
-------------------------- Exemplo 3 ------------------------
New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'
Esse exemplo cria uma nova configuração de tronco cuja Identidade for site:Redmond e, em seguida, atribui uma nova conversão de saída a esse tronco. A primeira linha do exemplo chama New-CsTrunkConfiguration, para criar a nova configuração do tronco com as definições padrão. A segunda linha chama o cmdlet New-CsOutboundTranslationRule. Observe o valor atribuído a Identidade: site:Redmond/OTR1. A primeira parte da Identidade (site:Redmond) define o escopo ao qual a regra é aplicada. Esse escopo corresponde à Identidade da nova configuração do tronco, indicando que essa regra será aplicada automaticamente a essa configuração. O escopo é seguido de uma barra invertida (/) e de uma cadeia de caracteres, que é simplesmente um nome exclusivo para essa regra (pode haver mais de uma regra por escopo). Depois disso, passamos os valores para os parâmetros Pattern e Translation, para definir essa regra.
Consulte Também
Outros Recursos
Remove-CsTrunkConfiguration
Set-CsTrunkConfiguration
Get-CsTrunkConfiguration
Test-CsTrunkConfiguration
New-CsOutboundTranslationRule