Condividi tramite

  • Articolo

Set-CsBandwidthPolicyServiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-27

Modifica una configurazione del servizio dei criteri di larghezza di banda esistente.

Sintassi

Set-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Set-CsBandwidthPolicyServiceConfiguration [-Confirm [<SwitchParameter>]] [-EnableLogging <$true | $false>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-LogCleanUpInterval <TimeSpan>] [-MaxLogFileSizeMb <UInt32>] [-MaxTokenLifetime <TimeSpan>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

La funzionalità Controllo di ammissione di chiamata consente di determinare se consentire sessioni di comunicazioni in tempo reale, ad esempio chiamate audio o video, in base ai vincoli di larghezza di banda. Nell'ambito dell'implementazione Microsoft Lync Server 2010 di Controllo di ammissione di chiamata le aree, i siti e le subnet vengono definiti in una rete insieme alle relazioni e ai collegamenti tra tali entità in modo da definire vincoli di larghezza di banda. Il servizio dei 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 modifica una configurazione del servizio dei criteri di larghezza di banda esistente.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

Identità XDS

L'identificatore univoco della configurazione che si desidera cambiare. 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).

Instance

Facoltativo

BandwidthPolicyServiceConfiguration

Il riferimento a un oggetto di configurazione del servizio dei criteri di larghezza di banda. L'oggetto deve essere di tipo BandwidthPolicyServiceConfiguration, che può essere recuperato chiamando il cmdlet Get-CsBandwidthPolicyServiceConfiguration.

EnableLogging

Facoltativo

Booleano

Impostare questo parametro su True per generare registri di stato dell'errore e del collegamento CAC relativi al servizio dei criteri di larghezza di banda.

LogCleanUpInterval

Facoltativo

TimeSpan

Il periodo di tempo dopo il quale i registri di stato dell'errore e del collegamento CAC saranno rimossi.

Il valore deve essere compreso nell'intervallo da 1 giorno a 60 giorni. Il valore deve essere immesso nel formato gg.hh:mm:ss, in cui "g" è il giorno, "h" sono le ore, "m" i minuti e "s" i secondi. Ad esempio, il valore per 20 giorni è 20.00:00:00.

MaxLogFileSizeMb

Facoltativo

UInt32

La dimensione massima consentita per il file di registro. Il valore di questo parametro deve essere un numero positivo che specifica la dimensione del file in megabyte. Ad esempio, per consentire al file di registro di raggiungere una dimensione massima di 10 megabyte, immettere il valore 10.

MaxTokenLifetime

Facoltativo

TimeSpan

Il tempo massimo di esistenza del token emesso dal servizio di autenticazione dei criteri della larghezza di banda.

Il valore deve essere compreso nell'intervallo da 1 ora a 24 ore. Il valore deve essere immesso nel formato gg.hh:mm:ss, in cui "g" è il giorno, "h" sono le ore, "m" i minuti e "s" i secondi. Ad esempio, il valore per 12 ore è 12:00:00.

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 dei criteri di larghezza di banda.

Tipi restituiti

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

Esempio

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

Set-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond -EnableLogging $true -MaxTokenLifetime 3:00:00 -LogCleanUpInterval 5.00:00:00

L'esempio mostra la modifica della configurazione del servizio dei criteri di larghezza di banda per il sito Redmond (-Identity site:Redmond). La configurazione viene modificata per abilitare la registrazione e per cambiare la durata massima di un token a tre ore e il numero di giorni prima della pulizia del registro a cinque giorni. Tutte queste operazioni vengono eseguite con un solo comando. Per attivare la registrazione, il parametro EnableLogging è impostato su True ($true). Il parametro MaxTokenLifetime riceve successivamente un valore corrispondente a 3:00:00, che rappresenta tre ore. Il parametro LogCleanUpInterval riceve infine un valore 5.00:00:00, che indica cinque giorni.