Condividi tramite

  • Articolo

New-CsNetworkBandwidthPolicyProfile

 

Ultima modifica dell'argomento: 2012-03-24

Crea un nuovo profilo dei criteri di larghezza di banda della rete. Questo cmdlet può essere inoltre utilizzato per impostare i criteri di larghezza di banda all'interno di un profilo.

Sintassi

New-CsNetworkBandwidthPolicyProfile -Identity <XdsGlobalRelativeIdentity> [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-VideoBWLimit <String>] [-VideoBWSessionLimit <String>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

In Controllo di ammissione di chiamata (CAC), i criteri di larghezza di banda vengono utilizzati per definire le limitazioni della larghezza di banda per alcune modalità. In Microsoft Lync Server 2010 è possibile assegnare limitazioni della larghezza di banda solo alle modalità audio e video. Questo cmdlet consente di creare un profilo contenitore per questo tipo di criteri. Definire i singoli criteri nel contenitore specificando le limitazioni delle larghezze di banda audio e video quando si chiama il cmdlet.

I profili dei criteri di larghezza di banda vengono applicati ai siti della rete chiamando i cmdlet New-CsNetworkSite o Set-CsNetworkSite.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Un valore stringa che identifica in modo univoco il criterio. Tutte i profili dei criteri di larghezza di banda creati con ambito globale. L'ambito è pertanto univoco ed è necessario specificare solo un nome univoco, quando si crea un nuovo profilo dei criteri di larghezza di banda. Si noti che questo valore viene inserito anche nella proprietà BWPolicyProfileID del profilo.

AudioBWLimit

Facoltativo

Stringa

Larghezza di banda massima per tutte le connessioni audio. Se una singola sessione audio supera la limitazione della larghezza di banda audio, tale sessione non viene avviata.

Espressa in kbps. Ad esempio, un valore pari a 1000 equivale a 1000 kbps.

Se si fornisce un valore per questo parametro, non sarà possibile specificare un valore per il parametro BWPolicy.

Valore predefinito: se si specifica un valore per il parametro AudioBWSessionLimit, ma non per AudioBWLimit, per impostazione predefinita per AudioBWLimit verrà utilizzato il valore 0.

AudioBWSessionLimit

Facoltativo

Stringa

Larghezza di banda massima per sessione audio. Espressa in kbps. Il valore deve essere uguale o maggiore di 40.

Se si fornisce un valore per questo parametro, non sarà possibile specificare un valore per il parametro BWPolicy.

Valore predefinito: se si specifica un valore per il parametro AudioBWLimit, ma non per AudioBWSessionLimit, per impostazione predefinita per AudioBWSessionLimit verrà utilizzato il valore 175.

BWPolicy

Facoltativo

PSListModifier

Un elenco di oggetti contenente i profili dei criteri di larghezza di banda. Ciascun oggetto dell'elenco è composto di una modalità di larghezza di banda, audio o video, una limitazione della larghezza di banda complessiva e una limitazione per sessione della larghezza di banda.

Se si fornisce un valore per questo parametro, non sarà possibile specificare un valore per il parametro AudioBWLimit, AudioBWSessionLimit, VideoBWLimit o VideoBWSessionLimit.

Gli oggetti nell'elenco possono essere creati chiamando il cmdlet New-CsNetworkBWPolicy.

Description

Facoltativo

Stringa

Descrizione del profilo dei criteri di larghezza di banda. Ad esempio, è possibile utilizzare questo parametro per indicare l'utilizzo previsto del profilo.

VideoBWLimit

Facoltativo

Stringa

Larghezza di banda massima per tutte le connessioni video. Se una singola sessione video supera la limitazione della larghezza di banda video, tale sessione non viene avviata.

Espressa in kbps. Ad esempio, un valore pari a 1000 equivale a 1000 kbps.

Se si fornisce un valore per questo parametro, non sarà possibile specificare un valore per il parametro BWPolicy.

Valore predefinito: se si specifica un valore per il parametro VideoBWSessionLimit, ma non per VideoBWLimit, per impostazione predefinita per VideoBWLimit verrà utilizzato il valore 0.

VideoBWSessionLimit

Facoltativo

Stringa

Larghezza di banda massima per sessione video. Espressa in kbps. Il valore deve essere pari a 100 o superiore.

Se si fornisce un valore per questo parametro, non sarà possibile specificare un valore per il parametro BWPolicy.

Valore predefinito: se si specifica un valore per il parametro VideoBWLimit, ma non per VideoBWSessionLimit, per impostazione predefinita per VideoBWSessionLimit verrà utilizzato il valore 700.

Force

Facoltativo

Parametro opzionale

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

InMemory

Facoltativo

Parametro opzionale

Crea un riferimento a un oggetto senza eseguire realmente il commit dell'oggetto come modifica permanente. Se si assegna l'output del cmdlet chiamato con questo parametro a una variabile, è possibile apportare modifiche alle proprietà del riferimento all'oggetto e quindi eseguire il commit di queste modifiche chiamando il cmdlet Set- corrispondente.

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

Nessuno.

Tipi restituiti

Consente di creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType.

Esempio

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

New-CsNetworkBandwidthPolicyProfile -Identity LowBWLimits -AudioBWLimit 2000 -AudioBWSessionLimit 200 -VideoBWLimit 1400 -VideoBWSessionLimit 500

Nell'esempio 1 viene creato un nuovo profilo dei criteri di larghezza di banda denominato LowBWLimits. A questo nuovo profilo verranno assegnati due criteri, un criterio audio e un criterio video (gli unici due criteri consentiti in Lync Server 2010). Il criterio audio viene aggiunto al profilo utilizzando il parametro AudioBWLimit per assegnare in questo caso una limitazione di 2000 kbps alle connessioni audio complessive e il parametro AudioBWSessionLimit per assegnare una limitazione di 200 kbps per le singole sessioni audio. La stessa operazione viene eseguita per creare le limitazioni delle sessioni video, utilizzando, però, i parametri VideoBWLimit e VideoBWSessionLimit.