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.
Vedere anche
Ulteriori risorse
New-CsBandwidthPolicyServiceConfiguration
Remove-CsBandwidthPolicyServiceConfiguration
Get-CsBandwidthPolicyServiceConfiguration