Partager via

  • Article

Get-CsNetworkInterRegionRoute

 

Dernière rubrique modifiée : 2012-03-23

Récupère un ou plusieurs itinéraires qui connectent des zones réseau au sein d’une configuration de contrôle d’admission des appels.

Syntaxe

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

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

Description détaillée

Chaque zone d’une configuration de contrôle d’admission des appels doit pouvoir accéder à toutes les autres zones. Alors que les liens de région définissent des restrictions de bande passante sur les connexions entre les régions et qu’ils représentent des liens physiques, un itinéraire détermine le chemin lié que la connexion traverse d’une région à une autre. Cette cmdlet récupère des informations sur ces associations d’itinéraires.

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsNetworkInterRegionRoute : RTCUniversalUserAdmins, RTCUniversalServerAdmins. Pour retourner une liste de tous les rôles RBAC (Contrôle d’accès basé sur un rôle) auxquels cette cmdlet a été affectée (y compris les rôles RBAC personnalisés créés par vos soins), exécutez la commande suivante à l’invite Windows PowerShell :

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

Identificateur unique de l’itinéraire de zone réseau à récupérer. Les itinéraires de zones réseau ne peuvent être créés qu’au niveau de l’étendue globale. Cet identificateur n’a donc pas besoin de spécifier d’étendue. Il contient en effet une chaîne au nom unique permettant d’identifier un itinéraire en particulier.

Filter

Facultatif

Chaîne

Chaîne qui vous permet de récupérer des itinéraires d’après la mise en correspondance de la valeur Identity et de la chaîne à caractères génériques transmise comme valeur à ce paramètre.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les informations d’itinéraire entre les zones réseau à partir de la réplique locale du magasin central de gestion, au lieu du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Cette cmdlet retourne un ou plusieurs objets de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Exemple

-------------------------- Exemple 1 --------------------------

Get-CsNetworkInterRegionRoute -Identity NA_APAC_Route

L’exemple 1 récupère l’itinéraire dont la propriété Identity est NA_APAC_Route.

-------------------------- Exemple 2 --------------------------

Get-CsNetworkInterRegionRoute -Filter *APAC*

Dans l’exemple 2, nous utilisons le paramètre Filter pour récupérer tous les itinéraires dont la valeur de propriété Identity contient la chaîne APAC quelque part.

-------------------------- Exemple 3 --------------------------

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

Cet exemple récupère tous les itinéraires de zones qui utilisent la liaison de zones réseau NA_EMEA. La commande commence par appeler la cmdlet Get-CsNetworkInterRegionRoute. L’appel à cette cmdlet sans paramètre récupère tous les itinéraires définis pour la configuration de contrôle d’admission des appels. Cette collection d’itinéraires est ensuite redirigée vers la cmdlet Where-Object. Where-Object prend la collection et récupère tous les éléments pour lesquels la valeur NA_EMEA apparaît dans leur liste NetworkRegionLinks.

-------------------------- Exemple 4 --------------------------

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

L’exemple 4 récupère tous les itinéraires de zones qui incluent la zone NorthAmerica. La première partie de la commande est un appel à la cmdlet Get-CsNetworkInterRegionRoute. Cette cmdlet, appelée sans paramètre, récupère tous les itinéraires de zones. Cette collection d’itinéraires est ensuite redirigée vers la cmdlet Where-Object. La cmdlet Where-Object limite la collection aux itinéraires dont NorthAmerica est défini comme l’une des régions de l’itinéraire. Pour cela, elle vérifie si l’itinéraire présente une valeur NetworkRegionID1 égale à (-eq) NorthAmerica ou (-or) une valeur NetworkRegionID2 égale à NorthAmerica.