Condividi tramite

  • Articolo

Remove-CsNetworkInterRegionRoute

 

Ultima modifica dell'argomento: 2012-03-25

Rimuove una route che connette le regioni della rete all'interno di una configurazione Controllo di ammissione di chiamata.

Sintassi

Remove-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-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 rimuovere una di queste associazioni di route.

Utenti che possono eseguire questo cmdlet: per impostazione predefinita, i membri dei gruppi riportati di seguito sono autorizzati ad eseguire il cmdlet Remove-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 "Remove-CsNetworkInterRegionRoute"}

Parametri

Parametro Obbligatorio Tipo Descrizione

Identity

Obbligatorio

XdsGlobalRelativeIdentity

L'identificatore univoco per la route della regione di rete che si desidera rimuovere. 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.

Force

Facoltativo

Parametro opzionale

Elimina qualsiasi richiesta di conferma che, in caso contrario, sarebbe visualizzata prima di effettuare 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 da pipeline di oggetti route interregionali di rete.

Tipi restituiti

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

Esempio

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

Remove-CsNetworkInterRegionRoute -Identity NA_APAC_Route

Nell'esempio 1 viene rimossa la route con identità NA_APAC_Route.

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

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

Nell’Esempio 2 vengono rimosse tutte le route delle regioni che includono la regione NorthAmerica. La prima parte di questo comando è una chiamata al cmdlet Get-CsNetworkInterRegionRoute. Tale cmdlet, chiamato senza parametri, recupera tutte le route di tutte le regioni. Questa raccolta di route viene quindi inviata tramite pipe al cmdlet Where-Object. Il cmdlet Where-Object circoscrive la raccolta alle route all'interno delle quali è definita la regione NorthAmerica. A questo scopo il cmdlet controlla se nella route è presente un valore NetworkRegionID1 oppure (-or) un valore NetworkRegionID2 uguale a (-eq) NorthAmerica. Se la raccolta contiene unicamente route che includono la regione NorthAmerica, questa viene inviata tramite pipe a Remove-CsNetworkInterRegionRoute, che rimuove tutte le route.