Get-CsAdminRoleAssignment
Dernière rubrique modifiée : 2012-03-23
Retourne les rôles du contrôle d’accès basé sur les rôles (RBAC) affectés à l’utilisateur.
Syntaxe
Get-CsAdminRoleAssignment [-Identity] <String> [-LocalStore] [-Force] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
Description détaillée
Le contrôle RBAC permet aux administrateurs de déléguer le contrôle de tâches de gestion spécifiques à Microsoft Lync Server 2010. Par exemple, au lieu d’octroyer au personnel du support technique de l’organisation des privilèges d’administrateur complets, vous pouvez lui donner des droits très spécifiques : le droit de gérer uniquement des comptes d’utilisateurs, le droit de gérer uniquement des composants Enterprise Voice, et le droit de gérer uniquement l’archivage et le serveur d’archivage. De plus, l’étendue de ces droits peut être limitée : un utilisateur peut obtenir le droit de gérer Enterprise Voice, mais uniquement pour le site de Redmond pendant qu’un autre obtiendra le droit de gérer les comptes d’utilisateurs, mais uniquement les comptes de l’unité d’organisation (OU) Finance.
La cmdlet Get-CsAdminRoleAssignment vous fournit le moyen de récupérer une liste des rôles RBAC affectés à un 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 Get-CsAdminRoleAssignment : RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. 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-CsAdminRoleAssignment"}
Paramètres
Paramètre | Obligatoire | Type | Description |
---|---|---|---|
Identity |
Obligatoire |
Chaîne |
Le nom SamAccountName de l’utilisateur dont les rôles RBAC doivent être renvoyés. Vous pouvez récupérer le nom SamAccountName pour un utilisateur en utilisant une commande similaire à celle-ci : Get-CsUser "Ken Myer" | Select-Object SamAccountName Notez que vous devez utiliser le nom SamAccountName pour spécifier l’identité de l’utilisateur. Les autres valeurs communes utilisées pour spécifier les identités telles que le nom complet Active Directory ou l’adresse SIP de l’utilisateur ne fonctionneront pas avec Get-CsAdminRoleAssignment. |
Force |
Facultatif |
Paramètre de commutateur |
Supprime l’affichage de tous les messages d’erreur récupérable susceptibles d’apparaître lors de l’exécution de la commande. |
LocalStore |
Facultatif |
Paramètre de commutateur |
Extrait les données d’affectation de rôle RBAC du réplica local de la magasin central de gestion et non de la magasin central de gestion proprement dite. |
Types d’entrées
Chaîne. Get-CsAdminRoleAssignment accepte une valeur de chaîne redirigée représentant le SamAccountName d’un utilisateur.
Types de retours
Get-CsAdminRoleAssignment retourne les valeurs de chaîne représentant les rôles RBAC détenus par l’utilisateur spécifié.
Exemple
-------------------------- Exemple 1 --------------------------
Get-CsAdminRoleAssignment -Identity "kenmyer"
La commande illustrée à l’exemple 1 retourne tous les rôles RBAC affectés à l’utilisateur kenmyer.
-------------------------- Exemple 2 --------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Get-CsAdminRoleAssignment -Identity $_.SamAccountName}
La commande précédente retourne les rôles RBAC pour tous les utilisateurs autorisés à utiliser Lync Server 2010. Pour ce faire, la commande commence par appeler Get-CsUser sans aucun paramètre, qui entraîne ensuite le retour d’une collection de tous les utilisateurs dans l’organisation qui ont été activés pour Lync Server 2010 ou Office Communications Server. Ces données sont ensuite redirigées vers la cmdlet ForEach-Object qui interroge par écho chaque compte d’utilisateur dans la collection et qui : 1) affiche le nom complet de l’utilisateur à l’écran et, 2) utilise la cmdlet Get-CsAdminRoleAssignment pour retourner les rôles RBAC de l’utilisateur. Les informations du compte d’utilisateur doivent être redirigés vers ForEach-Object car Get-CsAdminRoleAssignment n’accepte pas directement les données redirigées.