Partager via

  • Article

New-CsTrunkConfiguration

 

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

Crée une nouvelle configuration de tronçon qui décrit les paramètres d’une entité de tronçons couplés, comme une passerelle PSTN (réseau téléphonique commuté), un système IP-PBX ou un contrôleur de session en périphérie (SBC), chez le fournisseur de services.

Syntaxe

New-CsTrunkConfiguration -Identity <XdsIdentity> [-ConcentratedTopology <$true | $false>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-EnableBypass <$true | $false>] [-EnableMobileTrunkSupport <$true | $false>] [-EnablePIDFLOSupport <$true | $false>] [-EnableReferSupport <$true | $false>] [-EnableSessionTimer <$true | $false>] [-EnableSignalBoost <$true | $false>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Utilisez cette cmdlet pour créer une nouvelle configuration de tronçon applicable à des passerelles PSTN. Chaque configuration contient les paramètres spécifiques d’une entité de tronçons couplés existante, comme une passerelle PSTN, un système IP-PBX ou un contrôleur de session en périphérie (SBC), chez le fournisseur de services. Ces paramètres déterminent, entre autres, si la fonctionnalité de déviation du trafic multimédia est activée sur ce tronçon, si les paquets RTCP (Real-time Transport Control Protocol) sont envoyés dans certaines conditions et si un chiffrement SRTP (Secure Real-time Transport Protocol) est nécessaire.

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-CsTrunkConfiguration : 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-CsTrunkConfiguration"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Identificateur unique qui inclut l’étendue de la configuration de tronçon. La configuration de tronçon peut être créée au niveau de l’étendue globale ou de l’étendue Site, voire au niveau de l’étendue Service pour un service de passerelle PSTN. (Une configuration globale existe par défaut et ne peut être ni supprimée, ni recréé.) Exemple : site:Redmond (pour le site) ou PstnGateway:Redmond.litwareinc.com (pour le service).

ConcentratedTopology

Facultatif

Booléen

La valeur de ce paramètre détermine s’il existe un point de terminaison multimédia connu (une passerelle PSTN où la terminaison multimédia possède la même adresse IP que la terminaison de signalisation est un exemple de point de terminaison multimédia connu). Définissez cette valeur sur False si le tronçon ne comporte pas de point de terminaison multimédia connu.

Valeur par défaut : True

Description

Facultatif

Chaîne

Chaîne décrivant l’objectif de la configuration de tronçon.

EnableBypass

Facultatif

Booléen

La valeur de ce paramètre détermine si la fonctionnalité de déviation du trafic multimédia est activée pour ce tronçon. Définissez cette valeur sur True pour activer la déviation du trafic multimédia. Notez que pour que la déviation du trafic multimédia fonctionne correctement, les passerelles PSTN, les contrôleurs de session en périphérie (SBC) et les autocommutateurs privés (PBX) doivent prendre en charge certaines fonctionnalités, parmi lesquelles :

- La possibilité de recevoir des réponses dirigées à une invitation.

- Les clients Microsoft Lync Server 2010 et le point de terminaison multimédia doivent pouvoir communiquer directement entre eux sans passer par un serveur de médiation.

- Le sous-réseau de la passerelle doit être défini comme étant situé sur le même site que celui du sous-réseau du client. S’il est situé sur un autre site, les sites ne doivent pas être séparés par des liaisons réseau étendu (WAN) munies d’une bande passante restreinte.

La déviation du trafic multimédia ne peut être activée que dans les circonstances suivantes :

- Le paramètre ConcentratedTopology est défini sur True.

- Le paramètre EnableReferSupport est défini sur False, RTCPActiveCalls et RTCPCallsOnHold sont définis sur False ou EnableReferSupport est défini sur True.

Notez que si EnableBypass est True et EnableReferSupport est False, les appels déviés et transférés par la suite deviennent non déviés.

Pour que la déviation du trafic multimédia fonctionne pour un tronçon en particulier, vous devez l’activer globalement et individuellement pour le tronçon en question. Utilisez la cmdlet New-CsNetworkMediaBypassConfiguration pour activer globalement la déviation du trafic multimédia.

Valeur par défaut : False

EnableMobileTrunkSupport

Facultatif

Booléen

Définit si le fournisseur de services est un opérateur mobile.

Valeur par défaut : False

EnablePIDFLOSupport

Facultatif

Booléen

Définit si les appels d’urgence doivent être acheminés avec un objet PIDF-LO (Presence Information Data Format Location Object) via la passerelle définie. Définissez ce paramètre sur True si les appels d’urgence sont à acheminer vers un fournisseur de services d’urgence certifié. (L’emplacement sera transmis avec l’appel.)

Valeur par défaut : False

EnableReferSupport

Facultatif

Booléen

Détermine si ce tronçon prend en charge la réception de demandes de référencement en provenance du serveur de médiation.

La déviation du trafic multimédia ne peut être activée que dans les circonstances suivantes :

- Le paramètre ConcentratedTopology est défini sur True.

- Le paramètre EnableReferSupport est défini sur False, RTCPActiveCalls et RTCPCallsOnHold sont définis sur False ou EnableReferSupport est défini sur True.

Notez que si EnableBypass est True et EnableReferSupport est False, les appels déviés et transférés par la suite deviennent non déviés.

Valeur par défaut : True

EnableSessionTimer

Facultatif

Booléen

Indique si le temporisateur de session est activé. Les temporisateurs de session sont utilisés pour déterminer si une session particulière est toujours active.

Notez que même si ce paramètre est défini sur False, des temporisateurs de session peuvent être appliqués si un temporisateur de session est activé pour la connexion distante. Dans un cas comme celui-ci, le serveur de médiation répond aux sondages du temporisateur de session à partir de l’entité distante.

Valeur par défaut : False

EnableSignalBoost

Facultatif

Booléen

Lorsque ce paramètre est défini sur True, la passerelle PSTN, le système IP-PBX ou le contrôleur de session en périphérie (SBC) chez le fournisseur de services gonfle le volume audio en flux vocaux qui sont transmis au serveur de médiation ou aux clients Microsoft Lync Server 2010. Si cette valeur est définie sur False, le volume audio sera augmenté soit sur le serveur de médiation (pour les appels non déviés), soit sur les clients Lync Server 2010 (pour les appels déviés).

Valeur par défaut : False

MaxEarlyDialogs

Facultatif

Int64

Nombre maximal de réponses dirigées qu’une passerelle PSTN, un système IP-PBX ou un contrôleur de session en périphérie (SBC), chez le fournisseur de services, peut recevoir pour une invitation qui est envoyée au serveur de médiation.

Valeur par défaut : 20

OutboundTranslationRulesList

Facultatif

Modificateur de liste PS

Collection de règles de traduction de numéros de téléphone qui s’appliquent aux appels gérés par le routage sortant (appels acheminés vers les destinations PBX ou PSTN).

Même si cette liste et ces règles peuvent être créées directement avec cette cmdlet, il est recommandé de créer les règles de traduction sortante avec la cmdlet New-CsOutboundTranslationRule qui crée la règle et l’attribue à la configuration de tronçon avec l’étendue correspondante.

RemovePlusFromUri

Facultatif

Booléen

La définition de ce paramètre sur True entraînera la suppression des signes plus (+) à gauche des URI (Uniform Resource Identifier) par le serveur de médiation avant de les envoyer au fournisseur de services.

Valeur par défaut : False

RTCPActiveCalls

Facultatif

Booléen

Ce paramètre détermine si des paquets RTCP sont transmis à la passerelle PSTN, au système IP-PBX ou au contrôleur de session en périphérie (SBC) côté fournisseur de services pour les appels actifs. Un appel actif dans ce contexte désigne un appel qui est autorisé à voyager dans au moins une direction. Si le paramètre RTCPActiveCalls est défini sur True, le serveur de médiation ou le client Lync Server peut mettre fin à un appel s’il ne reçoit aucun paquet RTCP dans un délai de plus de 30 secondes.

Notez que toute désactivation des contrôles du trafic multimédia RTCP reçu pour les appels actifs dans les éléments de Lync Server vous prive d’un garde-fou important lors de la détection d’une paire supprimée. Cette opération ne doit donc être effectuée que si elle est vraiment nécessaire.

Valeur par défaut : True

RTCPCallsOnHold

Facultatif

Booléen

Ce paramètre détermine si des paquets RTCP continuent d’être envoyés sur le tronçon pour les appels qui ont été mis en attente et si aucun paquet multimédia n’est supposé prendre une direction quelconque. Si une attente musicale est activée sur le client Lync Server ou sur le tronçon, l’appel sera considéré comme étant actif et cette propriété sera ignorée. Dans ces circonstances, utilisez le paramètre RTCPActiveCalls.

Notez que toute désactivation des contrôles du trafic multimédia RTCP reçu pour les appels actifs dans les éléments de Lync Server vous prive d’un garde-fou important lors de la détection d’une paire supprimée. Cette opération ne doit donc être effectuée que si elle est vraiment nécessaire.

Valeur par défaut : True

SipResponseCodeTranslationRulesList

Facultatif

Modificateur de liste PS

Liste de règles de traduction de codes de réponse SIP applicables aux codes de réponse reçus d’une passerelle PSTN, d’un système IP-PBX ou d’un contrôleur de session en périphérie (SBC) chez le fournisseur de services. Ces règles permettent à l’administrateur de mapper les codes de réponse SIP ayant des valeurs comprises entre 400 et 699 reçues dans un tronçon avec des nouvelles valeurs plus cohérentes avec Lync Server.

Vous pouvez créer cette liste et les règles qui y correspondent directement à l’aide de cette cmdlet. Néanmoins, nous vous recommandons de créer les règles de traduction de codes de réponse SIP en appelant la cmdlet New-CsSipResponseCodeTranslationRule. Celle-ci crée la règle et l’attribue à la configuration de tronçon avec l’étendue correspondante.

SRTPMode

Facultatif

SRTPMode

La valeur de ce paramètre détermine le niveau de prise en charge du chiffrement SRTP pour la protection du trafic multimédia entre le serveur de médiation et la passerelle PSTN, le système IP-PBX ou le contrôleur de session en périphérie (SBC) chez le fournisseur de services. Dans les cas de déviation du trafic multimédia, cette valeur doit être compatible avec le paramètre EncryptionLevel de la configuration multimédia. La configuration multimédia est définie à l’aide des cmdlets New-CsMediaConfiguration et Set-CsMediaConfiguration.

Valeurs valides :

- Required : le chiffrement SRTP doit être utilisé.

- Optional : le chiffrement SRTP sera utilisé s’il est pris en charge par la passerelle.

- NotSupported : le chiffrement SRTP n’est pas pris en charge et ne sera donc pas utilisé.

Remarque : SRTPMode est utilisé uniquement si la passerelle est configurée en vue d’un recours au protocole de transport TLS (Transport Layer Security). Si la passerelle est configurée avec le protocole de transport TCP, SRTPMode est défini en interne sur NotSupported.

Valeur par défaut : Obligatoire

Force

Facultatif

Paramètre de commutateur

Supprime les invites de confirmation qui s’affichent avant d’effectuer des modifications.

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.

Types de retours

Crée un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.

Exemple

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

New-CsTrunkConfiguration -Identity site:Redmond

Cet exemple crée une nouvelle configuration de tronçon comportant le paramètre Identity site:Redmond. Les propriétés restantes de cette nouvelle configuration adopteront les valeurs par défaut.

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

New-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True

Cet exemple crée une nouvelle configuration de tronçon comportant le paramètre Identity site:Redmond et il active la déviation du trafic multimédia. La déviation du trafic multimédia est activée en affectant la valeur $True au paramètre EnableBypass. Les propriétés restantes de cette nouvelle configuration adopteront les valeurs par défaut.

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

New-CsTrunkConfiguration -Identity site:Redmond
New-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Pattern '^\+(\d{8})$' -Translation '9$1'

Cet exemple crée une nouvelle configuration de tronçon comportant le paramètre Identity site:Redmond, puis affecte une nouvelle traduction sortante à ce tronçon. La première ligne de cet exemple appelle la cmdlet New-CsTrunkConfiguration pour créer la nouvelle configuration de tronçon avec les paramètres par défaut. La deuxième ligne appelle la cmdlet New-CsOutboundTranslationRule. Notez la valeur affectée au paramètre Identity : site:Redmond/OTR1. La première partie du paramètre Identity (site:Redmond) définit l’étendue dans laquelle s’applique la règle. Cette étendue correspond au paramètre Identity de la nouvelle configuration de tronçon ; cela signifie que cette règle sera automatiquement appliquée à cette configuration. L’étendue est suivie d’une barre oblique (/) puis d’une chaîne : il s’agit d’un nom unique pour cette règle (il peut exister plus d’une règle par étendue). Après cela, nous transmettons simplement les valeurs aux paramètres Pattern et Translation afin de définir cette règle.