Condividi tramite

  • Articolo

Set-CsNetworkInterRegionRoute

 

Ultima modifica dell'argomento: 2012-03-27

Consente di modificare una route esistente che connette regioni della rete all'interno di una configurazione Controllo di ammissione di chiamata (CAC).

Sintassi

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

Set-CsNetworkInterRegionRoute [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NetworkRegionID1 <String>] [-NetworkRegionID2 <String>] [-NetworkRegionLinkIDs <String>] [-NetworkRegionLinks <PSListModifier>] [-WhatIf [<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 consente di modificare l'associazione di route.

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

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Facoltativo

XdsGlobalRelativeIdentity

L'identificatore univoco della route tra regioni della rete che si desidera modificare. 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.

Instance

Facoltativo

InterNetworkRegionRouteType

Un riferimento oggetto ad una route della regione esistente. Questo oggetto deve essere di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType e può essere recuperato utilizzando il cmdlet Get-CsNetworkInterRegionRoute.

NetworkRegionID1

Facoltativo

Stringa

L'identità di una delle due regioni connesse mediante questa route. Il valore specificato per questo parametro deve essere una regione diversa dal valore specificato per il parametro NetworkRegionID2. In altre parole, non è possibile eseguire il routing di una regione a se stessa. Inoltre, la combinazione di NetworkRegionID1 e NetworkRegionID2 deve essere univoca (ad esempio, non è possibile avere due route definite che connettono NorthAmerica e EMEA.

NetworkRegionID2

Facoltativo

Stringa

L'identità di una delle due regioni connesse mediante questa route. Il valore specificato per questo parametro deve essere una regione diversa dal valore specificato per il parametro NetworkRegionID1. In altre parole, non è possibile eseguire il routing di una regione a se stessa. Inoltre, la combinazione di NetworkRegionID1 e NetworkRegionID2 deve essere univoca (ad esempio, non è possibile avere due route definite che connettono NorthAmerica e 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à dei collegamenti della regione. Se si immettono dei valori sia per NetworkRegionLinkIDs che per NetworRegionLinks, NetworkRegionLinkIDs verrà ignorato. I collegamenti modificati utilizzando questo parametro sostituiranno tutti i collegamenti esistenti nella route.

NetworkRegionLinks

Facoltativo

Modificatore dell'elenco PS

Un oggetto contenente le identità (NetworkRegionLinkIDs) dei collegamenti della regione che vengono applicati a questa route. Per questo cmdlet, questo parametro si differenzia da NetworkRegionLinkIDs in quanto non permette solo di sostituire tutti i collegamenti esistenti nella route, ma consente anche di aggiungere o rimuovere questi singoli collegamenti.

Force

Facoltativo

Parametro opzionale

Consente di evitare la visualizzazione delle richieste di conferma che altrimenti verrebbero visualizzate prima che vengano apportate le modifiche.

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

Oggetto Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType. Consente di accettare l'input tramite pipeline di oggetti route tra aree di rete.

Tipi restituiti

Questo cmdlet non restituisce un valore. Consente di modificare un oggetto di tipo Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Esempio

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinkIDs "NA_SA,SA_APAC"

In questo esempio viene modificata la route NA_APAC_Route cambiando i collegamenti della regione della route che verranno attraversati. Il parametro NetworkRegionLinkIDs viene utilizzato con il valore "NA_SA,SA_APAC" che sostituisce qualsiasi collegamento esistente con i due collegamenti specificati nella stringa.

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

Set-CsNetworkInterRegionRoute -Identity NA_APAC_Route -NetworkRegionLinks @{add="SA_EMEA"}

Come nell'Esempio 1, nell'Esempio 2 vengono modificati i collegamenti nella route NA_APAC_Route. Tuttavia, in questo esempio, invece di sostituire tutti i collegamenti della route utilizzando il parametro NetworkRegionLinkIDs, viene utilizzato il parametro NetworkRegionLinks per aggiungere un collegamento all'elenco dei collegamenti esistenti nella route. In questo caso, viene aggiunto alla route il collegamento SA_EMEA. La sintassi @{add=<collegamento>} consente di aggiungere un elemento all'elenco dei collegamenti. È possibile utilizzare anche la sintassi @{replace=<collegamento>} per sostituire tutti i collegamenti esistenti con quelli specificati da <collegamento> (che si comporta allo stesso modo di NetworkRegionLinkIDs) o la sintassi @{remove=<collegamento>} per rimuovere un collegamento dall'elenco.

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

Set-CsNetworkInterRegionRoute -Identity NA_Route5 -NetworkRegionID2 SouthAmerica -NetworkRegionLinkIDs "NA_SA,SA_APAC"

Nell'Esempio 3 viene modificata la route denominata NA_Route5. In questo esempio viene modificata una delle regioni di questa route. Il parametro NetworkRegionID2 viene utilizzato per specificare la nuova regione, quindi il parametro NetworkRegionLinkIDs consente di creare un nuovo elenco di collegamenti in grado di connettere tra loro le regioni della route.