Set-CsPstnGateway
Dernière rubrique modifiée : 2012-03-26
Modifie les propriétés d’une passerelle PSTN (réseau téléphonique commuté). Les passerelles PSTN facilitent le routage des appels entre les périphériques du réseau téléphonique commuté externe et les périphériques de votre réseau Enterprise Voice interne.
Syntaxe
Set-CsPstnGateway [-Identity <XdsGlobalRelativeIdentity>] [-AlternateByPassId <String>] [-Confirm [<SwitchParameter>]] [-Default <$true | $false>] [-Force <SwitchParameter>] [-GatewaySipClientTcpPort <Nullable>] [-GatewaySipClientTlsPort <Nullable>] [-MediationServer <String>] [-RepresentativeMediaIP <String>] [-Routable <$true | $false>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Les passerelles PSTN permettent aux utilisateurs Enterprise Voice d’effectuer et de recevoir des appels de personnes en provenance du réseau téléphonique commuté. Ces passerelles agissent comme un pont entre le serveur de médiation et le réseau téléphonique commuté.
Les passerelles PSTN sont généralement requises lorsque vous utilisez un système téléphonique TDM PBX (Time Division Multiplex Public Branch Exchange). Dans ce cas, vous devrez utiliser à la fois une passerelle STN et un serveur de médiation pour acheminer les appels Enterprise Voice vers le réseau téléphonique commuté. En revanche, si vous utilisez un système IP-PBX, vous pouvez créer une connexion SIP directe entre le PBX et le serveur de médiation, éliminant ainsi tout recours nécessaire à la passerelle PSTN.
Une fois vos passerelles PSTN installées et configurées, vous pouvez les gérer à l’aide de la cmdlet Set-CsPstnGateway.
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-CsPstnGateway : 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-CsPstnGateway"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identité du service de la passerelle PSTN à modifier. Par exemple : -Identity "PstnGateway:192.168.0.240". Notez que vous pouvez supprimer le préfixe « PstnGatewayServer: » pour spécifier une passerelle PSTN. Par exemple : -Identity "atl-cs-001.litwareinc.com". |
AlternateBypassId |
Facultatif |
GUID |
Identificateur global unique (GUID) représentant un autre ID de déviation. Ce dernier, automatiquement généré par Lync Server 2010, permet d’éliminer les appels « hairpin ». Selon la configuration de votre système, les appels « hairpin » ignorent automatiquement le serveur de médiation sans avoir à définir et associer des sous-réseaux individuels avec l’ensemble de vos sites et régions. Pour ce faire, vous devez activer la déviation de manière globale pour utiliser les sites et les régions de configuration réseau, puis activer la déviation sur la configuration de tronçon de votre passerelle PSTN. Un appel « hairpin » se produit quand un appel entrant sur le réseau téléphonique commuté est renvoyé vers ce réseau via un transfert d’appel ou une sonnerie simultanée. |
Default |
Facultatif |
Booléen |
Si la valeur est True, la passerelle gère les appels envoyés à partir d’Office Communications Server 2007 R2. Il ne peut y avoir qu’une passerelle par défaut dans la collection des passerelles gérées par un serveur de médiation unique. |
GatewaySipClientTcpPort |
Facultatif |
Entier |
Port d’écoute utilisé pour communiquer avec les serveurs de médiation via le protocole TCP (Transmission Control Protocol). La valeur par défaut est 5066. |
GatewaySipClientTlsPort |
Facultatif |
Entier |
Port d’écoute utilisé pour communiquer avec les serveurs de médiation via le protocole TLS (Transport Layer Security). La valeur par défaut est 5067. |
MediationServer |
Facultatif |
Chaîne |
Identité de service du serveur de médiation à associer à la passerelle PSTN. Par exemple : -MediationServer "MediationServer:atl-cs-001.litwareinc.com". |
RepresentativeMediaIP |
Facultatif |
Chaîne |
Adresse IP du processeur multimédia associé à la passerelle si l’emplacement du processeur est différent de l’adresse de signalisation. La déviation du trafic multimédia et le contrôle d’admission des appels dépendent de l’emplacement du processeur multimédia de la passerelle. Par défaut, il s’agit du même emplacement que l’adresse de signalisation. Si les deux emplacements diffèrent (avec, par exemple, un processeur multimédia sur un site distant et un composant homologue de signalisation sur le site central), alors RepresentativeMediaIP doit être configuré avec l’adresse IP du processeur multimédia. Si vous avez déployé plusieurs processeurs multimédia sur le même site avec chacun une adresse IP différente, vous pouvez utiliser ces adresses IP au moment de configurer la propriété RepresentativeMediaIP. |
Routable |
Facultatif |
Booléen |
Si la valeur est True, la passerelle peut être utilisée pour les itinéraires de routage du trafic sortant. |
Force |
Facultatif |
Chaîne |
Supprime les invites de confirmation ou les messages d’erreur récupérable qui peuvent s’afficher lors de l’exécution de la cmdlet. |
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. Get-CsPstnGateway n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Set-CsPstnGateway ne retourne ni objet ni valeur. Au lieu de cela, la cmdlet modifie les instances de l’objet Microsoft.Rtc.Management.Xds.DisplayPstnGateway.
Exemple
-------------------------- Exemple 1 ------------------------
Set-CsPstnGateway -Identity "PstnGateway:192.168.0.240" -Default $True
La commande présentée dans l’exemple 1 configure la passerelle PstnGateway:192.168.0.240 en tant que passerelle par défaut, ce qui signifie que la passerelle PstnGateway:192.168.0.240 peut servir à la gestion des appels en provenance d’Office Communications Server 2007 R2.
-------------------------- Exemple 2 ------------------------
Get-CsService -PstnGateway | ForEach-Object {Set-CsPstnGateway -Identity $_.Identity -Routable $True}
La commande ci-dessus configure toutes les passerelles PSTN dans l’organisation pour que chacune d’elle puisse être utilisée pour le routage du trafic sortant. Pour ce faire, la commande appelle d’abord la cmdlet Get-CsService et le paramètre PstnGateway pour retourner une collection de toutes les passerelles PSTN actuellement utilisées. Cette collection est ensuite redirigée vers la cmdlet ForEach-Object. ForEach-Object exécute la cmdlet Set-CsPstnGateway sur chaque passerelle de la collection, en modifiant la valeur de la propriété Routable de chacune d’elles sur True.