Partager via

  • Article

Get-CsStaticRoutingConfiguration

 

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

Retourne des informations sur les paramètres de configuration du routage statique utilisés au sein de votre organisation.

Syntaxe

Get-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]

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

Description détaillée

Lorsque vous envoyez un message SIP à quelqu’un, celui-ci devra peut-être transiter par plusieurs sous-réseaux et réseaux avant d’être remis. Le chemin parcouru par le message est souvent appelé « itinéraire ». En matière de réseau, il existe deux types d’itinéraires : dynamique et statique. Avec le routage dynamique, les serveurs utilisent des algorithmes afin de déterminer l’emplacement (ou tronçon) suivant vers lequel un message doit être transféré. Avec le routage statique, les chemins parcourus par les messages sont prédéfinis par les administrateurs système. Quand un message est reçu par un serveur, ce dernier vérifie son adresse, puis le transmet au tronçon suivant prédéfini par l’administrateur. S’ils sont configurés correctement, les itinéraires statiques contribuent à assurer une remise précise et en temps voulu des messages, tout en garantissant une charge minime sur les serveurs. Néanmoins, avec les itinéraires statiques, les messages ont l’inconvénient de ne pas être dynamiquement redirigés dans l’éventualité d’une défaillance du réseau.

Lorsque vous installez Microsoft Lync Server 2010, une collection globale d’itinéraires statiques est automatiquement créée pour vous. (La collection est créée, mais il n’existe pas d’itinéraires affectés à cette dernière.) En outre, le logiciel permet de créer d’autres collections appliquées au niveau de l’étendue Service (ces nouvelles collections ne pouvant être affectées qu’au service Serveur d’inscriptions). La cmdlet Get-CsStaticRoutingConfiguration permet de retourner des informations sur les collections de configurations de routage statique utilisées dans votre organisation. Elle permet notamment de retourner des informations détaillées sur chaque itinéraire affecté à une collection.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique de la collection de configurations de routage statique. Pour retourner des informations sur la collection globale, utilisez cette syntaxe : -Identity global. Pour récupérer des informations sur une collection configurée au niveau de l’étendue Service, utilisez une syntaxe similaire à celle-ci : -Identity "service:Registrar:atl-cs-001.litwareinc.com". Notez que les caractères génériques ne sont pas autorisés pour spécifier une identité. Si vous devez utiliser des caractères génériques, servez-vous du paramètre Filter.

Si vous n’incluez ni le paramètre Identity ni le paramètre Filter, alors Get-CsStaticRoutingConfiguration retourne des informations sur toutes vos collections de configurations de routage statique.

Filter

Facultatif

Chaîne

Permet d’utiliser des caractères génériques lors de la spécification d’une ou plusieurs collections de configurations de routage statique à retourner. Par exemple, cette syntaxe retourne tous les collections de routages statiques configurées au niveau de l’étendue Service : -Filter "service:*".

Notez que vous ne pouvez pas utiliser les paramètres Identity et Filter dans la même commande.

LocalStore

Facultatif

Paramètre de commutateur

Extrait les données de configuration du routage statique du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit.

Types d’entrées

Aucun. Get-CsStaticRoutingConfiguration n’accepte pas la saisie de données transmises via le pipeline.

Types de retours

Get-CsStaticRoutingConfiguration retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemple

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

Get-CsStaticRoutingConfiguration

La commande illustrée dans l’exemple 1 retourne des informations sur toutes les collections de configurations de routage statique utilisées dans votre organisation.

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

Get-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com"

Dans l’exemple 2, les informations relatives à une seule collection de configurations de routage statique sont retournées : il s’agit de la collection dont l’identité est service:Registrar:atl-cs-001.litwareinc.com.

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

Get-CsStaticRoutingConfiguration -Filter "service:*"

L’exemple 3 utilise le paramètre Filter pour retourner des informations sur les collections de configurations de routage statique affectées à l’étendue Service. La valeur de filtre "service:*" limite les valeurs retournées aux collections dont l’identité commence par la valeur de chaîne "service:".

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

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route

La commande présentée retourne des informations détaillées sur les itinéraires pour toutes les collections de configurations de routage statique utilisées dans votre organisation. Pour ce faire, la commande appelle d’abord Get-CsStaticRoutingConfiguration sans paramètres, afin de retourner des informations complètes pour chaque collection de routages statiques. Ces informations sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour « développer » la valeur de la propriété Route. Lorsque vous développez une propriété, tous les objets et valeurs qu’elle contient s’affichent à l’écran de manière extrêmement lisible.

-------------------------- Exemple 5 ------------------------

Get-CsStaticRoutingConfiguration | Select-Object -ExpandProperty Route | Where-Object {$_.MatchOnlyPhoneUri -eq $True}

La commande illustrée dans l’exemple 5 retourne des informations sur tous les itinéraires statiques configurés pour ne correspondre qu’aux URI (Uniform Resource Identifiers) de téléphone. Pour effectuer cette tâche, la commande appelle d’abord Get-CsStaticRoutingConfiguration sans paramètres, ce qui retourne toutes les collections de configurations de routage statique, ainsi que leurs itinéraires associés. Cette collection est ensuite redirigée vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour développer tous les objets stockés dans la propriété Route. Ces objets d’itinéraire sont ensuite redirigés vers la cmdlet Where-Object qui ne choisit que les itinéraires dont la propriété MatchOnlyPhoneUri est égale à True.