Condividi tramite

  • Articolo

Get-CsNetworkInterRegionRoute

 

Ultima modifica dell'argomento: 2012-03-23

Recupera una o più route che connettono aree di rete all'interno di una configurazione del servizio Controllo di ammissione di chiamata (CAC).

Sintassi

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

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

Descrizione dettagliata

Ciascuna regione entro una configurazione CAC deve avere la possibilità di accedere a tutte le altre regioni. Mentre i collegamenti tra regioni impostano delle limitazione alla larghezza di banda nelle connessioni e rappresentano anche un collegamento fisico, una route stabilisce attraverso quale percorso collegato passerà la connessione da una regione all'altra. Questo cmdlet recupera le informazioni relative a queste associazioni di route.

Utenti autorizzati a utilizzare questo cmdlet: per impostazione predefinita, il cmdlet Get-CsNetworkInterRegionRoute 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-CsNetworkInterRegionRoute"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

L'identificatore univoco della route tra regioni della rete che si desidera recuperare. Le route tra regioni della rete vengono create solo nell'ambito globale, per cui in questo identificatore non è necessario specificare un ambito. L'identificatore contiene invece una stringa che costituisce il nome univoco di quella specifica route.

Filter

Facoltativo

Stringa

Una stringa che consente di recuperare route basandosi sulla corrispondenza tra i valori di identità e la stringa jolly fornita come valore per questo parametro.

LocalStore

Facoltativo

Parametro opzionale

Recupera le informazioni relative alla route tra aree di rete dalla replica locale dell'archivio di gestione centrale anziché dall' archivio di gestione centrale stesso.

Tipi di input

Nessuno.

Tipi restituiti

Questo cmdlet restituisce uno o più oggetti di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Esempio

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

Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route

L'Esempio 1 recupera la route con Identity NA_APAC_Route.

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

Get-CsNetworkInterRegionRoute -Filter *APAC*

Nell'Esempio 2 viene usato il parametro Filter per recuperare tutte le route che contengono la stringa APAC all'interno della Identity.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionLinks -eq "NA_EMEA"}

Questo esempio recupera tutte le route di regione che utilizzano il collegamento di rete tra regioni NA_EMEA. Il comando utilizza prima il cmdlet Get-CsNetworkInterRegionRoute. Utilizzando questo cmdlet senza parametri si recuperano tutte le route definite con la configurazione CAC. Questa raccolta di route viene quindi inviata tramite pipe al cmdlet Where-Object. Where-Object esamina la raccolta e seleziona tutti gli oggetti che hanno il valore NA_EMEA all'interno del loro elenco NetworkRegionLinks.

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

Get-CsNetworkInterRegionRoute | Where-Object {$_.NetworkRegionID1 -eq "NorthAmerica" -or $_.NetworkRegionID2 -eq "NorthAmerica"}

L'Esempio 4 recupera tutte le route che includono la regione NorthAmerica. La prima parte del comando è costituita dall'utilizzo del cmdlet Get-CsNetworkInterRegionRoute. Questo cmdlet, utilizzato senza parametri aggiuntivi, recupererà tutte le route tra regioni. Poi questa raccolta di route viene inviata tramite pipe al cmdlet Where-Object. Il cmdlet Where-Object limita la raccolta includendo solo quelle route per le quali NorthAmerica è definito come una delle regioni nella route. Questo risultato si ottiene controllando se il valore NetworkRegionID1 è uguale a (-eq) NorthAmerica, o (-or) se il valore NetworkRegionID2 è uguale a NorthAmerica.