Partager via

  • Article

New-CsStaticRoutingConfiguration

 

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

Crée une nouvelle collection de paramètres de configuration de routage statique.

Syntaxe

New-CsStaticRoutingConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-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. Lorsqu’un message est reçu par un serveur, ce dernier vérifie l’adresse du message, puis transmet le message vers le serveur de destination suivant prédéfini par un administrateur. S’ils sont correctement définis, les itinéraires statiques contribuent à garantir une remise précise et à temps des messages, en sollicitant les serveurs avec modération. 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. Vous pouvez en outre utiliser la cmdlet New-CsStaticRoutingConfiguration pour créer d’autres collections, ainsi que l’étendue Site ou l’étendue Service (pour le service Serveur d’inscriptions uniquement).

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet New-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 "New-CsStaticRoutingConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique de la nouvelle collection d’itinéraires statiques à créer. Les nouvelles collections ne peuvent être créées qu’au niveau de l’étendue Service et ne peuvent être attribuées qu’au service Serveur d’inscriptions. C’est pourquoi la propriété Identity d’une nouvelle collection doit être comme suit : -Identity "service:Registrar:atl-cs-001.litwareinc.com".

Route

Facultatif

Modificateur de liste PS

Itinéraires statiques individuels gérés dans la collection. Les itinéraires à ajouter à une collection doivent être copiés à partir d’une autre collection ou créés à l’aide de la cmdlet New-CsStaticRoute. Pour plus d’informations, consultez la section Exemples de cette rubrique.

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.

InMemory

Facultatif

Paramètre de commutateur

Crée une référence d’objet sans valider l’objet comme une modification définitive. Si vous affectez à une variable la sortie de cette cmdlet appelée avec ce paramètre, vous pouvez apporter des modifications aux propriétés de la référence d’objet, puis les valider en appelant la cmdlet Set- correspondante.

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

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

Types de retours

New-CsStaticRoutingConfiguration crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.RoutingSettings.

Exemple

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

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

La commande ci-dessus crée une collection de configurations d’itinéraires statiques dont la propriété Identity est service:Registrar:atl-cs-001.litwareinc.com. Étant donné que le paramètre Route n’est pas inclus à la commande, la nouvelle collection ne se verra attribuer aucun itinéraire statique.

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

$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "*.litwareinc.com"

New-CsStaticRoutingConfiguration -Identity "service:Registrar:atl-cs-001.litwareinc.com" -Route $x

La commande illustrée dans l’exemple 2 crée un itinéraire proxy SIP qui utilise le protocole TCP comme transport ; ce nouvel itinéraire est ensuite ajouté à une collection de configuration d’itinéraires statiques. Pour cela, la première commande de l’exemple utilise New-CsStaticRoute afin de créer un itinéraire pointant vers le serveur de destination suivant, avec l’adresse IP 192.168.1.100. Ce nouvel itinéraire (stocké dans une variable nommée $x) utilise également le port 8025 et le MatchUri « *.litwareinc.com ».

Ensuite, New-CsStaticRoutingConfiguration est appelée pour créer une collection (dont la propriété Identity est service:Registrar:atl-cs-001.litwareinc.com), attribuant l’itinéraire stocké dans la variable $x à la propriété Route de la nouvelle collection.