Condividi tramite

  • Articolo

New-CsNetworkInterRegionRoute

 

Ultima modifica dell'argomento: 2012-03-27

Crea una nuova route che connette le regioni di rete con una configurazione di controllo ammissione di chiamata.

Sintassi

New-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

New-CsNetworkInterRegionRoute -InterNetworkRegionRouteID <String> -NetworkRegionID1 <String> -NetworkRegionID2 <String> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Descrizione dettagliata

Ogni regione all'interno di una configurazione Controllo di ammissione di chiamata deve poter accedere a ciascuna delle altre regioni. Se i collegamenti di regione impostano limitazioni della larghezza di banda per le connessioni tra le regioni e rappresentano i collegamenti fisici, una route determina il percorso collegato attraversato dalla connessione per passare da una regione all'altra. Questo cmdlet consente di creare tale associazione di route.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet New-CsNetworkInterRegionRoute in locale: RTCUniversalServerAdmins. Per restituire un elenco di tutti i ruoli RBAC (Role-Based Access Control, controllo dell'accesso basato sui ruoli) a cui è stato assegnato questo cmdlet (compresi eventuali ruoli RBAC personalizzati creati autonomamente), eseguire il cmdlet riportato di seguito dal prompt di Windows PowerShell:

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

Un identificatore univoco per la route della regione di rete appena creata. Le route delle regioni di rete vengono create solo nell'ambito globale, quindi questo identificatore non deve specificare un ambito. Contiene invece una stringa univoca che identifica la route.

InterNetworkRegionRouteID

Obbligatorio

Stringa

Questo valore è identico a Identity. Non è possibile specificare un valore sia per Identity sia per InterNetworkRegionRouteID; il valore immesso per l'uno verrà automaticamente utilizzato anche per l'altro.

NetworkRegionID1

Obbligatorio

Stringa

Identità (NetworkRegionID) di una delle due regioni connesse attraverso questa route. Il valore passato a questo parametro deve essere una regione diversa da quella del valore del parametro NetworkRegionID2. In altre parole, non è possibile instradare una regione verso se stessa. Inoltre, la combinazione di NetworkRegionID1 e NetworkRegionID2 deve essere univoca (ad esempio, non è possibile definire due route per la connessione di NorthAmerica ed EMEA).

NetworkRegionID2

Obbligatorio

Stringa

Identità (NetworkRegionID) di una delle due regioni connesse attraverso questa route. Il valore passato a questo parametro deve essere una regione diversa da quella del valore del parametro NetworkRegionID1. In altre parole, non è possibile instradare una regione verso se stessa. Inoltre, la combinazione di NetworkRegionID1 e NetworkRegionID2 deve essere univoca (ad esempio, non è possibile definire due route per la connessione di NorthAmerica ed EMEA).

NetworkRegionLinkIDs

Facoltativo

Stringa

Consente di specificare tutti i collegamenti per questa route come stringa di valori delimitati da virgole. I valori sono le identità (NetworkRegionLinkIDs) dei collegamenti di regione. Se si immettono valori sia per NetworkRegionLinkIDs sia per NetworkRegionLinks, NetworkRegionLinkIDs viene ignorato. Questo parametro offre un mezzo conveniente per specificare l'elenco di collegamenti senza dover costruire un oggetto elenco e passarlo al parametro NetworkRegionLinks.

NetworkRegionLinks

Facoltativo

PSListModifier

Un oggetto elenco contenente le identità (NetworkRegionLinkIDs) dei collegamenti di regione che si applicano a questa route. Per questo cmdlet, il parametro differisce dal parametro NetworkRegionLinkIDs solo nel formato utilizzato per immettere più collegamenti. Il parametro NetworkRegionLinkIDs è il metodo consigliato per definire l'elenco iniziale con questo cmdlet.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare 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

Creare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Esempio

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

New-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionID1 NorthAmerica -NetworkRegionID2 APAC -NetworkRegionLinkIDs "NA_EMEA,EMEA_APAC"

Con l'esempio 1 viene creata una nuova route della regione di rete tra la regione NorthAmerica e la regione APAC. Alla nuova route viene assegnata l'identità NA_APAC_Route, assegnata automaticamente come InterNetworkRegionRouteID. Le regioni collegate sono NorthAmerica, passato come valore al parametro NetworkRegionID1, e APAC, passato come valore al parametro NetworkRegionID2. In questo esempio si presume che non esista un collegamento di regione configurato per collegare direttamente NorthAmerica ad APAC. Esistono tuttavia collegamenti da NorthAmerica a EMEA (NA_EMEA) e da EMEA ad APAC (EMEA_APAC). Come valore del parametro NetworkRegionLinkIDs vengono utilizzati entrambi questi collegamenti, delimitati da una virgola. In questo modo le connessioni da NorthAmerica ad APAC saranno instradate attraverso EMEA, applicando le limitazioni della larghezza di banda per le connessioni audio e video associate a questi collegamenti.