Get-CsDialPlan
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les plans de numérotation utilisés au sein de votre organisation.
Syntaxe
Get-CsDialPlan [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsDialPlan [-Filter <String>] [-LocalStore <SwitchParameter>]
Description détaillée
Cette cmdlet retourne des informations sur un ou plusieurs plans de numérotation (appelés également « profils d’emplacement ») employés dans une organisation. 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 les conférences 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 : vous pouvez utiliser la cmdlet Get-CsDialPlan pour extraire des informations spécifiques sur les règles de normalisation d’un plan de numérotation mais s’il s’agit des seules informations dont vous avez besoin, le recours à la cmdlet Get-CsVoiceNormalizationRule est également possible.
Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Get-CsDialPlan : RTCUniversalUserAdmins, 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 "Get-CsDialPlan"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identificateur unique qui désigne l’étendue, et pour l’étendue Utilisateur, un nom afin d’identifier le plan de numérotation à extraire. |
Filter |
Facultatif |
Chaîne |
Effectue une recherche par caractères génériques qui vous permet de limiter uniquement vos résultats aux plans de numérotation dont les identités correspondent à la chaîne avec caractères génériques concernée. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les informations des plans de numérotation à partir du réplica local du magasin central de gestion et non du magasin central de gestion proprement dit. |
Types d’entrées
Aucun.
Types de retours
Cette cmdlet retourne des instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.Voice.LocationProfile.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsDialPlan
L’exemple 1 retourne une collection de tous les plans de numérotation configurés à des fins d’utilisation dans votre organisation. Pour cela, il appelle la cmdlet Get-CsDialPlan sans aucun paramètre supplémentaire.
-------------------------- Exemple 2 --------------------------
Get-CsDialPlan -Identity RedmondDialPlan
Dans l’exemple 2, le paramètre Identity est utilisé pour restreindre les données récupérées aux plans de numérotation qui comportent un plan de numérotation utilisateur avec RedmondDialPlan pour identité. Tenant compte du caractère unique des identités, cette commande retourne uniquement le plan de numérotation spécifié.
-------------------------- Exemple 3 --------------------------
Get-CsDialPlan -Identity site:Redmond
L’exemple 3 est identique à l’exemple 2 sauf qu’un plan de numération attribué à un site est récupéré au lieu d’un plan de numérotation utilisateur. Il suffit pour cela de spécifier la valeur « site: » suivie du nom du site à extraire (dans ce cas Redmond).
-------------------------- Exemple 4 --------------------------
Get-CsDialPlan -Filter tag:*
Cet exemple utilise le paramètre Filter pour retourner une collection de tous les plans de numérotation qui ont été configurés au niveau de l’étendue Utilisateur. (Les paramètres configurés au niveau de l’étendue Utilisateur, ou de l’étendue « tag », peuvent être directement affectés aux utilisateurs et aux groupes.) La chaîne « tag:* » dotée d’un caractère générique demande à la cmdlet de retourner uniquement les plans de numérotation dont l’identité commence par la valeur de chaîne « tag: » qui identifie un plan de numérotation au niveau de l’étendue Utilisateur.
-------------------------- Exemple 5 --------------------------
Get-CsDialPlan | Select-Object -ExpandProperty NormalizationRules
Cet exemple affiche les règles de normalisation utilisées par les plans de numérotation que vous avez configurés en vue d’une utilisation au sein de votre organisation. La propriété NormalizationRules étant composée d’un groupe d’objets, l’ensemble complet des règles de normalisation ne s’affiche généralement pas à l’écran. Pour afficher l’ensemble de ces règles, cette commande fournie à titre d’exemple utilise la cmdlet Get-CsDialPlan pour extraire une collection de tous les plans de numérotation. Cette collection est ensuite redirigée vers la cmdlet Select-Object ; le paramètre ExpandProperty de la cmdlet Select-Object est alors utilisé pour développer les valeurs détectées dans la propriété NormalizationRules. Le fait de développer les valeurs signifie que toutes les règles de normalisation s’afficheront une par une à l’écran. Le même résultat aurait été obtenu en appelant la cmdlet Get-CsVoiceNormalizationRule.
-------------------------- Exemple 6 --------------------------
Get-CsDialPlan | Where-Object {$_.Description -match "Redmond"}
Dans l’exemple 6, les cmdlets Get-CsDialPlan et Where-Object sont utilisées pour extraire tous les plans de numérotation dont la description contient le terme Redmond. Pour y parvenir, la commande utilise d’abord la cmdlet Get-CsDialPlan pour extraire tous les plans de numérotation. Cette collection est ensuite redirigée vers la cmdlet Where-Object qui applique un filtre limitant les données retournées aux profils dont la description contient le terme Redmond.
Voir aussi
Autres ressources
New-CsDialPlan
Remove-CsDialPlan
Set-CsDialPlan
Grant-CsDialPlan
Test-CsDialPlan
Get-CsVoiceNormalizationRule