Condividi tramite

  • Articolo

New-CsBandwidthPolicyServiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di creare una nuova configurazione del servizio dei criteri di larghezza di banda.

Sintassi

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

Descrizione dettagliata

Il servizio Controllo di ammissione di chiamata permette di stabilire se consentire la creazione di sessioni di comunicazioni in tempo reale, quali chiamate vocali o video, sulla base dei vincoli di larghezza di banda. Nell'ambito dell'implementazione Microsoft Lync Server 2010 del servizio Controllo di ammissione di chiamata, le aree, i siti e le subnet vengono definiti all'interno di una rete insieme alle relazioni e ai collegamenti tra queste entità in modo da inserire i vincoli di larghezza di banda tra di esse. Il servizio Criteri di larghezza di banda è il componente che esegue la funzionalità Controllo di ammissione di chiamata nella distribuzione di Lync Server 2010 e che permette di stabilire se la larghezza di banda disponibile è sufficiente per eseguire la chiamata. Questo cmdlet consente di configurare un nuovo servizio dei criteri di larghezza di banda a livello di sito.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet New-CsBandwidthPolicyServiceConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalServerAdmins. Per ottenere un elenco di tutti i ruoli RBAC (controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (inclusi eventuali ruoli RBAC personalizzati), utilizzare il seguente comando dal prompt di Windows PowerShell:

Get-CsAdminRole | Where-Object {$_.Cmdlets –match "New-CsBandwidthPolicyServiceConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsIdentity

Un identificatore univoco che contiene l'ambito e il nome della configurazione. Questa configurazione può essere creata solo nell'ambito del sito, pertanto l'identità sarà nel formato site:<nome sito>, dove <nome sito> è il nome del sito al quale è applicata la configurazione.

EnableLogging

Facoltativo

Booleano

Impostare questo parametro su True per creare i registri dei collegamenti e degli errori CAC relativi al servizio dei criteri di larghezza di banda.

Valore predefinito: False

LogCleanUpInterval

Facoltativo

Durata

Il periodo di tempo trascorso il quale i registri di stato dei collegamenti e degli errori CAC vengono rimossi.

Questo valore deve essere compreso tra 1 e 60 giorni. Il valore deve essere immesso nel formato gg.hh:mm:ss, dove g è il numero di giorni, h è il numero di ore, m è il numero di minuti e s è il numero di secondi.

Valore predefinito: 10 giorni (10.00:00:00)

MaxLogFileSizeMb

Facoltativo

UInt32

La dimensione massima consentita del file di registro. Il valore di questo parametro deve essere un numero positivo che specifica la dimensione del file in megabyte.

Valore predefinito: 3 (MB)

MaxTokenLifetime

Facoltativo

Durata

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

Questo valore deve essere compreso tra 1 e 24 ore. Il valore deve essere immesso nel formato gg.hh:mm:ss, dove g è il numero di giorni, h è il numero di ore, m è il numero di minuti e s è il numero di secondi.

Valore predefinito: 8 ore (08:00:00)

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate 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.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Esempio

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

New-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

Questo esempio consente di creare una nuova configurazione del servizio dei criteri di larghezza di banda per il sito Redmond (-Identity site:Redmond). Non sono specificati altri parametri, per cui vengono utilizzati i valori predefiniti per tutti i valori di configurazione.

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

New-CsBandwidthPolicyServiceConfiguration -Identity site:Dublin -EnableLogging $True -LogCleanupInterval 30.00:00:00

In questo esempio, viene di nuovo creata una nuova configurazione del servizio dei criteri di larghezza di banda per il sito Dublin (-Identity site:Dublin). Per questo sito, al posto dei valori predefiniti viene abilitata la registrazione e impostato il numero dei giorni, fino a 30, trascorsi i quali i registri vengono cancellati. Per ottenere questo risultato, il parametro EnableLogging viene impostato su True ($True) e parametro LogCleanupInterval viene impostato su 30.00:00:00. Il valore del parametro LogCleanupInterval è un oggetto TimeSpan (durata), espresso nel formato gg.hh:mm:ss, dove g è il numero di giorni, h è il numero di ore, m è il numero di minuti e s è il numero di secondi.