Set-CsDialPlan
Dernière rubrique modifiée : 2012-03-27
Modifie un plan de numérotation existant.
Syntaxe
Set-CsDialPlan [-Identity <XdsIdentity>] [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Set-CsDialPlan [-City <String>] [-Confirm [<SwitchParameter>]] [-CountryCode <String>] [-Description <String>] [-DialinConferencingRegion <String>] [-ExternalAccessPrefix <String>] [-Force <SwitchParameter>] [-Instance <PSObject>] [-NormalizationRules <PSListModifier>] [-OptimizeDeviceDialing <$true | $false>] [-SimpleName <String>] [-State <String>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Cette cmdlet modifie un plan de numérotation existant (également appelé profil d’emplacement). Les plans de numérotation fournissent les informations requises qui permettent aux utilisateurs Enterprise Voice d’effectuer des appels téléphoniques. Les plans de numérotation sont aussi utilisés par l’application Intendant Conférence pour la conférence rendez-vous. Un plan de numérotation détermine les règles de normalisation appliquées et indique si un préfixe doit être composé pour les appels externes.
Remarque : si les règles de normalisation d’un plan de numérotation peuvent être modifiées avec cette cmdlet, il est néanmoins recommandé d’utiliser les cmdlets New-CsVoiceNormalizationRule, Set-CsVoiceNormalizationRule, ou Remove-CsVoiceNormalizationRule. Les changements apportés à l’aide de ces cmdlets seront répercutés dans le plan de numérotation correspondant.
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-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 "Set-CsDialPlan"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Facultatif |
Chaîne |
Identificateur unique qui désigne l’étendue, ou un nom pour les plans utilisateur, et qui permet d’identifier le plan de numérotation à modifier. Par exemple, une identité de site doit être au format site:<sitename>, où sitename est le nom du site. Un plan de numérotation au niveau de l’étendue Service sera un service Serveur d’inscriptions ou de passerelle PSTN pour lequel la valeur Identity se présentera comme suit : Registrar:Redmond.litwareinc.com. Une identité utilisateur sera une valeur de chaîne unique. |
Instance |
Facultatif |
LocationProfile |
Permet de transmettre une référence à un objet à la cmdlet plutôt que de définir des valeurs de paramètre individuelles. Vous pouvez extraire cet objet en appelant la cmdlet Get-CsDialPlan. |
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 au plan de numérotation. Indiquez une valeur pour ce paramètre si le plan de numérotation doit être utilisé pour une conférence rendez-vous. Ainsi, le numéro d’accès correct est attribué lorsque l’organisateur met en place la conférence. Les régions disponibles peuvent être extraites en appelant la cmdlet Get-CsNetworkRegion. Nombre maximal de caractères : 512 |
ExternalAccessPrefix |
Facultatif |
Chaîne |
Numéro (ou ensemble de numéros) qui indique qu’il s’agit d’un appel externe à l’organisation. (Par exemple, pour appeler un numéro externe, composer d’abord le 9.) Les règles de normalisation ignorent le préfixe, même si elles sont appliquées au reste du numéro. Vous devez affecter la valeur True au paramètre OptimizeDeviceDialing pour que cette valeur soit appliquée. La valeur de ce paramètre doit correspondre à l’expression régulière [0-9]{1,4}. Cela implique qu’il doit avoir une valeur comprise entre 0 et 9 comportant quatre chiffres. |
NormalizationRules |
Facultatif |
Modificateur de liste PS |
Liste des règles de normalisation appliquées au plan de numérotation. Bien que vous puissiez modifier cette liste et ces règles 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é, puis de les modifier au moyen de la cmdlet Set-CsVoiceNormalizationRule. |
OptimizeDeviceDialing |
Facultatif |
Booléen |
Si vous définissez ce paramètre sur True, vous appliquez le préfixe au paramètre ExternalAccessPrefix pour les appels passés à l’extérieur de l’organisation. La valeur True n’est possible que si une valeur a été précisée pour le paramètre ExternalAccessPrefix. |
SimpleName |
Facultatif |
Chaîne |
Nom convivial du plan de numérotation. Le nom du plan de numérotation doit être unique dans le déploiement Microsoft Lync Server 2010. Cette chaîne peut contenir jusqu’à 256 caractères. Vous pouvez utiliser des caractères alphabétiques ou numériques, le tiret (-), le point (.), le signe plus (+), le caractère de soulignement (_) et les parenthèses (()). |
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. |
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.Policy.Voice.LocationProfile. Accepte la saisie de données transmises via le pipeline pour les objets de plan de numérotation.
Types de retours
Set-CsDialPlan ne retourne aucune valeur ni aucun objet. Au lieu de cela, la cmdlet configure les instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Exemple
-------------------------- Exemple 1 --------------------------
Set-CsDialPlan -Identity RedmondDialPlan -Description "This plan is for Redmond-based users only."
Dans l’exemple 1, Set-CsDialPlan permet de modifier le plan de numérotation dont l’identité est Redmond. Dans ce cas, la seule propriété modifiée est Description. La modification s’effectue en spécifiant le paramètre Description, suivi du texte de la nouvelle description.
-------------------------- Exemple 2 --------------------------
Get-CsDialPlan | Set-CsDialPlan -ExternalAccessPrefix 8
Dans cet exemple, Set-CsDialPlan sert à changer la valeur de la propriété ExternalAccessPrefix de tous les plans de numérotation configurés pour être utilisés dans l’organisation. Pour ce faire, la commande utilise d’abord Get-CsDialPlan pour retourner la collection de tous les plans de numérotation de l’organisation. La collection est ensuite redirigée vers Set-CsDialPlan qui affecte la valeur 8 à la propriété ExternalAccessPrefix de chaque profil de la collection.