Condividi tramite

  • Articolo

Set-CsNetworkBandwidthPolicyProfile

 

Ultima modifica dell'argomento: 2012-03-26

Modifica un profilo esistente dei criteri di larghezza di banda della rete.

Sintassi

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

Set-CsNetworkBandwidthPolicyProfile [-AudioBWLimit <String>] [-AudioBWSessionLimit <String>] [-BWPolicy <PSListModifier>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-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 modificare un profilo contenitore per questo tipo di criteri.

IMPORTANTE: se in un profilo sono presenti più criteri (ad esempio, un criterio audio e un criterio video), la modifica del profilo tramite l'utilizzo delle proprietà AudioBWLimit, AudioBWSessionLimit, VideoBWLimit o VideoBWSessionLimit rimuove tutti i criteri presenti nel profilo e li sostituisce con i nuovi valori. Se il profilo conteneva un criterio per la limitazione della modalità video e si imposta solo il parametro AudioBWLimit, il criterio video viene rimosso e viene creato un criterio audio.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Set-CsNetworkBandwidthPolicyProfile in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

Valore stringa che identifica in modo univoco il profilo dei criteri di larghezza di banda che si desidera modificare. Questo valore è identico alla proprietà BWPolicyProfileID del profilo e può essere modificato tramite la modifica del valore di questa proprietà. Ciò equivale a eseguire un'operazione di "Taglia e incolla": tutte le proprietà del profilo vengono mantenute e viene modificato solo il nome. Tuttavia, questo valore non può essere modificato, se il profilo è assegnato a un sito.

Instance

Facoltativo

BWPolicyProfileType

Riferimento a un oggetto profilo dei criteri di larghezza di banda (un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyProfileType) che contiene le impostazioni che si desidera utilizzare per modificare il profilo. Questo oggetto può essere recuperato chiamando il cmdlet Get-CsNetworkBandwidthPolicyProfile.

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, il valore predefinito di quest'ultimo sarà 0.

AudioBWSessionLimit

Facoltativo

Stringa

Larghezza di banda massima per sessione audio. Espressa in kbps. Il valore deve essere pari a 40 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 AudioBWLimit, ma non per AudioBWSessionLimit, il valore predefinito di quest'ultimo sarà 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 devono essere di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.BWPolicyType. Gli oggetti di questo tipo possono essere creati chiamando il cmdlet New-CsNetworkBWPolicy; è quindi possibile aggiungere il criterio risultante da questa operazione al profilo esistente, assegnando il nuovo profilo come valore a questo parametro.

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, il valore predefinito di quest'ultimo sarà 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 VideoBWSessionLimi, il valore predefinito di quest'ultimo sarà 700.

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.NetworkConfiguration.BWPolicyProfileType. Consente di accettare l'input da pipeline di oggetti profilo di larghezza di banda di rete.

Tipi restituiti

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

Esempio

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

Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -Description "Policy for links of less than 10MB"

Nell'esempio viene modificata la descrizione del profilo dei criteri di larghezza di banda con Identity LowBWProfile. A questo scopo viene chiamato il cmdlet Set-CsNetworkBandwidthPolicyProfile con i due parametri seguenti: Identity, in cui è specificato il nome del profilo da modificare; e Description, in cui è specificata la nuova descrizione del profilo.

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

Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -VideoBWLimit 2500 -VideoBWSessionLimit 300

Nell'esempio 2 vengono modificate le limitazioni complessive e per sessione delle trasmissioni video per il profilo dei criteri di larghezza di banda con Identity LowBWLimit. Una volta specificato il parametro Identity del profilo da modificare, viene utilizzato il parametro VideoBWLimit per impostare la limitazione video complessiva su 2500. Viene quindi utilizzato il parametro VideoBWSessionLimit per impostare la limitazione per sessione su 300. Questo comando consente di aggiungere un profilo o aggiornare un profilo video esistente per il profilo dei criteri di larghezza di banda LowBWLimit. I profili audio esistenti non subiranno modifiche.

-------------------------- Esempio 3 --------------------------

$bp = New-CsNetworkBWPolicy -BWLimit 5000 -BWSessionLimit 200 -BWPolicyModality video
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWLimit -BWPolicy $bp

In questo esempio viene creato un nuovo criterio di larghezza di banda, poi assegnato al profilo dei criteri di larghezza di banda con Identity LowBWLimit. La prima riga dell'esempio è una chiamata al cmdlet New-CsNetworkBWPolicy. Questo cmdlet crea un nuovo profilo, in questo caso un profilo video (-BWPolicyModality video), con una limitazione complessiva di 5000 kbps (-BWLimit 5000) e una limitazione per sessione di 200 kbps (-BWSessionLimit 200). Questo oggetto nuovo profilo viene archiviato nella variabile $bp. Nella riga successiva dell'esempio è riportata la chiamata a Set-CsNetworkBandwidthPolicyProfile per la modifica del profilo LowBWLimit (-Identity LowBWLimit). Viene utilizzato il parametro BWPolicy con un valore di $bp. Questo parametro sostituisce tutti i criteri esistenti del profilo con il criterio appena creato e archiviato nella variabile $bp.

-------------------------- Esempio 4 --------------------------

$a = Get-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile
$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
$a.BWPolicy.Add($ap)
Set-CsNetworkBandwidthPolicyProfile -Instance $a

Nell'esempio 4 un nuovo criterio di larghezza di banda audio viene aggiunto alla serie di criteri presenti nel profilo LowBWProfile. Nella riga 1 viene chiamato Get-CsNetworkBandwidthPolicyProfile per recuperare il profilo con Identity LowBWProfile. Tale profilo viene archiviato nella variabile $a. Nella riga successiva viene chiamato il cmdlet New-CsNetworkBWPolicy per creare un nuovo criterio di larghezza di banda. Si tratta di un criterio audio (-BWPolicyModality audio) con una limitazione complessiva di 2000 kbps (-BWLimit 2000) e una limitazione per sessione di 300 kbps (-BWSessionLimit 300). Questo nuovo criterio viene archiviato nella variabile $ap.

Nella riga 3 il nuovo criterio audio, archiviato in $ap, viene aggiunto al profilo recuperato nella riga 1 e archiviato nella variabile $a. Questa operazione viene eseguita chiamando il metodo Add della proprietà BWPolicy del profilo e passando un valore $ap. Ciò viene letto come "Aggiungi il nuovo criterio archiviato in $ap a BWPolicy del profilo LowBWProfile, archiviato in $a".

Infine, viene chiamato Set-CsNetworkBandwidthPolicyProfile per aggiornare il profilo LowBWProfile. Si utilizza il parametro Instance e si passa un valore $a, che contiene il profilo modificato.

-------------------------- Esempio 5 --------------------------

$ap = New-CsNetworkBWPolicy -BWLimit 2000 -BWSessionLimit 300 -BWPolicyModality audio
Set-CsNetworkBandwidthPolicyProfile -Identity LowBWProfile -BWPolicy @{add=$ap}

L'esempio 5 produce gli stessi effetti dell' esempio 4: consente di aggiungere un nuovo profilo audio all'elenco dei criteri esistente del profilo LowBWProfile. Questo metodo richiede un numero minore di righe, ma è possibile che non sia altrettanto chiaro. È stato aggiunto al solo scopo di dimostrare che è possibile eseguire la stessa operazione in modi differenti.

Nella riga 1 è stato creato un nuovo criterio di larghezza di banda audio, impostando una limitazione complessiva (2000) e una limitazione per sessione (300), quindi archiviando il nuovo oggetto nella variabile $ap. È stato quindi chiamato Set-CsNetworkBandwidthPolicyProfile per modificare il profilo con Identity LowBWProfile. Per modificare l'elenco dei criteri all'interno del profilo viene utilizzato il parametro BWPolicy. Si noti che il valore passato a questo parametro è: @{add=$ap}. In Windows PowerShell questo è un ulteriore modo per aggiungere un oggetto a un elenco. Il valore inizia con un segno @, seguito da un gruppo di parentesi graffe {}. All'interno delle parentesi graffe è necessario specificare l'azione che si desidera eseguire sull'elenco; in questo caso si desidera aggiungere un oggetto. È possibile anche rimuovere o sostituire gli oggetti esistenti. Viene inserita l'azione (add) con un segno di uguale, seguita dall'oggetto che si desidera aggiungere, in questo caso, il nuovo criterio archiviato nella variabile $ap.