Get-CsPinPolicy
Dernière rubrique modifiée : 2012-03-23
Retourne des informations sur les stratégies d’authentification par code confidentiel des clients configurées pour être utilisées dans votre organisation. L’authentification par code confidentiel permet aux utilisateurs d’accéder à Microsoft Lync Server 2010 en fournissant un code confidentiel au lieu d’un nom d’utilisateur et d’un mot de passe.
Syntaxe
Get-CsPinPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPinPolicy [-Filter <String>] [-LocalStore <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. En règle générale, l’utilisateur doit saisir un nom d’utilisateur ou un mot de passe pour se connecter au système ou participer à une conférence. Malheureusement, cette opération peut poser problème si vous utilisez un téléphone non équipé d’un 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.
Lync Server utilise des stratégies de code confidentiel pour gérer les propriétés d’authentification par code confidentiel. Par exemple, vous pouvez spécifier la longueur minimale d’un code confidentiel et indiquer si vous autorisez les codes confidentiels qui appliquent des « modèles communs » tels que des chiffres consécutifs (par exemple, un code confidentiel de type 123456). Vous pouvez utiliser la cmdlet Get-CsPinPolicy pour extraire des informations sur les stratégies de code confidentiel actuellement configurées pour être utilisées dans votre organisation.
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-CsPinPolicy : 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-CsPinPolicy"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Facultatif |
XdsIdentity |
Identité unique attribuée à la stratégie lors de sa création. Vous pouvez affecter des stratégies de code confidentiel dans l’étendue globale, Site ou utilisateur. Pour spécifier l’instance globale, utilisez la syntaxe suivante : -Identity global. Pour renvoyer à une stratégie dans l’étendue Site, utilisez la syntaxe suivante : -Identity site:Redmond. Pour faire référence à une stratégie au niveau de l’étendue Utilisateur, utilisez une syntaxe de type : -Identity RedmondPolicy. Les caractères génériques tels que l’astérisque (*) ne peuvent pas être utilisés avec le paramètre Identity. Pour effectuer une recherche par caractères génériques pour les stratégies, utilisez le paramètre Filter. Si ni le paramètre Identity ni le paramètre Filter n’est spécifié, Get-CsPinPolicy renvoie des informations sur toutes les stratégies de code confidentiel configurées pour être utilisées dans votre organisation. |
Filter |
Facultatif |
Chaîne |
Vous permet de rechercher des stratégies de code confidentiel à l’aide de caractères génériques. Par exemple, pour rechercher toutes les stratégies configurées au niveau de l’étendue Site, utilisez ce filtre : site:*. Pour rechercher les stratégies définies pour les sites de Seattle, Séville et Saskatoon (qui commencent tous par la lettre « S »), utilisez ce filtre : site:S*. Notez que ce paramètre ne peut filtrer que la propriété Identity. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Récupère les données de stratégie de code confidentiel depuis la réplique locale du magasin central de gestion plutôt que depuis le magasin central de gestion lui-même. |
Types d’entrées
Aucun. Get-CsPinPolicy n’accepte pas la saisie de données transmises via le pipeline.
Types de retours
Get-CsPinPolicy renvoie une ou plusieurs instances de l’objet Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPinPolicy.
Exemple
-------------------------- Exemple 1 ------------------------
Get-CsPinPolicy
La commande illustrée dans l’exemple 1 renvoie un ensemble de toutes les stratégies de code confidentiel configurées pour être utilisées dans l’organisation. L’appel de la cmdlet Get-CsPinPolicy sans aucun paramètre entraîne le renvoi de l’ensemble complet de stratégies de code confidentiel.
-------------------------- Exemple 2 ------------------------
Get-CsPinPolicy -Identity "site:Redmond"
Dans l’exemple 2, une seule stratégie de code confidentiel est renvoyée : celle comportant l’identité site:Redmond.
-------------------------- Exemple 3 ------------------------
Get-CsPinPolicy -Filter "tag:*"
La commande illustrée dans l’exemple 3 utilise le paramètre Filter pour renvoyer toutes les stratégies ayant été configurées dans l’étendue utilisateur. Cette opération est effectuée avec la valeur de filtre « tag:* ». Cette dernière indique à Get-CsPinPolicy que seules les stratégies dont l’identité commence par les caractères « tag: » doivent être renvoyées.
-------------------------- Exemple 4 ------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True}
L’example 4 renvoie toutes les stratégies de code confidentiel pour lesquelles la propriété AllowCommonPatterns est égale à True. Dans cet exemple, la cmdlet Get-CsPinPolicy est d’abord appelée sans aucun paramètre supplémentaire. Elle renvoie un ensemble de toutes les stratégies de code confidentiel configurées pour être utilisées dans l’organisation. Cet ensemble est ensuite redirigé vers la cmdlet Where-Object, qui sélectionne uniquement les stratégies dont la propriété AllowCommonPatterns est égale à True.
-------------------------- Exemple 5 ------------------------
Get-CsPinPolicy | Where-Object {$_.PinLifetime -gt 30}
Comme dans l’exemple 4, la commande présentée dans l’exemple 5 utilise la cmdlet Where-Object pour renvoyer un sous-ensemble des stratégies de code confidentiel existantes. Dans ce cas, Where-Object n’extrait que les stratégies dont la propriété PinLifetime est supérieure à 30. Autrement dit, seules les stratégies dont le délai d’expiration du code confidentiel est supérieur à 30 jours seront renvoyées.