Get-CsAdminRoleAssignment
Última modificación del tema: 2012-03-23
Devuelve los roles de control de acceso basado en roles (RBAC) asignados a un usuario.
Sintaxis
Get-CsAdminRoleAssignment [-Identity] <String> [-LocalStore] [-Force] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
Descripción detallada
El control de acceso basado en roles (RBAC) hace posible que los administradores deleguen el control de determinadas tareas de administración de Microsoft Lync Server 2010. Por ejemplo, en lugar de conceder todos los privilegios de administrador al personal de asistencia técnica de la organización, puede conceder derechos específicos a estos empleados: el derecho a administrar únicamente cuentas de usuario, el derecho a administrar únicamente componentes de Enterprise Voice y el derecho a administrar únicamente las tareas de archivado el Servidor de archivado. Además, es posible limitar estos derechos a un ámbito: se puede dar a un usuario los derechos para administrar Enterprise Voice, pero solo en la ubicación de Redmond, mientras que otro puede recibir derechos para administrar cuentas de usuario, si bien únicamente en las cuentas de la unidad organizativa de finanzas.
El cmdlet Get-CsAdminRoleAssignment proporciona un método para recuperar una lista de los roles RBAC que se han asignado a un usuario.
Quién puede ejecutar este cmdlet: de forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Get-CsAdminRoleAssignment localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins, RTCUniversalReadOnlyAdmins. Para obtener una lista de todos los roles RBAC a los que este cmdlet se ha asignado (incluido cualquier otro rol RBAC personalizado que haya creado), ejecute el siguiente comando desde el símbolo del sistema de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdminRoleAssignment"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Cadena de caracteres |
SamAccountName del usuario cuyo rol RBAC ha de devolverse. Puede recuperar SamAccountName de un usuario usando un comando similar al siguiente: Get-CsUser "Ken Myer" | Select-Object SamAccountName Tenga en cuenta que debe usar SamAccountName cuando especifica la Identidad del usuario. Otros valores comunes usados al especificar identidades (como el nombre para mostrar de Active Directory o la dirección SIP del usuario) no funcionarán con Get-CsAdminRoleAssignment. |
Force |
Opcional |
Parámetro modificador |
Suprime la visualización de los mensajes de error que no son graves y que pueden surgir al ejecutar el comando. |
LocalStore |
Opcional |
Parámetro modificador |
Recupera los datos de asignación de rol RBAC a partir de una réplica local de Almacén de administración central en lugar de hacerlo directamente desde Almacén de administración central. |
Tipos de entrada
Cadena de caracteres. Get-CsAdminRoleAssignment acepta un valor de cadena transferido que represente el parámetro SamAccountName de un usuario.
Tipos de valores devueltos
Get-CsAdminRoleAssignment devuelve los valores de cadena que representan los roles RBAC detentados por el usuario específico.
Ejemplo
-------------------------- Ejemplo 1 ------------------------
Get-CsAdminRoleAssignment -Identity "kenmyer"
El comando que se muestra en el ejemplo 1 devuelve todos los roles RBAC asignados al usuario kenmyer.
-------------------------- Ejemplo 2 ------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Get-CsAdminRoleAssignment -Identity $_.SamAccountName}
El comando anterior devuelve los roles RBAC para todos los usuarios habilitados en Lync Server 2010. Para ello, en primer lugar el comando llama a Get-CsUser sin ningún parámetro; esto devuelve una colección de todos los usuarios de una organización habilitados para Lync Server 2010 o Office Communications Server. Estos datos se transfieren al cmdlet ForEach-Object, que pasa en bucle por cada cuenta de usuario en la colección y realiza lo siguiente: 1) trasmite el nombre para mostrar de usuario a la pantalla, y 2) usa el cmdlet Get-CsAdminRoleAssignment para devolver los roles de RBAC de usuario. La información de cuenta de usuario debe transmitirse a ForEach-Object porque Get-CsAdminRoleAssignment no acepta la transmisión directa de datos.