New-CsDialPlan
Dernière rubrique modifiée : 2012-03-27
Crée un nouveau plan de numérotation.
Syntaxe
New-CsDialPlan -Identity <XdsIdentity> [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-InMemory <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet crée un nouveau plan de numérotation (également appelé profil d’emplacement). Les plans de numérotation fournissent les informations obligatoires qui permettent aux utilisateurs Entreprise Voice de passer des appels téléphoniques. Les plans de numérotation sont aussi utilisés par l’application application Intendant Conférence dans le cadre de la conférence rendez-vous. Un plan de numérotation détermine les règles de normalisation à appliquer et indique si un préfixe doit être composé pour les appels externes.
La création d’un plan de numérotation crée automatiquement une règle de normalisation vocale par défaut. Les règles de normalisation peuvent être modifiées en appelant la cmdlet Set-CsVoiceNormalizationRule. De nouvelles règles de normalisation peuvent être ajoutées en appelant la cmdlet New-CsVoiceNormalizationRule.
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-CsDialPlan : 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-CsDialPlan"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
XdsIdentity |
Identificateur unique qui désigne l’étendue et le nom (site), le rôle de service et le nom de domaine complet, ou encore le nom (utilisateur) permettant d’identifier le plan de numérotation. Par exemple une identité de site doit être entrée au format site:<sitename>, où sitename est le nom du site. Un plan de numérotation au niveau de l’étendue Service doit être un service Serveur d’inscriptions ou un service de passerelle PSTN dont la valeur Identity a un format identique à celui-ci : Registrar:Redmond.litwareinc.com. L’identité utilisateur doit être saisie comme valeur de chaîne unique. |
Description |
Facultatif |
Chaîne |
Description du plan de numérotation : objet du plan, type d’utilisateur auquel il s’applique ou toute autre information permettant d’identifier l’objet du plan de numérotation. Nombre maximal de caractères : 512 |
DialinConferencingRegion |
Facultatif |
Chaîne |
Nom de la région associée à ce plan de numérotation. Spécifiez une valeur pour ce paramètre si le plan de numérotation doit être utilisé pour les conférences rendez-vous. Vous affectez ainsi le bon numéro d’accès quand l’organisateur de la conférence définit la conférence. Les régions disponibles peuvent être extraites en appelant la cmdlet Get-CsNetworkRegion. Nombre de caractères maximal : 512 |
ExternalAccessPrefix |
Facultatif |
Chaîne |
Numéro (ou ensemble de numéros) qui signalent qu’un appel est externe à l’organisation. (Par exemple, pour utiliser une ligne externe, composez d’abord le 9.) Ce préfixe sera ignoré par les règles de normalisation, même si ces règles s’appliquent au reste du numéro. Le paramètre OptimizeDeviceDialing doit être défini avec la valeur True pour que cette valeur soit effective. Ce paramètre doit correspondre à l’expression régulière [0-9]{1,4}. Cela signifie qu’il doit s’agir d’une valeur comprise entre 0 et 9 et composée d’un à quatre chiffres. Valeur par défaut : 9 |
NormalizationRules |
Facultatif |
Modificateur de liste PS |
Liste des règles de normalisation appliquées à ce plan de numérotation. 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 normalisation avec la cmdlet New-CsVoiceNormalizationRule, qui crée la règle et l’attribue au plan de numérotation spécifié. Chaque fois qu’un nouveau plan de numérotation est créé, une nouvelle règle de normalisation vocale aux paramètres par défaut est également créée pour ce site, service ou plan de numérotation par utilisateur. L’identité par défaut de la nouvelle normalisation vocale est l’identité du plan de numérotation suivi d’une barre oblique puis du nom Prefix All. Par exemple, site:Redmond/Prefix All. Valeur par défaut : {Description=;Pattern=^(\d11)$;Translation=+$1;Name=Prefix All;IsInternalExtension=False } Remarque : cet élément par défaut n’est qu’un espace réservé. Pour que le plan de numérotation soit utile, il faut soit modifier la règle de normalisation créée par le plan de numérotation soit créer une nouvelle règle pour le site, service ou utilisateur. Vous pouvez créer une nouvelle règle de normalisation en appelant la cmdlet New-CsVoiceNormalizationRule et modifier une règle de normalisation en appelant Set-CsVoiceNormalizationRule. |
OptimizeDeviceDialing |
Facultatif |
Booléen |
Si vous définissez ce paramètre sur True, le préfixe dans le paramètre ExternalAccessPrefix est appliqué aux appels externes à l’organisation. Cette valeur peut être définie sur True uniquement si une valeur a été spécifiée pour le paramètre ExternalAccessPrefix. Valeur par défaut : False |
SimpleName |
Facultatif |
Chaîne |
Nom complet du plan de numérotation. Ce nom de plan de numérotation doit être unique dans le déploiement Lync Server. Cette chaîne peut contenir jusqu’à 256 caractères. Les caractères valides sont les caractères alphabétiques ou numériques, le tiret (-), le point (.), le signe plus (+), le trait de soulignement (_) et les parenthèses (()). Ce paramètre doit contenir une valeur. Cependant, si vous ne fournissez pas de valeur pour l’appel de New-CsDialPlan, une valeur par défaut sera fournie. La valeur par défaut pour un plan de numérotation global est Prefix All. La valeur par défaut pou un plan de numérotation au niveau du site est le nom du site. La valeur par défaut d’un service est le nom du service (service d’inscriptions ou passerelle PSTN) suivie d’un tiret de soulignement, puis du nom complet de domaine du service (FQDN). Par exemple, Registrar_pool0.litwareinc.com. Le plan de numérotation utilisateur par défaut est l’identité du plan de numérotation. |
State |
Facultatif |
Chaîne |
Ce paramètre n’est pas utilisé avec cette cmdlet. |
City |
Facultatif |
Chaîne |
Ce paramètre n’est pas utilisé avec cette cmdlet. |
CountryCode |
Facultatif |
Chaîne |
Ce paramètre n’est pas utilisé avec cette cmdlet. |
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
Cette cmdlet crée un objet de type Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Exemple
-------------------------- Exemple 1 --------------------------
New-CsDialPlan -Identity RedmondDialPlan
La commande présentée dans l’exemple 1 crée un nouveau plan de numérotation dont l’identité est RedmondDialPlan. (L’absence d’étendue dans la valeur Identity indique qu’il s’agit d’une stratégie par utilisateur. Les plans de numérotation créés dans l’étendue Utilisateur peuvent être directement affectés aux utilisateurs et aux groupes.) Toutes les autres propriétés du plan de numérotation se verront attribuer les valeurs par défaut.
-------------------------- Exemple 2 --------------------------
New-CsDialPlan -Identity site:Redmond -SimpleName RedmondSiteDialPlan
New-CsVoiceNormalizationRule -Identity "site:Redmond/SeattlePrefix" -Pattern "^9(\d*){1,5}$" -Translation "+1206$1"
Les commandes indiquées dans l’exemple 2 créent un nouveau plan de numérotation avec l’identité site:Redmond (ce qui signifie que le plan de numérotation s’applique à tous les utilisateurs du site Redmond à qui aucun plan de numérotation par utilisateur ou niveau du service n’a été assigné), ainsi que la valeur SimpleName RedmondSiteDialPlan. La ligne suivante dans l’exemple crée ensuite une règle de normalisation associée à ce plan. La règle de normalisation par défaut d’un plan de numérotation est généralement créée comme espace réservé. Les valeurs ont une utilisation limitée. Par conséquent, une fois que vous avez appelé la cmdlet New-CsDialPlan pour créer un nouveau plan de numérotation, vous devez appeler New-CsVoiceNormalizationRule afin de créer une règle nommée qui fonctionne pour votre organisation. La ligne 2 de cet exemple sert justement à cela : elle appelle New-CsVoiceNormalizationRule et crée une règle pour le site Redmond dont le nom est SeattlePrefix et qui spécifie les propriété Pattern et Translation de la règle. Aucune étape supplémentaire n’est nécessaire pour modifier le plan de numérotation : les modifications apportées à la règle de normalisation sont appliquées automatiquement au plan de numérotation dont l’identité correspond à celle de la règle de normalisation. (La partie site:Redmond de l’identité correspond à l’identité du plan de numérotation. SeattlePrefix est le nom de la règle de normalisation. Plusieurs règles de normalisation peuvent être appliquées à un plan de numération. Par conséquent, chaque règle de normalisation doit disposer d’un nom unique dans une étendue donnée.)
-------------------------- Exemple 3 --------------------------
New-CsDialPlan -Identity RedmondDialPlan -Description "Dial plan for Redmond users"
La commande indiquée à l’exemple 3 crée un nouveau plan de numérotation avec l’identité RedmondDialPlan et spécifie une description pour expliquer à quoi sert le plan de numérotation. (Les plans de numérotation créés dans l’étendue par utilisateur peuvent être directement affectés aux utilisateurs et aux groupes.) Les valeurs par défaut seront attribuées à tous les autres paramètres.