Condividi tramite

  • Articolo

Remove-CsTrunkConfiguration

 

Ultima modifica dell'argomento: 2012-03-26

Rimuove una configurazione trunk esistente che descrive le impostazioni di un'entità peer di trunking, ad esempio un gateway PSTN (Public Switched Telephone Network), un sistema IP-PBX (Public Branch Exchange) o un servizio SBC (Session Border Controller) nel provider di servizi.

Sintassi

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

Descrizione dettagliata

Utilizzare questo cmdlet per rimuovere una configurazione di trunking valida per le entità gateway PSTN. Ogni configurazione contiene impostazioni specifiche di un'entità peer di trunking, ad esempio un gateway PSTN, un sistema IP-PBX o un servizio SBC nel provider di servizi. Tali impostazioni consentono di configurare diversi aspetti, ad esempio se abilitare o meno il bypass degli elementi multimediali in questo trunk, se inviare o meno i pacchetti RTCP (Real-Time Control Protocol) in determinate condizioni e se richiedere o meno la crittografia SRTP (Secure Real-Time Protocol).

Se si chiama Remove-CsTrunkConfiguration nella configurazione globale, questa configurazione trunk non verrà rimossa. La configurazione viene invece "reimpostata" e tutte le impostazioni personalizzate vengono sostituite dai valori predefiniti.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsTrunkConfiguration i membri dei seguenti gruppi: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control) a cui è stato assegnato questo cmdlet, inclusi gli eventuali ruoli RBAC personalizzati creati dall'utente, dal prompt di Windows PowerShell eseguire il seguente comando:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsTrunkConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

L'identificatore univoco della configurazione trunk che si desidera rimuovere.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare le modifiche.

WhatIf

Facoltativo

Parametro opzionale

Descrive ciò che accadrebbe se si eseguisse il comando senza eseguirlo realmente.

Confirm

Facoltativo

Parametro opzionale

Viene visualizzata una richiesta di conferma prima di eseguire il comando.

Tipi di input

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration. Accetta l'input da pipeline di oggetti configurazione trunk.

Tipi restituiti

Questo cmdlet non restituisce un valore. Rimuove un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Esempio

-------------------------- Esempio 1 ------------------------

Remove-CsTrunkConfiguration -Identity site:Redmond

In questo esempio viene rimossa la configurazione trunk con Identity site:Redmond.

-------------------------- Esempio 2 ------------------------

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

Nell'esempio 2 vengono rimosse tutte le configurazioni trunk definite a livello di sito. Nella prima parte del comando viene chiamato il cmdlet Get-CsTrunkConfiguration, che utilizza il parametro Filter per recuperare tutte le configurazioni trunk con valore Identity che inizia con site:, ovvero tutte le configurazioni trunk definite a livello di sito. La raccolta di configurazioni viene quindi inviata tramite pipe al cmdlet Remove-CsTrunkConfiguration, che rimuove tutti gli oggetti della raccolta.