Compartilhar via

  • Artigo

Remove-CsTrunkConfiguration

 

Tópico modificado em: 2012-03-26

Remove uma ou mais configurações de tronco existentes 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

Remove-CsTrunkConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrição Detalhada

Use esse cmdlet para remover uma configuração de tronco que se aplique a essas 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 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 protocolo 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).

Observe que, se você chamar Remove-CsTrunkConfiguration na configuração Global, essa configuração de tronco não será removida. Em vez disso, a configuração será "redefinida" e todas as definições personalizadas serão substituídas por valores padrão.

Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Remove-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 "Remove-CsTrunkConfiguration"}

Parâmetros

Parâmetro Obrigatório Digite Descrição

Identity

Obrigatório

XdsIdentity

O identificador único da configuração do tronco que deseja remover.

Force

Opcional

SwitchParameter

Suprime qualquer aviso de confirmação que, de outra maneira, seria exibido antes de realizar 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 troncos.

Tipos de Retorno

Este cmdlet não retorna um valor. Ele remove um objeto do tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Exemplo

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

Remove-CsTrunkConfiguration -Identity site:Redmond

Esse exemplo remove a configuração do tronco com a Identidade site:Redmond.

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

Get-CsTrunkConfiguration -Filter site:* | Remove-CsTrunkConfiguration

O Exemplo 2 remove todas as configurações do tronco definidas no nível 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 de tronco com uma Identidade que comece com site: (ou seja, todas as configurações do tronco definidas no nível do site). Essa coleção de configurações será então canalizada para o cmdlet Remove-CsTrunkConfiguration, que removerá cada objeto na coleção.