Partager via

  • Article

Remove-CsNetworkInterRegionRoute

 

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

Supprime un itinéraire qui connecte des régions de réseau au sein d’une configuration de contrôle d’admission des appels (Call Admission Control ou CAC).

Syntaxe

Remove-CsNetworkInterRegionRoute -Identity <XdsGlobalRelativeIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Chaque région au sein d’une configuration de contrôle d’admission des appels doit être dotée d’un moyen d’accéder à chacune des autres régions. 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 supprime l’une des ses 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 Remove-CsNetworkInterRegionRoute : 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 "Remove-CsNetworkInterRegionRoute"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsGlobalRelativeIdentity

Identificateur unique de l’itinéraire de la région de réseau que vous souhaitez supprimer. Les itinéraires de région de réseau étant créés au niveau de l’étendue globale seulement, il n’est pas nécessaire de spécifier une étendue pour cet identificateur. Il contient en effet une chaîne au nom unique permettant d’identifier l’itinéraire.

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

WhatIf

Facultatif

Paramètre de commutateur

Décrit ce qui se passe si vous exécutez la commande sans l’exécuter réellement.

Confirm

Facultatif

Paramètre de commutateur

Vous demande confirmation avant d’exécuter la commande.

Types d’entrées

Objet Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType. Accepte la saisie de données transmises via le pipeline pour les objets d’itinéraire entre les zones réseau.

Types de retours

Cette cmdlet ne retourne aucune valeur. Elle supprime un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.InterNetworkRegionRouteType.

Exemple

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

Remove-CsNetworkInterRegionRoute -Identity NA_APAC_Route

L’exemple 1 supprime l’itinéraire dont l’identité est NA_APAC_Route.

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

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

L’exemple 2 supprime tous les itinéraires de région incluant la région NorthAmerica. La première partie de la commande appelle la cmdlet Get-CsNetworkInterRegionRoute. Cette cmdlet, appelée sans paramètres, récupère tous les itinéraires de région. 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 ce faire, elle vérifie si l’itinéraire dispose d’une valeur NetworkRegionID1 égale (-eq) à NorthAmerica ou (-or) une valeur NetworkRegionID2 égale à NorthAmerica. Une fois que la collection ne contient plus que les itinéraires incluant la région NorthAmerica, nous redirigeons la collection sur Remove-CsNetworkInterRegionRoute, qui supprime chacun des itinéraires.