Partager via

  • Article

Grant-CsHostedVoicemailPolicy

 

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

Affecte une stratégie de messagerie vocale hébergée au niveau de l’étendue Utilisateur. L’étendue Utilisateur vous permet d’affecter des stratégies à des groupes ou des utilisateurs individuels.

Syntaxe

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

Description détaillée

Cette cmdlet affecte une stratégie de messagerie vocale hébergée existante à un utilisateur en particulier. Une stratégie de messagerie vocale hébergée spécifie le mode de routage des appels sans réponse adressés à un utilisateur vers un service de messagerie unifiée Exchange hébergé.

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

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

Si vous affectez une stratégie de messagerie vocale hébergée qui ne précise aucune destination à un utilisateur, vous ne pouvez pas activer le service de messagerie vocale hébergée pour cet utilisateur.

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

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Paramètre ID utilisateur

Identité (identificateur unique) de l’utilisateur auquel la stratégie de messagerie vocale hébergée 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 d’affichage 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 messagerie vocale hébergée à affecter à l’utilisateur. (Notez que ceci inclut uniquement la partie du nom de l’identité. Les identités de stratégie utilisateur de messagerie vocale hébergée 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 via le pipeline représentant l’identité d’un compte d’utilisateur auquel la stratégie de messagerie vocale hébergée est affecté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-CsHostedVoicemailPolicy -Identity "Ken Myer" -PolicyName ExRedmond

Cet exemple affecte la stratégie de messagerie vocale hébergée avec l’identité ExRedmond à l’utilisateur dont le nom complet est Ken Myer.

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

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

Cet exemple affecte la stratégie de messagerie vocale hébergée avec l’identité ExRedmond à 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-CsHostedVoicemailPolicy qui affecte la stratégie ExRedmond à chacun de ces utilisateurs.