New-CsStaticRoute
Dernière rubrique modifiée : 2012-03-26
Crée un nouvel itinéraire téléphonique statique.
Syntaxe
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TLSRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>] [-TLSCertIssuer <String>] [-TLSCertSerialNumber <Byte[]>] [-UseDefaultCertificate <$true | $false>]
New-CsStaticRoute -Destination <String> -MatchUri <String> -Port <UInt16> -TCPRoute <SwitchParameter> [-Enabled <$true | $false>] [-MatchOnlyPhoneUri <$true | $false>] [-ReplaceHostInRequestUri <$true | $false>]
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, celui-ci vérifie son adresse, puis transfère le message vers le serveur du tronçon suivant qui a été préconfiguré par un 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.
Les nouveaux itinéraires statiques sont créés à l’aide de la cmdlet New-CsStaticRoute. Une fois l’itinéraire créé à l’aide de la cmdlet New-CsStaticRoute, vous devez l’ajouter à un ensemble de paramètres de configuration de routage en faisant appel à la cmdlet Set-CsStaticRoutingConfiguration.
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-CsStaticRoute : 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-CsStaticRoute"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Destination |
Obligatoire |
Chaîne |
Si l’itinéraire utilise le protocole de transport TLS (Transport Layer Security), la destination correspond au nom de domaine complet (FQDN) du serveur de tronçon suivant. Par exemple : -Destination "atl-proxy-001.litwareinc.com". Si l’itinéraire utilise le protocole de transport TCP (Transmission Control Protocol), la destination correspond à l’adresse IP du routeur de tronçon suivant. Par exemple : -Destination "192.168.0.240". |
MatchUri |
Obligatoire |
Chaîne |
Nom de domaine complet ou suffixe de domaine utilisé pour déterminer si le message est envoyé à un utilisateur géré par cet itinéraire. Par exemple, vous pouvez utiliser le nom de domaine complet « litwareinc.com ». Ce modèle fait correspondre tout utilisateur dont l’adresse SIP se termine par le nom de domaine « litwareinc.com ». Pour faire correspondre les domaines enfants d’un domaine, vous pouvez utiliser une valeur à caractère générique telle que « *.litwareinc.com ». Cette valeur fait correspondre tout domaine se terminant par le suffixe « litwareinc.com ». Par exemple : northamerica.litwareinc.com, asia.litwareinc.com et europe.litwareinc.com. |
Enabled |
Facultatif |
Booléen |
Si le paramètre est défini sur True, l’itinéraire est activé et tous les messages correspondant au modèle MatchURI sont acheminés vers le serveur du tronçon suivant. S’il est défini sur False, l’itinéraire est désactivé et n’est pas utilisé pour acheminer les messages. La valeur par défaut est True. |
MatchOnlyPhoneUri |
Facultatif |
Booléen |
Si le paramètre est défini sur True, seuls les messages adressés à des URI (Uniform Resource Identifier) de téléphone (par exemple, sip:kenmmyer@litwareinc.com;user=phone) seront renvoyés et éventuellement acheminés. S’il est défini sur False (valeur par défaut), tous les messages seront renvoyés. |
Port |
Obligatoire |
Entier |
Numéro de port utilisé pour l’itinéraire SIP. Par exemple : -Port 7742. |
ReplaceHostInRequestUri |
Facultatif |
Booléen |
Si le paramètre est défini sur True ($True), la partie hôte d’un URI de demande sera remplacée par l’adresse du serveur de tronçon suivant. S’il est défini sur False, l’URI de demande sera utilisé en l’état. L’URI de demande représente l’URI de l’utilisateur ou du service auquel la demande (le message) est adressée. La valeur par défaut est False. |
TCPRoute |
Facultatif |
Paramètre de commutateur |
Configure le protocole de transport TCP pour le nouvel itinéraire. |
TLSCertIssuer |
Facultatif |
Chaîne |
Nom de l’autorité de certification (CA) qui a émis le certificat à utiliser dans l’itinéraire statique. Ce paramètre n’est pas utilisé si vous avez configuré le protocole de transport TCP. Si vous incluez le paramètre TLSCertIssuer, vous devez également utiliser le paramètre TLSCertSerialNumber. |
TLSCertSerialNumber |
Facultatif |
Tableau d’octets |
Numéro de série du certificat TLS à utiliser dans l’itinéraire statique. Les numéros de série doivent être transmis sous la forme d’un tableau d’octets. Cela signifie que le numéro de série doit être transmis sous la forme d’un tableau de valeurs à deux caractères. Par exemple : -TLSCertSerialNumber 0x01, 0xA4, 0xD5, 0x67, 0x89. Ce paramètre n’est pas utilisé si vous avez configuré le protocole de transport TCP. Si vous incluez le paramètre TLSCertSerialNumber, vous devez également utiliser le paramètre TLSCertIssuer. |
TLSRoute |
Facultatif |
Paramètre de commutateur |
Configure le protocole de transport TLS pour le nouvel itinéraire. |
UseDefaultCertificate |
Facultatif |
Booléen |
Configure l’itinéraire afin qu’il utilise votre certificat Lync Server 2010 par défaut comme certificat d’authentification propre. Si vous ne voulez pas utiliser le certificat par défaut, vous devez spécifier un autre certificat à l’aide des paramètres TLSCertIssuer et TLSCertSerialNumber. Pour afficher le certificat par défaut, exécutez la commande suivante : Get-CsCertificate | Where-Object {$_.Use –eq « urn:certref:Default »} |
Types d’entrées
Aucun. New-CsStaticRoute n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsStaticRoute crée de nouvelles instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Route.
Exemple
-------------------------- Exemple 1 ------------------------
$x = New-CsStaticRoute -TCPRoute -Destination "192.168.0.100" -Port 8025 -MatchUri "litwareinc.com"
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
Les commandes illustrées dans l’exemple 1 créent un nouvel itinéraire statique, puis l’ajoutent à l’ensemble de paramètres globaux de configuration de routage statique. Pour exécuter cette tâche, la première commande utilise la cmdlet New-CsStaticRoute pour créer un itinéraire en mémoire uniquement qui utilise le protocole de transport TCP. L’itinéraire pointe sur l’adresse IP du tronçon suivant 192.168.0.100, utilise le port 8025 et fait correspondre tous les URI provenant du domaine litwareinc.com. L’objet d’itinéraire résultant est stocké dans une variable appelée $x.
La deuxième commande de l’exemple est ensuite utilisée pour ajouter le nouvel itinéraire à l’ensemble de paramètres globaux de configuration de routage statique. Cette opération est effectuée en appelant la cmdlet Set-CsStaticRoutingConfiguration avec le paramètre Route. La valeur de paramètre @{Add=$x} ajoute l’objet d’itinéraire stocké dans $x à l’ensemble existant d’itinéraires déjà contenus dans l’ensemble global.
-------------------------- Exemple 2 ------------------------
$x = New-CsStaticRoute -TLSRoute -Destination "atl-proxy-001.litwareinc.com" -Port 8025 -MatchUri "*.litwareinc.com" -UseDefaultCertificate $True
Set-CsStaticRoutingConfiguration -Identity global -Route @{Add=$x}
L’exemple 2 explique comment créer un nouvel itinéraire statique utilisant le protocole de transport TLS, et ajouter cet itinéraire à l’ensemble de paramètres globaux de configuration de routage statique. Pour ce faire, la première commande de l’exemple utilise New-CsStaticRoute pour créer un itinéraire en mémoire uniquement qui utilise le protocole de transport TLS. L’itinéraire pointe sur l’adresse « atl-proxy-001.litwareinc.com », utilise le port 8025 et fait correspondre tout URI utilisant le suffixe de domaine « litwareinc.com ». En outre, le nouvel objet d’itinéraire, qui est stocké dans une variable appelé $x, utilise le certificat par défaut à des fins d’authentification (-UseDefaultCertificate $True).
Une fois l’objet d’itinéraire créé, la deuxième commande de l’exemple ajoute ensuite le nouvel itinéraire à l’ensemble de paramètres globaux de configuration de routage statique.