Get-CsClientPinInfo
Dernière rubrique modifiée : 2012-03-23
Récupère des informations sur le code confidentiel (PIN) affecté à un utilisateur.
Syntaxe
Get-CsClientPinInfo -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
Description détaillée
Lync Server 2010 permet aux utilisateurs de se connecter au système ou de prendre part à des conférences PSTN (réseau téléphonique commuté) par téléphone. Généralement, la connexion au système ou la participation à une conférence nécessite que l’utilisateur saisisse un nom d’utilisateur ou un mot de passe. Néanmoins, la saisie d’un nom d’utilisateur et d’un mot de passe peut constituer un problème si vous utilisez un téléphone qui ne comporte pas de clavier alphanumérique. De ce fait, Lync Server 2010 vous permet de fournir aux utilisateurs des codes confidentiels uniquement numériques ; à l’invite, les utilisateurs peuvent ainsi se connecter au système ou prendre part à une conférence en saisissant le code confidentiel à la place d’un nom d’utilisateur et d’un mot de passe.
Les administrateurs peuvent récupérer les paramètres de code confidentiel d’un utilisateur ou d’un groupe d’utilisateurs en exécutant la cmdlet Get-CsClientPinInfo. Notez qu’il est impossible pour un administrateur de récupérer le code confidentiel assigné à un utilisateur. Si un utilisateur oublie son code confidentiel, il ne pourra pas utiliser l’authentification par code confidentiel pour accéder au système, tout au moins tant que l’administrateur ne lui en aura pas attribué un nouveau ou que l’utilisateur n’en aura pas obtenu un à partir de la page Web de conférence rendez-vous.
Notez que, par défaut, les exceptions du pare-feu pour SQL Server Express ne sont pas activées quand vous installez l’édition standard de Lync Server 2010. Cela signifie que vous ne pourrez pas exécuter Get-CsClientPinInfo à partir d’une instance distante de Windows PowerShell, car votre commande ne pourra pas traverser le pare-feu pour accéder à la base de données SQL Server Express. (Vous pouvez toutefois exécuter la cmdlet en local sur le serveur Standard Edition.) Pour exécuter Get-CsClientPinInfo à distance sur serveur Standard Edition, vous devrez activer manuellement les exceptions du pare-feu pour SQL Server Express.
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-CsClientPinInfo : 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-CsClientPinInfo"}
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Paramètre UserId |
Indique l’identité du compte d’utilisateur dont le code confidentiel doit être verrouillé. 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). Vous pouvez également faire référence à un compte d’utilisateur en utilisant son nom unique Active Directory. 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 complet se termine par la valeur de chaîne « Smith ». |
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
Valeur de chaîne ou objet Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Get-CsClientPinInfo accepte la saisie de données transmises via le pipeline de valeurs de chaîne qui représentent l’identité d’un compte d’utilisateur. La cmdlet accepte également la saisie de données transmises via le pipeline pour les objets utilisateur.
Types de retours
Get-CsClientPinInfo renvoie une ou plusieurs instances de l’objet Microsoft.Rtc.Management.UserPinService.PinInfoDetails.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsUser | Get-CsClientPinInfo
La commande ci-dessus retourne les informations de code confidentiel de tous les utilisateurs activés pour Lync Server 2010. Pour ce faire, la commande appelle d’abord Get-CsUser pour retourner tous les utilisateurs Lync Server 2010. Cette collection est redirigée vers Get-CsClientPinInfo, qui affiche les informations de code confidentiel de chaque utilisateur de la collection.
-------------------------- Exemple 2 ------------------------
Get-CsClientPinInfo -Identity "litwareinc\kenmyer"
Dans l’exemple 2, Get-CsClientPinInfo permet d’afficher les informations de code confidentiel d’un utilisateur unique : celui dont l’identité est litwareinc\kenmyer.
-------------------------- Exemple 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Get-CsClientPinInfo
L’exemple 3 renvoie des informations sur les codes confidentiels de tous les utilisateurs possédant des comptes dans l’unité d’organisation Finance. Pour ce faire, Get-CsUser et le paramètre OU sont utilisés afin de retourner une collection de tous les utilisateurs de l’unité d’organisation Finance. Cette collection est redirigée vers Get-CsClientPinInfo, qui affiche les informations de code confidentiel de chaque utilisateur de la collection.
-------------------------- Exemple 4 ------------------------
Get-CsUser -LdapFilter "Title=Manager" | Get-CsClientPinInfo
La commande illustrée dans l’exemple 4 affiche les informations de code confidentiel de tous les responsables de l’organisation. Pour récupérer une collection de l’ensemble des responsables, la commande utilise Get-CsUser et le paramètre LdapFilter. La valeur de filtre « Title=Manager » limite la collection retournée aux utilisateurs dont la fonction indique « Manager ». Get-CsClientPinInfo est alors utilisé pour afficher les informations sur les codes confidentiels de chacun de ces utilisateurs.