Condividi tramite

  • Articolo

New-CsNetworkBWPolicy

 

Ultima modifica dell'argomento: 2012-03-25

Crea criteri di larghezza di banda nella memoria che è possibile applicare al profilo dei criteri di larghezza di banda. In Microsoft Lync Server 2010, i criteri si applicano alla larghezza di banda audio o video.

Sintassi

New-CsNetworkBWPolicy -BWLimit <UInt32> -BWPolicyModality <Audio | Video> -BWSessionLimit <UInt32>

Descrizione dettagliata

Questo cmdlet consente di creare nuovi criteri di larghezza di banda. Si utilizzano criteri di larghezza di banda per definire i limiti della larghezza di banda relativi ad alcune modalità. In Lync Server 2010 è possibile assegnare limitazioni della larghezza di banda solo alle modalità audio e video. Il criterio di larghezza di banda viene creato solo nella memoria, quindi l'output deve essere assegnato a una variabile e quindi passato come valore al parametro BWPolicy del cmdlet New-CsNetworkBandwidthPolicyProfile o Set-CsNetworkBandwidthPolicyProfile. I criteri di larghezza di banda sono applicati ai profili dei criteri che sono in grado di memorizzare più criteri per un profilo singolo e che fanno parte della configurazione di rete globale per il servizio Controllo di ammissione di chiamata (CAC).

Il metodo consigliato per assegnare criteri audio e video consiste nell'assegnarli direttamente a un profilo di criteri di larghezza di banda chiamando il cmdlet New-CsNetworkBandwidthPolicyProfile o Set-CsNetworkBandwidthPolicyProfile e specificando i valori per i parametri AudioBWLimit, AudioBWSessionLimit, VideoBWLimit e VideoBWSessionLimit.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

BWLimit

Obbligatorio

UInt32

La larghezza di banda massima consentita, in kbps, per tutte le sessioni simultanee del tipo specificato nel parametro BWPolicyModality.

BWPolicyModality

Obbligatorio

BWPolicyModality

Determina che tipo di larghezza di banda è limitata.

Valori validi: Audio, Video

BWSessionLimit

Obbligatorio

UInt32

La larghezza di banda massima consentita, in kbps, per una sessione singola del tipo specificato nel parametro BWPolicyModality.

Tipi di input

Nessuno.

Tipi restituiti

Crea un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType.

Esempio

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

$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video

In questo esempio, si creano nuovi criteri di larghezza di banda e li si assegna alla variabile $bwp. Tutti i parametri del cmdlet New-CsNetworkBWPolicy sono obbligatori. Nell'esempio è stato specificato un limite totale di larghezza di banda (BWLimit) di 2000 kbps e un limite di sessione della larghezza di banda (BWSessionLimit) di 300 kbps: questi limiti sono stati poi applicati alle sessioni video (-BWPolicyModality video).

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

$bwp = New-CsNetworkBWPolicy -BWLimit 200 -BWSessionLimit 3000 -BWPolicyModality video
New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bwp

L'esempio 2 approfondisce l'esempio 1 assegnando i nuovi criteri di larghezza di banda a un profilo dei criteri. Il comando alla riga 1 è identico all'esempio 1: crea limiti della larghezza di banda video. Nella riga 2 viene quindi chiamato New-CsNetworkBandwidthPolicyProfile per aggiungere il criterio a un nuovo profilo. Il nuovo profilo riceve l'identità LowBWLimit. Viene utilizzato quindi il parametro BWPolicy assegnandogli il valore $bwp, che corrisponde alla variabile contenente il nuovo criterio di larghezza di banda appena creato alla riga 1.