Compartilhar via

  • Artigo

Get-CsTrunkConfiguration

 

Tópico modificado em: 2012-03-23

Recupera uma ou mais configurações de tronco, que descrevem 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

Get-CsTrunkConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsTrunkConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrição Detalhada

Utilize esse cmdlet para recuperar uma ou mais configurações de tronco aplicáveis às 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 Get-CsTrunkConfiguration localmente: RTCUniversalUserAdmins, 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 "Get-CsTrunkConfiguration"}

Parâmetros

Parâmetro Obrigatório Tipo Descrição

Identity

Opcional

XdsIdentity

O identificador exclusivo da configuração do tronco que se deseja recuperar. As configurações de troncos podem ser definidas 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).

Filter

Opcional

Cadeia de caracteres

Este parâmetro aceita uma cadeia de caracteres curinga e retorna todas as configurações de tronco cuja identidade corresponder à cadeia de caracteres. Por exemplo, o valor de Filtro site:* retornará todas as configurações de tronco definidas no nível de site.

LocalStore

Opcional

SwitchParameter

Recupera a configuração de tronco na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si.

Tipos de Entrada

Nenhuma.

Tipos de Retorno

Este cmdlet retorna um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Exemplo

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

Get-CsTrunkConfiguration

Este exemplo recupera todas as configurações de tronco da implantação do Microsoft Lync Server 2010.

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

Get-CsTrunkConfiguration -Identity site:Redmond

Esse exemplo recupera a configuração do tronco cuja Identidade for site:Redmond. Como essas identidades são exclusivas, este comando retornará, no máximo, um objeto.

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

Get-CsTrunkConfiguration -Filter site:*

O Exemplo 3 recupera todas as configurações de tronco definidas no nível do site. O cmdlet Get-CsTrunkConfiguration utiliza o parâmetro Filter para recuperar todas as configurações de tronco cuja identidade começar com site:, ou seja, todas as configurações de tronco definidas no nível de site.