Partager via

  • Article

Grant-CsVoicePolicy

 

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

Affecte une stratégie de voix à un ou plusieurs utilisateurs ou groupes.

Syntaxe

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

Description détaillée

Cette cmdlet permet d’affecter une stratégie de voix utilisateur à un utilisateur. Les stratégies de voix permettent de gérer les fonctions Enterprise Voice comme la sonnerie simultanée (possibilité d’avoir une deuxième sonnerie de téléphone chaque fois que quelqu’un appelle sur votre téléphone professionnel) et le transfert d’appel. Utilisez cette cmdlet pour affecter les paramètres qui activent et désactivent ces fonctionnalités pour un utilisateur en particulier.

Vous pouvez vérifier si un utilisateur a reçu une stratégie de voix utilisateur en appelant une commande au format suivant : Get-CsUser "<nom_utilisateur>" | Select-Object VoicePolicy. Par exemple :

Get-CsUser "Ken Myer" | Select-Object VoicePolicy.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

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 (UPN), 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 également 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 » renvoie tous les utilisateurs dont le nom de famille est Smith.

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

PolicyName

Facultatif

Chaîne

Nom (identité) de la stratégie de voix à affecter à l’utilisateur. (Notez que ceci inclut uniquement la partie du nom de l’identité. Les identités de stratégie utilisateur comprennent un préfixe de type « tag: » qui ne doit pas être inclus dans le nom de la stratégie.)

DomainController

Facultatif

FQDN

Permet de spécifier un contrôleur de domaine. Si aucun contrôleur de domaine n’est spécifié, le système utilisera le premier disponible.

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 par le pipeline, représentant l'identité du compte utilisateur auxquel la stratégie de voix est accordée.

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-CsVoicePolicy -Identity "Ken Myer" -PolicyName VoicePolicyRedmond

Cet exemple affecte la stratégie de voix avec l’identité VoicePolicyRedmond à l’utilisateur dont le nom complet est Ken Myer.

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

Get-CsUser -OU "ou=Finance,ou=North America,dc=litwareinc,dc=com" | Grant-CsVoicePolicy -PolicyName VoicePolicyRedmond

Dans cet exemple la stratégie de voix avec l'identité VoicePolicyRedmond est attribuée à tous les utilisateurs de l'unité d'organisation (OU) Finance : OU=Finance,OU=NorthAmerica,DC=litwareinc,DC=com. La première partie de la commande appelle la cmdlet Get-CsUser pour récupérer tous les utilisateurs activés pour Lync Server 2010 ou Office Communications Server à partir de l'unité d'organisation spécifiée. Cette collection d’utilisateurs est alors redirigée vers la cmdlet Grant-CsVoicePolicy qui affecte la stratégie VoicePolicyRedmond à chacun de ces utilisateurs.