Condividi tramite

  • Articolo

Get-CsNetworkInterSitePolicy

 

Ultima modifica dell'argomento: 2012-03-23

Recupera uno o più criteri inter-sito della rete che definiscono le limitazioni della larghezza di banda tra i siti direttamente collegati in una configurazione di Controllo di ammissione di chiamata.

Sintassi

Get-CsNetworkInterSitePolicy [-Identity <XdsGlobalRelativeIdentity>] [-LocalStore <SwitchParameter>]

Get-CsNetworkInterSitePolicy [-Filter <String>] [-LocalStore <SwitchParameter>]

Descrizione dettagliata

Se due siti di rete condividono un collegamento diretto, è possibile definire dei limiti della larghezza di banda per le connessioni audio e video tra tali siti. Questo cmdlet recupera uno o più criteri di sito della rete che associano le impostazioni di limitazione della larghezza di banda ai siti connessi in modo diretto.

Utenti autorizzati a eseguire il cmdlet: per impostazione predefinita, sono autorizzati a eseguire localmente il cmdlet Get-CsNetworkInterSitePolicy i membri dei seguenti gruppi: RTCUniversalUserAdmins, 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 "Get-CsNetworkInterSitePolicy"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

L'identificatore univoco del criterio di sito della rete che si desidera recuperare. I criteri di sito vengono creati solo con ambito globale, pertanto questo identificatore non richiede di specificare un ambito. Contiene invece una stringa che rappresenta un nome univoco che identifica il criterio.

Filter

Facoltativo

Stringa

Stringa contenente caratteri jolly per eseguire la ricerca dei criteri con valori Identity corrispondenti alla stringa di caratteri jolly.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni relative ai criteri inter-sito della rete dalla replica locale dell'archivio di gestione centrale anziché dall'archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Recupera un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkSitePolicyType.

Esempio

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

Get-CsNetworkInterSitePolicy

Se si chiama Get-CsNetworkInterSitePolicy senza parametri, verranno recuperati tutti i criteri di sito della rete definiti tra due siti di rete collegati direttamente.

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

Get-CsNetworkInterSitePolicy -Identity Reno_Portland

Nell'esempio viene recuperato il criterio di sito con Identity Reno_Portland.

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

Get-CsNetworkInterSitePolicy -Filter *Reno*

Nell'esempio 3 vengono recuperati tutti i criteri di sito della rete che presentano la stringa Reno in qualunque posizione nel valore Identity. I caratteri jolly (*) presenti nel valore passato al parametro Filter indicano "qualsiasi carattere o serie di caratteri". In altri termini, la stringa *Reno* corrisponde ai valori Identity che iniziano con uno o più caratteri qualsiasi, seguiti dalla stringa Reno, a sua volta seguita da qualsiasi carattere o serie di caratteri.

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

Get-CsNetworkInterSitePolicy | Where-Object {$_.BWPolicyProfileID -eq $null}

Nell'esempio vengono recuperati tutti i criteri di sito della rete ai quali non è stato assegnato un profilo dei criteri di larghezza di banda. Il comando chiama innanzitutto Get-CsNetworkInterSitePolicy, che come illustrato nell'esempio 1 recupera una raccolta di tutti i criteri di sito della rete. La raccolta viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object circoscrive la raccolta solo ai criteri di sito ai quali non è stato assegnato un profilo di criteri di larghezza di banda. Questa operazione viene eseguita tramite un confronto al fine di verificare se la proprietà BWPolicyProfileID di ciascun criterio di sito sia uguale a (-eq) Null ($null).