Set-CsTrunkConfiguration
Tópico modificado em: 2012-03-25
Modifica uma configuração de tronco existente 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 (PBX) de IP ou Controlador de Borda de Sessão (SBC) no provedor de serviços.
Sintaxe
Set-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>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-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>] [-Instance <PSObject>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Use esse cmdlet para remover uma configuração de tronco que se aplique a essas entidades de Gateway PSTN. Cada configuração contém definições específicas de uma entidade de mesmo nível de tronco, como um gateway PSTN, IP-PBX ou SBC do 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 do protoco de controle de transporte em tempo real (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 Set-CsTrunkConfiguration localmente: 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 "Set-CsTrunkConfiguration"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
XdsIdentity |
Um identificador exclusivo que inclui o escopo da configuração de troncos. As configurações de troncos podem existir no escopo Global ou de Site, ou no escopo de Serviço, no caso de um serviço de Gateway PSTN. Por exemplo, site:Redmond (no escopo de site) ou PstnGateway:Redmond.litwareinc.com (no escopo de serviço). |
Instance |
Opcional |
TrunkConfiguration |
Permite passar uma referência a um objeto para o cmdlet, em vez de definir valores de parâmetros individuais. Este parâmetro requer um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration, que pode ser recuperado chamando-se o cmdlet Get-CsTrunkConfiguration. |
ConcentratedTopology |
Opcional |
Booleano |
O valor deste parâmetro determina se existe um ponto conhecido de encerramento da mídia. Um exemplo de ponto de terminação de mídia conhecido seria um Gateway PSTN, em que a terminação de mídia possui o mesmo IP que a terminação de sinalização. Defina este valor como False se o tronco não possuir um ponto conhecido de encerramento de mídia. Padrão: Verdadeiro |
Description |
Opcional |
Cadeia de caracteres |
Uma cadeia de caracteres que descreve o propósito da configuração de tronco. |
EnableBypass |
Opcional |
Booleano |
O valor deste parâmetro determina se o desvio de mídia está habilitado para este tronco. Defina este valor como True, para habilitar o desvio. Observe que, para que o desvio de mídia funcione corretamente, determinadas capacidades devem ser suportadas pelos gateways PSTN, SBCs e PBXs, inclusive: - a capacidade de receber respostas bifurcadas a um convite. - É necessário que os clientes do 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 localização da sub-rede do Gateway deve ser definida como sendo no mesmo site da sub-rede do cliente ou, se definida em um site diferente, os sites não devem estar separados por links WAN com largura de banda restrita. 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 as chamadas de emergência com Objeto de Local de Formato de Dados de Informação de Presença (PIDF-LO) serão roteadas ou não através do 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: Verdadeiro |
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 o cronômetro de sessão da conexão remota estiver 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 PSTN, IP-PBX ou SBC do 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 na Servidor de Mediação (nas chamadas de não-desvio) ou em clientes Lync Server 2010 (nas 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 tratadas pelo Roteamento de saída (chamadas roteadas para destinos de PBX ou PSTN). Embora esta lista e estas regras possam ser modificadas diretamente por deste cmdlet, recomendamos que as regras de conversão de saída sejam modificadas com o cmdlet Set-CsOutboundTranslationRule. Set-CsOutboundTranslationRule modificará a regra e isso se refletirá automaticamente na configuração do tronco. Para modificar a configuração do tronco pela adição de uma nova regra de conversão de saída, chame o cmdlet New-CsOutboundTranslationRule. A nova regra será adicionada à configuração do tronco que apresentar um escopo coincidente. |
RemovePlusFromUri |
Opcional |
Booleano |
A definição deste parâmetro como True fará a Servidor de Mediação remover os sinais de adição (+) iniciais dos 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 PSTN, IP-PBX ou SBC do provedor de serviços. Uma chamada ativa nesse contexto é uma chamada em que 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 pode 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 pares descartados e só deve ser feita se houver necessidade. Padrão: Verdadeiro |
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 de espera estiver habilitado no cliente Lync Server ou no tronco, a chamada será considerada ativa e essa propriedade será ignorada. Nessas circunstâncias, use o parâmetro 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 pares descartados 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 PSTN, IP-PBX ou SBC do provedor de serviços. Essas regras permitem que o administrador mapeie os códigos de resposta 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, recomendamos criar as regras de conversão do código de resposta SIP chamando 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 PSTN, IP-PBX ou SBC do 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 usando-se os cmdlets New-CsMediaConfiguration e Set-CsMediaConfiguration. Valores válidos: - Obrigatório: Deve se utilizar a criptografia SRTP. - Opcional: O SRTP será utilizado se o provedor de serviços lhe fornecer apoio. - NotSupported: Não há apoio à criptografia SRTP e, portanto, ela não será utilizada. Observação: SRTPMode é usado apenas se o gateway estiver configurado para usar a Segurança da 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. |
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
Objeto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration. Aceita entrada canalizada de objetos de configuração de tronco.
Tipos de Retorno
Esse cmdlet não retorna um valor; ele modifica um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
Exemplo
-------------------------- Exemplo 1 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
Este exemplo modifica uma configuração de tronco cuja Identidade for site:Redmond, para habilitar o desvio de mídia. O desvio de mídia é habilitado pela atribuição do valor $True ao parâmetro EnableBypass. As propriedades restantes desta configuração manterão os seus valores atuais.
-------------------------- Exemplo 2 ------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
Este exemplo modifica uma regra de conversão de saída definida para a configuração de tronco cuja Identidade for site:Redmond. Observe que, para fazer esta mudança, não se realiza uma chamada ao cmdlet Set-CsTrunkConfiguration. As mudanças feitas utilizando-se Set-CsOutboundTranslationRule serão automaticamente refletidas na configuração do tronco cuja identidade corresponder à parte do escopo da identidade da regra de conversão de saída.
-------------------------- Exemplo 3 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
O Exemplo 3 define SRTPMode como Opcional em todas as configurações de tronco definidas no escopo do site. A primeira parte do comando é uma chamada ao cmdlet Get-CsTrunkConfiguration, que usa o parâmetro Filter para recuperar todas as configurações do tronco com uma Identidade que começa com site:, ou seja, todas as configurações do tronco definidas no nível do site. Esta coleção de configurações será então canalizada para o cmdlet Set-CsTrunkConfiguration, que definirá a propriedade SRTPMode de cada um como sendo Opcional.
-------------------------- Exemplo 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
O exemplo 4 modifica uma configuração de tronco com a Identidade site:Redmond, para habilitar o suporte a PIDF-LO. Por padrão, o parâmetro EnablePIDFLOSupport é False. Neste exemplo, definimos o valor como True para habilitar o suporte ao local para chamadas de emergência. Você deve definir o EnablePIDFLOSupport como True para que as informações do local sejam enviadas para o tronco pelo aplicativo de roteamento de saída.