Condividi tramite

  • Articolo

Remove-CsBandwidthPolicyServiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Rimuove una configurazione del servizio criteri di larghezza di banda esistente.

Sintassi

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

Descrizione dettagliata

La funzionalità Controllo di ammissione di chiamata consente di determinare se autorizzare sessioni di comunicazioni in tempo reale, ad esempio chiamate audio o video, in base ai vincoli di larghezza di banda. Nell'ambito dell'implementazione di Controllo di ammissione di chiamata in Microsoft Lync Server 2010 vengono definiti le aree, i siti e le subnet di una rete insieme alle relazioni e ai collegamenti tra tali entità in modo da imporre vincoli di larghezza di banda. Il servizio criteri di larghezza di banda è il componente che esegue la funzionalità Controllo di ammissione di chiamata nella distribuzione di Lync Server 2010, consentendo di decidere se la larghezza di banda esistente è sufficiente per una chiamata da effettuare. Questo cmdlet rimuove la configurazione di un servizio criteri di larghezza di banda definito a livello di sito. È inoltre possibile utilizzare il cmdlet per rimuovere il servizio criteri di larghezza di banda globale, sebbene in questo caso il servizio globale non venga effettivamente rimosso ma vengono semplicemente reimpostati i valori predefiniti.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Remove-CsBandwidthPolicyServiceConfiguration 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-CsBandwidthPolicyServiceConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

Identità XDS

Identificatore univoco della configurazione che si desidera rimuovere. Questo identificatore includerà l'ambito (per la configurazione globale) o l'ambito e il nome (per una configurazione a livello del sito, ad esempio site:Redmond).

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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration. Accetta l'input da pipeline di oggetti configurazione del servizio criteri di larghezza di banda.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di rimuovere un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Esempio

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

Remove-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

In questo esempio viene rimossa la configurazione del servizio criteri di larghezza di banda definita per il sito di Redmond (-Identity site:Redmond).

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

Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.EnableLogging -eq $False} | Remove-CsBandwidthPolicyServiceConfiguration

Nell'esempio vengono rimosse tutte le configurazioni del servizio criteri di larghezza di banda in cui la registrazione è disabilitata. A tale scopo, nell'esempio viene effettuata innanzitutto una chiamata a Get-CsBandwidthPolicyServiceConfiguration che restituirà una raccolta di tutte le configurazioni del servizio criteri di larghezza di banda nella distribuzione di Lync Server 2010. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object, che circoscrive la raccolta alle configurazioni con proprietà EnableLogging uguale a (-eq) False ($False), ottenendo quindi una raccolta di configurazioni con la registrazione disabilitata. La raccolta viene quindi inviata tramite pipe a Remove-CsBandwidthPolicyServiceConfiguration, che rimuove tutti gli elementi presenti nella raccolta.