Partager via

  • Article

Grant-CsDialPlan

 

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

Affecte un plan de numérotation à un ou plusieurs utilisateurs ou groupes.

Syntaxe

Grant-CsDialPlan -Identity <UserIdParameter> [-PolicyName <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Cette cmdlet permet d’affecter un plan de numérotation spécifique à l’utilisateur. Les plans de numérotation fournissent les informations requises qui permettent aux utilisateurs Enterprise Voice d’effectuer des appels téléphoniques. Les utilisateurs qui n’ont pas de plan de numérotation valide ne seront pas autorisés à passer des appels à l’aide d’Enterprise Voice. Un plan de numérotation décide de l’application des règles de normalisation et décide si un préfixe doit être composé pour les appels externes.

Vous pouvez vérifier si un utilisateur a reçu une plan de numérotation spécifique en appelant une commande au format suivant : Get-CsUser "<user name>" | Select-Object DialPlan. Par exemple :

Get-CsUser "Ken Myer" | Select-Object DialPlan

Personnes autorisées à exécuter cette cmdlet : Par défaut, les membres des groupes qui suivent sont autorisés à exécuter localement la cmdlet Grant-CsDialPlan : RTCUniversalUserAdmins. 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 "Grant-CsDialPlan"}

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

L’identité (identificateur unique) de l’utilisateur auquel la stratégie est affectée.

Les identités utilisateur peuvent être spécifiées dans l’un des quatre formats suivants : 1) L’adresse SIP de l’utilisateur ; 2) Le nom d’utilisateur principal de l’utilisateur ; 3) Le nom de domaine et le nom d’ouverture de session de l’utilisateur, sous la forme domaine\ouverture de session (par exemple, litwareinc\kenmyer) ; et 4) Le nom complet Active Directory de l’utilisateur (par exemple, Ken Myer).

Notez que vous pouvez recourir à l’astérisque (caractère générique *) si vous utilisez le nom complet comme identité utilisateur. Par exemple, l’identité « * Smith » retourne tous les utilisateurs dont le nom de famille est Smith.

Type de données complet : Microsoft.Rtc.Management.AD.UserIdParameter

PolicyName

Facultatif

Chaîne

La valeur d’identité du plan de numérotation à affecter à l’utilisateur. (Notez que ceci inclut uniquement la partie du nom de l’identité. Les identités des plans de numérotation spécifiques à l’utilisateur comprennent un préfixe de type « tag: » qui ne doit pas être inclus dans PolicyName.)

DomainController

Facultatif

FQDN

Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, c’est le premier contrôleur disponible qui sera utilisé.

PassThru

Facultatif

Paramètre de commutateur

Retourne les résultats de la commande. Par défaut, cette cmdlet ne génère aucune sortie.

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

Chaîne. Accepte une valeur de chaîne transmise via le pipeline représentant l’identité d’un compte d’utilisateur auquel le plan de numérotation est accordé.

Types de retours

Utilisée avec le paramètre PassThru, retourne un objet de type Microsoft.Rtc.Management.ADConnect.Schema.OCSADUserOrAppContact.

Exemple

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

Grant-CsDialPlan -Identity "Ken Myer" -PolicyName RedmondDialPlan

Dans l’exemple illustré ci-dessus, Grant-CsDialPlan affecte le plan de numérotation RedmondDialPlan à l’utilisateur dont l’identité (dans ce cas, le nom complet) est Ken Myer.

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

Get-CsUser -LDAPFilter "l=Redmond" | Grant-CsDialPlan -PolicyName RedmondDialPlan

Dans l’exemple 2, le plan de numérotation RedmondDialPlan est assigné à tous les utilisateurs qui disposent de bureaux dans la ville de Redmond. Pour ce faire, la cmdlet Get-CsUser est appelée afin de récupérer une collection de tous les utilisateurs qui disposent de bureaux dans la ville de Redmond. Cela est possible à l’aide du paramètre LDAPFilter et de la requête LDAP l=Redmond. (Dans le langage de requête LDAP utilisé par services de domaine Active Directory (AD DS), le l indique la localité ou la ville de l’utilisateur.) La collection est ensuite redirigée vers Grant-CsDialPlan qui affecte à chaque utilisateur de la collection le plan de numérotation Redmond.