Get-CsAdminRoleAssignment
Tópico modificado em: 2012-03-23
Retorna as funções do controle de acesso baseado em função (RBAC) atribuídas a um usuário.
Sintaxe
Get-CsAdminRoleAssignment [-Identity] <String> [-LocalStore] [-Force] [-Verbose] [-Debug] [-ErrorAction <ActionPreference>] [-WarningAction <ActionPreference>] [-ErrorVariable <String>] [-WarningVariable <String>] [-OutVariable <String>] [-OutBuffer <Int32>]
Descrição Detalhada
O Controle de acesso baseado em função (RBAC) permite aos administradores delegar ao Microsoft Lync Server 2010 o controle de tarefas de gerenciamento específicas. Por exemplo, em vez de conceder à assistência técnica da sua organização privilégios plenos de administrador, é possível fornecer direitos muito específicos a esses funcionários: o direito de gerenciar apenas contas de usuário, apenas componentes do Enterprise Voice e apenas o arquivamento e a Servidor de Arquivamento. Além disso, esses direitos podem ser limitados em escopo: um usuário pode receber o direito de gerenciar o Enterprise Voice, mas apenas no site de Redmond, enquanto outro usuário pode receber o direito de gerenciar contas de usuários, mas apenas se as contas estiverem na OU Financeira.
O cmdlet Get-CsAdminRoleAssignment permite recuperar uma lista das funções do RBAC que tiverem sido atribuídas a um usuário.
Quem pode executar esse cmdlet: Por padrão, membros dos seguintes grupos são autorizados a executar o cmdlet Get-CsAdminRoleAssignment localmente: RTCUniversalUserAdmins, RTCUniversalServerAdmins e RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções de RBAC que receberam a atribuição desse cmdlet (incluindo qualquer função RBAC personalizada criada por você), execute o seguinte comando no prompt Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsAdminRoleAssignment"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Cadeia de caracteres |
SamAccountName do usuário cujas funções do RBAC devem ser retornadas. É possível recuperar SamAccountName de um usuário utilizando-se um comando similar a este: Get-CsUser "Ken Myer" | Select-Object SamAccountName Observe que deve-se utilizar SamAccountName ao se especificar a identidade do usuário. Outros valores comuns utilizados ao se especificar identidades, como o nome de exibição no Active Directory ou o endereço SIP, não funcionarão com Get-CsAdminRoleAssignment. |
Force |
Opcional |
Parâmetro de opção |
Suprime a exibição de qualquer mensagem de erro não-fatal que possa ocorrer durante a execução do comando. |
LocalStore |
Opcional |
Parâmetro de opção |
Recupera os dados da atribuição da função de RBAC na réplica local do Repositório de Gerenciamento Central, em vez do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Cadeia de caracteres. Get-CsAdminRoleAssignment aceita um valor canalizado de cadeia de caracteres que represente o SamAccountName de um usuário.
Tipos de Retorno
Get-CsAdminRoleAssignment retorna valores de cadeia de caracteres que representam as funções do RBAC atribuídas ao usuário específico.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsAdminRoleAssignment -Identity "kenmyer"
O comando apresentado no Exemplo 1 retorna todas as funções do RBAC atribuídas ao usuário kenmyer.
-------------------------- Exemplo 2 ------------------------
Get-CsUser | ForEach-Object {$_.DisplayName; Get-CsAdminRoleAssignment -Identity $_.SamAccountName}
O comando anterior retorna as funções do RBAC de todos os usuários que tiverem sido habilitados para o Lync Server 2010. Para fazer isso, o comando chama primeiramente Get-CsUser sem quaisquer parâmetros; isto retornará uma coleção de todos os usuários na organização habilitados para Lync Server 2010 ou Office Communications Server. Este dados serão então canalizados para o cmdlet ForEach-Object, que acessará cada conta de usuário na coleção e fará o seguinte: 1) apresentará na tela o nome de exibição do usuário e 2) utilizará o cmdlet Get-CsAdminRoleAssignment para retornar as funções do RBAC do usuário. As informações da conta do usuário devem ser canalizadas para ForEach-Object porque Get-CsAdminRoleAssignment não aceita dados canalizados diretamente.