Set-CsTrunkConfiguration
Dernière rubrique modifiée : 2012-03-25
Modifie une configuration de tronçon existante 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
Set-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>] [-MaxEarlyDialogs <UInt32>] [-OutboundTranslationRulesList <PSListModifier>] [-RemovePlusFromUri <$true | $false>] [-RTCPActiveCalls <$true | $false>] [-RTCPCallsOnHold <$true | $false>] [-SipResponseCodeTranslationRulesList <PSListModifier>] [-SRTPMode <Required | Optional | NotSupported>] [-WhatIf [<SwitchParameter>]]
Set-CsTrunkConfiguration [-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>] [-Instance <PSObject>] [-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 modifier une configuration de tronçon applicable aux entités de passerelle 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 Set-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 "Set-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 exister au niveau de l’étendue globale ou de l’étendue Site, voire au niveau de l’étendue Service pour un service de passerelle PSTN. Exemple : site:Redmond (pour le site) ou PstnGateway:Redmond.litwareinc.com (pour le service). |
Instance |
Facultatif |
TrunkConfiguration |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. Ce paramètre nécessite un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration que vous pouvez récupérer en appelant la cmdlet Get-CsTrunkConfiguration. |
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 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 de 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 du trafic sortant (appels acheminés vers des destinations PBX ou PSTN). Si cette liste et ces règles peuvent être modifiées directement à l’aide de cette cmdlet, nous recommandons de modifier les règles de traduction sortante avec la cmdlet Set-CsOutboundTranslationRule. La cmdlet Set-CsOutboundTranslationRule modifiera la règle et ces modifications seront automatiquement reflétées dans la configuration de tronçon. Pour modifier la configuration de tronçon en ajoutant une nouvelle règle de traduction sortante, appelez la cmdlet New-CsOutboundTranslationRule. Cette dernière sera ajoutée à 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 le fournisseur de services. - 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. |
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
Objet Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration. Accepte la saisie de données transmises via le pipeline pour les objets de configuration de tronçon.
Types de retours
Cette cmdlet ne retourne aucune valeur. Elle modifie un objet de type Microsoft.Rtc.Management.WritableConfig.Settings.TrunkConfiguration.TrunkConfiguration.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnableBypass $True
Cet exemple modifie une configuration de tronçon munie du paramètre Identity site:Redmond dans le but d’activer 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 configuration conserveront leurs valeurs existantes.
-------------------------- Exemple 2 ------------------------
Set-CsOutboundTranslationRule -Identity site:Redmond/OTR1 -Translation '$1'
Dans cet exemple, une règle de traduction sortante définie pour la configuration de tronçon comportant l’identité site:Redmond est modifiée. Notez que nous n’appelons pas en réalité la cmdlet Set-CsTrunkConfiguration pour effectuer ce changement. Les modifications apportées avec la cmdlet Set-CsOutboundTranslationRule seront automatiquement reflétées dans la configuration de tronçon dont l’identité correspond à la partie étendue de l’identité de la règle de traduction sortante.
-------------------------- Exemple 3 ------------------------
Get-CsTrunkConfiguration -Filter site:* | Set-CsTrunkConfiguration -SRTPMode "Optional"
L’exemple 3 définit le paramètre SRTPMode pour toutes les configurations de tronçon définies sur Optional (Facultatif) dans l’étendue Site. La première partie de la commande est l’appel de la cmdlet Get-CsTrunkConfiguration qui utilise le paramètre Filter pour extraire toutes les configurations de tronçon dont le paramètre Identify commence par « site: », c’est-à-dire toutes les configurations de tronçon définies au niveau du site. Cette collection de configurations est ensuite redirigée vers la cmdlet Set-CsTrunkConfiguration qui définit la propriété SRTPMode de chacune sur Optional.
-------------------------- Exemple 4 ------------------------
Set-CsTrunkConfiguration -Identity site:Redmond -EnablePIDFLOSupport $True
L’exemple 4 modifie une configuration de tronçon comportant l’identité site:Redmond pour assurer la prise en charge PIDF-LO. Par défaut, le paramètre EnablePIDFLOSupport a la valeur False. Dans cet exemple, nous avons défini la valeur sur True à des fins de localisation pour les appels d’urgence. Vous devez définir EnablePIDFLOSupport sur True pour que les informations d’emplacement soient transmises au tronçon via l’application de routage externe.