Partager via

  • Article

New-CsVoiceRoute

 

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

Crée un nouvel itinéraire de communications vocales. Les itinéraires de communications vocales contiennent des instructions qui indiquent à Microsoft Lync Server 2010 comment acheminer les appels des utilisateurs Enterprise Voice vers des numéros de téléphone du réseau téléphonique commuté (PSTN) ou d’un autocommutateur privé (PBX).

Syntaxe

New-CsVoiceRoute -Identity <XdsGlobalRelativeIdentity> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

New-CsVoiceRoute -Name <String> [-AlternateCallerId <String>] [-Confirm [<SwitchParameter>]] [-Description <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NumberPattern <String>] [-Priority <Int32>] [-PstnGatewayList <PSListModifier>] [-PstnUsages <PSListModifier>] [-SuppressCallerId <Nullable>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette cmdlet vous permet de créer un nouvel itinéraire de communications vocales. Tous les itinéraires de communications vocales sont créés dans l’étendue globale. Toutefois, il est possible de définir plusieurs itinéraires de communications vocales globaux. Cette opération est effectuée via le paramètre Identity, qui requiert un nom d’itinéraire unique.

Les itinéraires de communications vocales sont associés à des stratégies de voix par le biais d’utilisations PSTN. Un itinéraire de communications vocales inclut une expression régulière identifiant les numéros de téléphone qui seront acheminés via un itinéraire donné : les numéros de téléphone qui correspondent à l’expression régulière seront acheminés via cet itinéraire.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

XdsIdentity

Nom qui identifie de façon unique l’itinéraire de communications vocales. Les itinéraires de communications vocales peuvent être uniquement définis dans l’étendue globale. Par conséquent, l’identité est simplement le nom que vous souhaitez attribuer à l’itinéraire (le nom de l’itinéraire peut comporter des espaces (par exemple, Itinéraire de test). Toutefois, vous devez mettre la chaîne complète entre guillemets lors de l’appel de New-CsVoiceRoute).

Si l’identité est spécifiée, le champ Nom doit rester vide. La valeur de l’identité sera attribuée au nom.

Name

Obligatoire

Chaîne

Nom unique de l’itinéraire de communications vocales. Si ce paramètre est défini, la valeur sera automatiquement appliquée à l’identité de l’itinéraire de communications vocales. Vous ne pouvez pas spécifier une identité et un nom à la fois.

AlternateCallerId

Facultatif

Chaîne

Si le paramètre SuppressCallerId est défini sur True, les destinataires voient apparaître la valeur du paramètre AlternateCallerId au lieu du numéro réel de l’appelant. Ce numéro doit être valide et peut être utilisé pour représenter une division d’une organisation, telle que Support technique ou Ressources humaines.

Si le paramètre SuppressCallerId est défini sur False, le paramètre AlternateCallerId est ignoré.

Cette valeur doit correspondre à l’expression régulière (\+)?[1-9]\d*(;ext=[1-9]\d*)?. En d’autres termes, la valeur peut commencer par un signe plus (+), mais cela n’est pas obligatoire, contenir tous les chiffres que vous désirez et être suivie d’un numéro de poste commençant par ;ext= et de tous les chiffres désirés (notez que si vous incluez un numéro de poste, la chaîne doit être placée entre guillemets).

Description

Facultatif

Chaîne

Description de la fonction de cet itinéraire de communications vocales.

NumberPattern

Facultatif

Chaîne

Expression régulière qui spécifie les numéros de téléphone auxquels cet itinéraire s’applique. Les numéros correspondant à ce modèle seront acheminés en fonction des autres paramètres de routage.

Valeur par défaut : [0-9]{10}

Priority

Facultatif

Int32

Numéro pouvant être résolu en plusieurs itinéraires de communications vocales. La priorité détermine l’ordre dans lequel les itinéraires de communications vocales seront appliqués si plusieurs itinéraires sont possibles.

PstnGatewayList

Facultatif

Modificateur de liste PS

Dans Lync Server 2010, un serveur de médiation peut être associé à plusieurs passerelles. Ce paramètre contient une liste des passerelles associées à cet itinéraire de communications vocales. Chaque membre de cette liste doit être l’identité de service de la passerelle PSTN ou du serveur de médiation. La valeur peut faire référence à un serveur de médiation uniquement si le serveur de médiation est configuré pour Microsoft Office Communications Server 2007 ou Microsoft Office Communications Server 2007 R2. Pour Lync Server 2010, une passerelle PSTN doit être utilisée. L’identité de service est une chaîne au format <ServiceRole>:<FQDN> où ServiceRole désigne le nom du rôle de service (PSTNGateway) et FQDN correspond au nom de domaine complet (FQDN) du pool ou à l’adresse IP du serveur (par exemple, PSTNGateway:redmondpool.litwareinc.com). Vous pouvez extraire des identités de service en appelant la commande Get-CsService | Select-Object Identity.

Par défaut, cette liste est vide. Cependant, si vous ne spécifiez pas ce paramètre lors de la création d’un nouvel itinéraire de communications vocales, un message d’avertissement s’affiche.

PstnUsages

Facultatif

Modificateur de liste PS

Liste des utilisations PSTN (telles que Local ou Long Distance) pouvant être appliquées à cet itinéraire de communications vocales. L’utilisation PSTN doit préalablement exister (vous pouvez extraire des utilisations PSTN en appelant la cmdlet Get-CsPstnUsage).

Par défaut, cette liste est vide. Cependant, si vous ne spécifiez pas ce paramètre lors de la création d’un nouvel itinéraire de communications vocales, un message d’avertissement s’affiche.

SuppressCallerId

Facultatif

Booléen

Détermine si l’ID d’un appelant sera affiché pour les appels sortants. Si ce paramètre est défini sur True, l’ID d’appelant sera supprimé. La valeur du paramètre AlternateCallerId s’affichera à la place de l’ID. Lorsque le paramètre SuppressCallerId est défini sur True, une valeur doit être saisie pour AlternateCallerId.

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

Chaîne

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.Policy.Voice.Route.

Exemple

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

New-CsVoiceRoute -Identity Route1

Dans cet exemple, la commande crée un nouvel itinéraire de communications vocales comportant l’identité Route1. Toutes les autres propriétés seront définies sur les valeurs par défaut.

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

New-CsVoiceRoute -Identity Route1 -PstnUsages @{add="Long Distance"} -PstnGatewayList @{add="PstnGateway:redmondpool.litwareinc.com"}

Dans cet exemple, la commande crée un nouvel itinéraire de communications vocales comportant l’identité Route1. Elle ajoute également l’utilisation PSTN Long Distance (Longue distance) à la liste des utilisations et l'ID de service PstnGateway:redmondpool.litwareinc.com à la liste des passerelles PSTN.

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

$x = (Get-CsPstnUsage).Usage
New-CsVoiceRoute -Identity Route1 -PstnUsages @{add=$x}

Cet exemple explique comment créer un nouvel itinéraire de communications vocales appelé Route1 et renseigner la liste des utilisations PSTN de cet itinéraire avec toutes les utilisations existantes de l’organisation. La première commande de cet exemple extrait la liste d’utilisations RTC globales. Notez que l’appel de Get-CsPstnUsage est mis entre parenthèses ; cela signifie que nous extrayons d’abord un objet contenant des informations sur les utilisations PSTN (puisqu’il n’existe qu’une seule utilisation PSTN [globale], un seul objet sera extrait). La commande extrait ensuite la propriété Usage de cet objet. Cette propriété, qui contient une liste d’utilisations, est affectée à la variable $x. Sur la deuxième ligne de cet exemple, la cmdlet New-CsVoiceRoute est appelée pour créer un nouvel itinéraire de communications vocales. Cet itinéraire aura l’identité Route1. Notez la valeur transmise au paramètre PstnUsages : @{add=$x}. Cette valeur permet d’ajouter le contenu de $x, qui contient la liste d’utilisations téléphoniques extraite sur la ligne 1 à la liste d’utilisations PSTN de cet itinéraire.