Condividi tramite

  • Articolo

Get-CsBandwidthPolicyServiceConfiguration

 

Ultima modifica dell'argomento: 2012-03-23

Consente di recuperare una o più configurazioni del servizio dei criteri di larghezza di banda.

Sintassi

Get-CsBandwidthPolicyServiceConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

Get-CsBandwidthPolicyServiceConfiguration [-Filter <String>] [-LocalStore <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'implementazione di CAC in Microsoft Lync Server 2010, le regioni, i siti e le subnet sono definiti in una rete insieme alle relazioni e ai collegamenti tra queste entità in modo da stabilire i vincoli di larghezza di banda tra di essi. 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. Il cmdlet Get-CsBandwidthPolicyServiceConfiguration consente di ottenere le impostazioni per uno o più servizi dei criteri di larghezza di banda.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsBandwidthPolicyServiceConfiguration può essere utilizzato localmente dai membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsBandwidthPolicyServiceConfiguration"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsIdentity

L'identificatore univoco della configurazione che si desidera recuperare. Questo identificatore è costituito dall'ambito (per la configurazione globale) o dall'ambito e dal nome (per la configurazione a livello di sito come, ad esempio, site:Redmond).

Filter

Facoltativo

Stringa

Una stringa contenente uno o più caratteri jolly che verrà utilizzata per eseguire una ricerca tra le proprietà Identity di tutte le configurazioni del servizio dei criteri di larghezza di banda al fine di trovare tutte le configurazioni in cui Identity corrisponde al modello di caratteri jolly. Ad esempio, utilizzando per Filter il valore site:* si recupereranno tutte le configurazioni in cui i valori Identity iniziano con la stringa site: e terminano con una qualsiasi combinazione di caratteri.

LocalStore

Facoltativo

Parametro opzionale

Consente di recuperare la configurazione del servizio dei criteri di larghezza di banda dalla copia locale di archivio di gestione centrale invece che da archivio di gestione centrale.

Tipi di input

Nessuno.

Tipi restituiti

Consente di recuperare uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Settings.BandwidthPolicyServiceConfiguration.BandwidthPolicyServiceConfiguration.

Esempio

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

Get-CsBandwidthPolicyServiceConfiguration

L'Esempio 1 consente di recuperare tutte le configurazioni del servizio dei criteri di larghezza di banda definiti nell'implementazione di Microsoft Lync Server 2010.

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

Get-CsBandwidthPolicyServiceConfiguration -Identity site:Redmond

Questo esempio consente di recuperare la configurazione del servizio dei criteri di larghezza di banda definita per il sito Redmond (-Identity site:Redmond).

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

Get-CsBandwidthPolicyServiceConfiguration -Filter site:*

In questo esempio, viene utilizzato il parametro Filter per recuperare tutte le configurazioni del servizio dei criteri di larghezza di banda definite a livello di sito. Per fare ciò, si utilizza il valore site:* per il parametro Filter. In questo modo, nella proprietà Identity di tutte le configurazioni del servizio dei criteri di larghezza di banda si cercheranno i valori che iniziano con site: e sono seguiti da qualsiasi altro carattere. Dal momento che nelle configurazioni a livello di sito, il valori Identity iniziano con site: e sono seguiti dal nome del sito, questo filtro individuerà tutte le configurazioni per tutti i siti.

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

Get-CsBandwidthPolicyServiceConfiguration | Where-Object {$_.MaxLogFileSizeMb -gt 4}

L'Esempio 4 consente di recuperare tutte le configurazioni del servizio dei criteri di larghezza di banda che consentono ai file di registro di raggiungere una dimensione superiore a 4 MB. In questo esempio viene utilizzato il cmdlet Get-CsBandwidthPolicyServiceConfiguration. Come nell'Esempio 1, questo cmdlet consente di recuperare una raccolta di tutte le configurazioni definite nella distribuzione di Lync Server. Questa raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object esamina gli elementi della raccolta uno alla volta. Per ciascun elemento nella raccolta, il cmdlet Where-Object verifica se il valore della proprietà MaxLogFileSizeMb è maggiore di (-gt) 4. In caso affermativo, quell'elemento continua a far parte della raccolta ed è presente nell'output del comando. Se il valore di MaxLogFileSizeMb non è maggiore di 4, l'elemento viene ignorato e non verrà restituito.