New-CsSipProxyTransport
Dernière rubrique modifiée : 2012-03-27
Spécifie le protocole de transmission à utiliser dans un itinéraire statique. Microsoft Lync Server 2010 vous permet de choisir entre TCP (Transmission Control Protocol) et TLS (Transport Layer Security) comme le protocole de transmission d’un itinéraire.
Syntaxe
New-CsSipProxyTransport -Port <UInt16> -TransportChoice <ITransportChoice>
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.
Lync Server 2010 permet de définir des itinéraires statiques pour les serveurs proxy. Ces itinéraires sont constitués de deux principaux éléments : paramètres de configuration proxy et itinéraires proxy SIP. Les itinéraires proxy SIP ont un certain nombre de propriétés. Par exemple, chaque itinéraire doit avoir une propriété Transport qui définit le protocole réseau utilisé pour transmettre les messages dans l’itinéraire. La propriété de transport peut être spécifiée à l’aide de la cmdlet New-CsSipProxyTransport.
New-CsSipProxyTransport comporte deux paramètres obligatoires : TransportChoice et Port. Le paramètre TransportChoice est configuré à l’aide d’une autre cmdlet, soit New-CsSipProxyTCP (pour affecter le protocole de contrôle de transmission en tant que transport d’itinéraire), soit New-CsSipProxyTLS (pour affecter TLS en tant que transport d’itinéraire). Tout objet de transport créé à l’aide de New-CsSipProxyTransport doit être enregistré dans une variable. Cette variable sera ensuite utilisée pour configurer la propriété de transport d’un itinéraire proxy SIP.
Vous n’avez pas besoin d’utiliser la cmdlet New-CsSipProxyTransport si vous utilisez New-CsStaticRoute pour créer votre itinéraire statique.
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-CsSipProxyTransport : 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-CsSipProxyTransport"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Port |
Obligatoire |
Entier |
Numéro de port utilisé pour l’itinéraire SIP. Par exemple : -Port 7742. |
TransportChoice |
Obligatoire |
Objet de transport |
Indique le protocole de transmission à utiliser (TCP ou TLS) sur l’itinéraire statique. Pour utiliser le protocole TCP, créez un objet de transport à l’aide de la cmdlet New-CsSipProxyTCP. Pour utiliser le protocole TLS, créez un objet de transport à l’aide de la cmdlet New-CsSipProxyTLS. |
Types d’entrées
Aucun. New-CsSipProxyTransport n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsSipProxyTransport crée des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.Transport.
Exemple
-------------------------- Exemple 1 --------------------------
$cert = New-CsSipProxyUseDefaultCert
$tls = New-CsSipProxyTLS -Certificate $cert -Fqdn atl-proxy-001.litwareinc.com
$transport = New-CsSipProxyTransport -TransportChoice $tls -Port 7500
La commande illustrée à l’exemple 1 crée un nouvel objet de transport proxy SIP qui utilise le TLS comme véhicule. Comme TLS nécessite un certificat (utilisé pour l’authentification), la première commande de l’exemple utilise New-CsSipProxyUseDefaultCert pour configurer un nouvel objet SipProxy.UseDefaultCert. Celui-ci, stocké dans la variable $cert, indique à Lync Server d’utiliser le certificat par défaut pour le transport TLS. Une fois l’objet UseDefaultCert créé, New-CsSipProxyTLS peut être appelé pour créer un objet SipProxy.TLS qui utilise le certificat par défaut et qui pointe vers le nom de domaine complet atl-proxy-001.litwareinc.com du serveur du tronçon suivant.
-------------------------- Exemple 2 --------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Les commandes de l’exemple 2 créent un objet de transport proxy SIP qui utilise le protocole de transport TCP. Pour ce faire, la première commande de l’exemple utilise New-CsSipProxyTCP pour créer un nouvel objet SipProxy.TCP qui pointe vers le prochain serveur de tronçon avec l’adresse IP 192.168.1.100. Cet objet TCP est enregistré dans la variable appelée $tcp.
Une fois l’objet SipProxy.TCP créé, la cmdlet New-CsSipProxyTransport peut être appelée pour créer un objet de transport TCP.