Partager via

  • Article

Get-CsNetworkRegionLink

 

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

Récupère un ou plusieurs liens entre des régions du réseau configurés pour le contrôle d’admission des appels (CAC).

Syntaxe

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

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

Description détaillée

Les régions au sein d’un réseau sont liées par le biais d’une connectivité WAN physique. Cette cmdlet récupère un ou plusieurs liens de région qui sont définis dans les paramètres de configuration réseau pour un déploiement Microsoft Lync Server 2010.

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-CsNetworkRegionLink : 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-CsNetworkRegionLink"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsGlobalRelativeIdentity

Identificateur unique du lien de région réseau que vous souhaitez récupérer. Les liens de région réseau sont créés uniquement au niveau de l’étendue globale. Par conséquent, cet identificateur ne doit pas nécessairement spécifier une étendue. Au lieu de cela, il contient une chaîne qui est un nom unique qui identifie ce lien. (Notez que cette valeur est identique à NetworkRegionLinkID).

Filter

Facultatif

Chaîne

Accepte une chaîne de caractères génériques qui est utilisée pour récupérer des liens réseau selon la correspondance de la valeur de Identity à la chaîne de caractères génériques.

LocalStore

Facultatif

Paramètre de commutateur

Récupère les informations de lien entre les régions de réseau à partir du réplica local du magasin central de gestion, au lieu du magasin central de gestion lui-même.

Types d’entrées

Aucun.

Types de retours

Récupère un ou plusieurs objets de type Microsoft.Rtc.Management.WritableConfig.Settings.NetworkConfiguration.NetworkRegionLinkType.

Exemple

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

Get-CsNetworkRegionLink

L’exemple 1 récupère tous les liens de région de réseau définis dans un déploiement Lync Server 2010.

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

Get-CsNetworkRegionLink -Identity NA_EMEA

L’exemple 2 récupère des informations sur (au plus) un lien de région réseau, le lien dont l'identité est NA_EMEA.

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

Get-CsNetworkRegionLink -Filter *EMEA*

Dans cet exemple, nous utilisons le paramètre Filter pour récupérer tous les liens de région réseau dont le nom (identité) comporte la chaîne EMEA. Remarquez les caractères *, un avant la chaîne EMEA et l’autre après. Cela signifie qu’un ou plusieurs caractères peuvent précéder ou suivre la chaîne ; la chaîne EMEA doit simplement être incluse quelque part dans l'identité. Cela récupérera les liens portant des noms tels que NA_EMEA, EMEA_APAC et EMEA2_SA.

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

Get-CsNetworkRegionLink | Where-Object {$_.NetworkRegionID1 -eq "EMEA" -or $_.NetworkRegionID2 -eq "EMEA"}

Cet exemple récupère tous les liens de région réseau qui incluent EMEA comme l’une des deux régions liées. L’exemple commence par appeler Get-CsNetworkRegionLink sans paramètre afin de récupérer tous les liens de région. Cette collection de liens est ensuite redirigée vers la cmdlet Where-Object. Where-Object parcourt chaque membre de la collection un par un et vérifie les valeurs des propriétés NetworkRegionID1 et NetworkRegionID2. Si une de ces propriétés est égale à EMEA, en d’autres termes si NetworkRegionID1 est égale à (-eq) EMEA ou (-or) NetworkRegionID2 est égale à (-eq) EMEA, alors il faut conserver cet élément dans la collection et l’afficher.