New-CsSipProxyTCP
Dernière rubrique modifiée : 2012-03-25
Crée un objet SipProxy.TCP qui peut ensuite être utilisé pour configurer un itinéraire statique afin d’utiliser le protocole TCP (Transmission Control Protocol) comme protocole de transport.
Syntaxe
New-CsSipProxyTCP -IPAddress <String>
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.
Microsoft 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 : de paramètres de configuration de proxy (créés en utilisant New-CsProxyConfiguration) et d’itinéraires proxy. Les itinéraires proxy SIP présentent, quant à eux, diverses propriétés ; par exemple, chaque itinéraire doit avoir une propriété Transport, qui définit le protocole réseau utilisé pour la transmission des messages le long de l’itinéraire.
Lync Server 2010 permet de définir TCP (Transmission Control Protocol) ou TLS (Transport Layer Security) comme protocole de transport. Si vous optez pour TCP, vous devez préalablement créer un objet TCP en utilisant la cmdlet New-CsSipProxyTCP. Vous pouvez alors utiliser cet objet pour définir le protocole de l’objet Transport créé par New-CsSipProxyTransport.
Vous n’avez pas besoin d’utiliser New-CsSipProxyTCP 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-CsSipProxyTCP : 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-CsSipProxyTCP"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
IPAddress |
Obligatoire |
Chaîne |
Adresse IP du routeur de destination suivant. Par exemple : -IPAddress 192.168.0.240. |
Types d’entrées
Aucun. New-CsSipProxyTCP n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
New-CsSipProxyTCP crée de nouvelles instances de l'objet Microsoft.Rtc.Management.WritableConfig.Settings.SipProxy.TCP.
Exemple
-------------------------- Exemple 1 ------------------------
$tcp = New-CsSipProxyTCP -IPAddress 192.168.1.100
$transport = New-CsSipProxyTransport -TransportChoice $tcp -Port 7500
Les commandes de l’exemple 1 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 crée un objet de transport TCP.