Condividi tramite


Remove-CsNetworkBandwidthPolicyProfile

 

Ultima modifica dell'argomento: 2012-03-26

Consente di rimuovere un profilo dei criteri di larghezza di banda.

Sintassi

Remove-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Come parte del controllo di ammissione di chiamata (CAC), viene utilizzato un criterio di larghezza di banda per definire le limitazioni alla larghezza di banda per alcune modalità. In Microsoft Lync Server 2010 possono essere assegnate limitazioni alla larghezza di banda solo alle modalità audio e video. Questo cmdlet rimuove un profilo contenitore di questi criteri.

IMPORTANTE: Se un profilo viene assegnato ad un sito (utilizzando il cmdlet New-CsNetworkSite o Set-CsNetworkSite), ad un criterio inter-sito (utilizzando il cmdlet New-CsNetworkInterSitePolicy o Set-CsNetworkInterSitePolicy) o ad un collegamento di rete tra regioni (utilizzando i cmdlet New-CsNetworkRegionLink o Set-CsNetworkRegionLink), non può essere rimosso. Si riceverà un messaggio di errore tentando di rimuovere il profilo utilizzando Remove-CsNetworkBandwidthPolicyProfile. È necessario prima rimuovere il profilo da tutti i siti, criteri inter-sito e collegamenti di rete tra regioni poi sarà possibile rimuovere il profilo.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Remove-CsNetworkBandwidthPolicyProfile può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Un valore di stringa che identifica in modo univoco il profilo dei criteri di larghezza di banda da rimuovere. Specificando una identità verrà rimosso un solo profilo.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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.NetworkConfiguration.BWPolicyProfileType. Accetta input tramite pipeline di oggetti profilo dei criteri di larghezza di banda della rete.

Tipi restituiti

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

Esempio

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

Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

In questo esempio viene rimosso il profilo dei criteri di larghezza di banda con identità LowBWProfile. Poiché l'identità deve essere univoca questo rimuoverà un solo profilo.

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

Get-CsNetworkSite | Where-Object {$_.BWPolicyProfileID -eq "LowBWProfile"} | Set-CsNetworkSite -BWPolicyProfileID $null
Remove-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile

L'Esempio 2 rimuove tutti i riferimenti al profilo dei criteri di larghezza di banda con identità LowBWProfile da tutti i siti ai quali era stato assegnato poi rimuove il profilo. La prima riga di questo esempio inizia utilizzando Get-CsNetworkSite per recuperare tutti i siti configurati per il controllo di ammissione chiamata (CAC). Questa raccolta viene inviata tramite pipe al cmdlet Where-Object, che seleziona solo quei siti in cui la proprietà BWPolicyProfileID è uguale a (-eq) LowBWProfile. Questa raccolta ridotta, contenente solo i siti in cui la proprietà BWPolicyProfileID è impostata sul valore LowBWProfile, viene inviata tramite pipe al cmdlet Set-CSNetworkSite, che modifica ciascun sito impostando la proprietà BWPolicyProfileID su Null ($null). Ciò che è appena stato fatto è trovare tutti i siti con BWPolicyProfileID uguale a LowBWProfile ed impostare tale valore su Null. A questo punto nessun sito utilizza più il profilo LowBWProfile. Ora si può utilizzare Remove-CsNetworkBandwidthPolicyProfile sul profilo LowBWProfile per rimuoverlo, sapendo che quel profilo non è più utilizzato da nessun sito.

Per accertarsi che il profilo non sia utilizzato in nessuna altra parte della configurazione di rete, ripetere gli stessi passi della Linea 1 per i criteri inter-sito e per i collegamenti delle regioni di rete.