Partager via

  • Article

Set-CsStaticRoutingConfiguration

 

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

Modifie une collection de paramètres de configuration du routage statique.

Syntaxe

Set-CsStaticRoutingConfiguration [-Identity <XdsIdentity>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Route <PSListModifier>] [-WhatIf [<SwitchParameter>]]

Set-CsStaticRoutingConfiguration [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Instance <PSObject>] [-Route <PSListModifier>] [-WhatIf [<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 Set-CsStaticRoutingConfiguration permet de modifier les valeurs de propriété d’une collection de routages statiques existante. Ainsi, vous pouvez utiliser la cmdlet pour ajouter de nouveaux itinéraires à une collection ou pour supprimer les itinéraires existants d’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 Set-CsStaticRoutingConfiguration : 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 "Set-CsStaticRoutingConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Facultatif

XdsIdentity

Identificateur unique d’une collection de configurations de routage statique à modifier. Pour modifier la collection globale, utilisez cette syntaxe : -Identity global. Pour modifier une collection appliquée au niveau de l’étendue Service, utilisez une syntaxe similaire à celle-ci : -Identity "service:Registrar:atl-cs-001.litwareinc.com". Vous ne pouvez pas utiliser de caractères génériques lors de la spécification de l’identité.

Si ce paramètre n’est pas inclus, Set-CsStaticRoutingConfiguration modifie automatiquement la collection globale.

Instance

Facultatif

Objet RoutingSettings

Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles.

Route

Facultatif

Modificateur de liste PS

Itinéraires statiques individuels gérés dans la collection. Les itinéraires à ajouter à une collection doivent soit être copiés à partir d’une autre collection, soit être créés à l’aide de la cmdlet New-CsStaticRoute. Pour supprimer un itinéraire d’une collection, vous devez tout d’abord créer une référence d’objet pour cet itinéraire. Pour plus d’informations, consultez la section Exemples de la rubrique d’aide correspondante.

Force

Facultatif

Paramètre de commutateur

Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande.

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.SipProxy.RoutingSettings. Set-CsStaticRoutingConfiguration accepte les instances transmises via le pipeline de l’objet de paramètres du routage statique.

Types de retours

Set-CsStaticRoutingConfiguration ne retourne aucune valeur ni objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemple

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

$x = Get-CsStaticRoutingConfiguration -Identity global | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Add=$x}

Les commandes présentées dans l’exemple 1 copient un itinéraire à partir de la collection globale de routages statiques, puis affectent cet itinéraire à une seconde collection de routages statiques (ayant l’identité service:Registrar:atl-cs-001.litwareinc.com). Pour effectuer cette tâche, la première commande de l’exemple se connecte à la collection globale et retourne une référence d’objet à l’itinéraire ayant la propriété MatchUri litwareinc.com et une propriété MatchOnlyPhoneUri égale à True.

Pour ce faire, la commande appelle Get-CsStaticRoutingConfiguration à retourner l’information depuis la collection globale de configurations de routages statiques. Ces données sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour développer les valeurs dans la propriété Route. Ces valeurs développées (qui représentent les itinéraires individuels affectés à la collection) sont ensuite redirigées vers la cmdlet Where-Object, qui choisit le seul itinéraire pour lequel la propriété MarchUri est égale à litwareinc.com et pour lequel la propriété MatchOnlyPhoneUri est égale à True. L’itinéraire retourné est stocké dans une variable nommée $x.

Une fois l’itinéraire récupéré, la seconde commande de l’exemple ajoute cet itinéraire à la collection service: Registrar:atl-cs-001.litwareinc.com. Pour ce faire, la cmdlet Set-CsStaticRoutingConfiguration est appelée avec le paramètre Route ; la valeur du paramètre @{Add=$x} indique à Set-CsStaticRoutingConfiguration d’ajouter l’itinéraire stocké dans la variable $x à la collection d’itinéraires gérée dans la propriété Route.

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

$x = Get-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com | Select-Object -ExpandProperty Route | Where-Object {$_.MatchUri -eq "litwareinc.com" -and $_.MatchOnlyPhoneUri -eq $True}

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route @{Remove=$x}

Les commandes ci-dessus suppriment un itinéraire d’une collection de routages statiques. Pour ce faire, la première commande de l’exemple se connecte à la collection avec l’identité service:Registrar:atl-cs-001.litwareinc.com et retourne une référence d’objet à l’itinéraire ayant la propriété MatchUri litwareinc.com et une propriété MatchOnlyPhoneUri égale à True. Pour ce faire, la commande appelle Get-CsStaticRoutingConfiguration à retourner l’information depuis la collection service:Registrar:atl-cs-001.litwareinc.com. Ces données sont ensuite redirigées vers la cmdlet Select-Object qui utilise le paramètre ExpandProperty pour développer les valeurs dans la propriété Route. Ces valeurs développées (qui représentent les itinéraires individuels affectés à la collection) sont ensuite redirigées vers la cmdlet Where-Object, qui choisit le seul itinéraire pour lequel la propriété MarchUri est égale à litwareinc.com et pour lequel la propriété MatchOnlyPhoneUri est égale à True. L’itinéraire retourné est ensuite stocké dans une variable nommée $x.

Une fois l’itinéraire récupéré, la seconde commande supprime cet itinéraire de la collection. Pour ce faire, la cmdlet Set-CsStaticRoutingConfiguration est appelée avec le paramètre Route ; la valeur du paramètre @{Remove=$x} indique à Set-CsStaticRoutingConfiguration de supprimer l’itinéraire stocké dans la variable $x.

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

Set-CsStaticRoutingConfiguration -Identity service:Registrar:atl-cs-001.litwareinc.com -Route $Null

L’exemple 3 indique comment supprimer tous les itinéraires affectés à la collection de configurations de routages statiques. Pour ce faire, il vous suffit d’inclure le paramètre Route et de définir la valeur du paramètre sur Null. Une fois la commande terminée, la collection continue d’exister, mais aucun itinéraire ne lui est affecté.