Get-CsUserPoolInfo
Tópico modificado em: 2012-03-23
Retorna informações sobre o pool do Registrador, o pool do Registrador de backup e o pool de Serviços do Usuário aos quais um usuário tenha sido atribuído.
Sintaxe
Get-CsUserPoolInfo -Identity <UserIdParameter> [-LocalStore <SwitchParameter>]
Descrição Detalhada
Quando um usuário é habilitado para o Microsoft Lync Server 2010, deve ser hospedado em um pool de Registrador. Esse pool é responsável pela autenticação do usuário e por rastrear seu status e local no momento. Para saber o pool de Registrador ao qual um usuário foi atribuído, use um comando semelhante a este:
Get-CsUser "Ken Myer" | Select-Object RegistrarPool
Em muitos casos, a única informação necessária é o pool de Registrador de um usuário. Em outros, porém, você pode precisar saber o pool de Registrador de backup ao qual o usuário foi atribuído (ou seja, o pool a ser usado se o pool de Registrador principal não estiver disponível); os nomes dos computadores individuais que compõem esses pools e o pool de Serviços do Usuário ao qual o usuário foi atribuído. Esse tipo de informação detalhada pode ser retornado com o cmdlet Get-CsUserPoolInfo.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Get-CsUserPoolInfo localmente: RTCUniversalReadOnlyAdmins. Para retornar uma lista de todas as funções do RBAC (controle de acesso baseado na função) atribuídas a este cmdlet (incluindo eventuais funções personalizadas do RBAC que você mesmo tenha criado), execute o comando a seguir no prompt do Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsUserPoolInfo"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
Parâmetro User ID |
Indica a Identidade do usuário cujas informações de pool de usuário serão recuperadas. As identidades podem ser especificadas usando um de quatro formatos: 1) O endereço SIP do usuário; 2) o nome UPN do usuário; 3) o nome de domínio do usuário e nome de logon, na forma domínio\logon (por exemplo, litwareinc\kenmyer); e, 4) o nome para exibição do Serviços de Domínio Active Directory (AD DS) do usuário (por exemplo, Ken Myer). Também é possível fazer referência a uma conta de usuário com o nome diferenciado do Active Directory. Você pode usar o caracter curinga asterisco (*) quando estiver usando o Nome para Exibição como Identity do usuário. Por exemplo, a Identity "* Smith" retorna informações de usuários que tenham o sobrenome terminando com o valor de cadeia de caracteres " Smith". |
LocalStore |
Parâmetros de opção |
Obtém as informações de pool de usuário a partir da réplica local do Repositório de Gerenciamento Central, e não do Repositório de Gerenciamento Central em si. |
Tipos de Entrada
Cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Set-CsUser aceita um valor de cadeia de caracteres em pipeline representando o SamAccountName de uma conta de usuário que tenha sido habilitada para o Lync Server 2010. O cmdlet também aceita instâncias em pipeline do objeto de usuário do Active Directory.
Tipos de Retorno
Get-CsUserPoolInfo retorna instâncias do objeto Microsoft.Rtc.Management.Xds.GetOCsUserPoolInfoCmdlet+UserInformation.
Exemplo
-------------------------- Exemplo 1 ------------------------
Get-CsUserPoolInfo "sip:kenmyer@litwareinc.com"
O comando anterior retorna informações do pool de usuário de um único usuário: o usuário com endereço sip sip:kenmyer@litwareinc.com.
-------------------------- Exemplo 2 ------------------------
Get-CsUser | Get-CsUserPoolInfo
No Exemplo 2, as informações de pool de usuário são retornadas para todos os usuários que tenham sido habilitados para o Lync Server 2010. Para executar esta tarefa, o comando primeiro chama Get-CsUser sem parâmetros para retornar uma coleção de todos os usuários habilitados para o Lync Server. Essa coleção é então canalizada para Get-CsUserPoolInfo, que exibe informações de pool de todos os usuários da coleção.
-------------------------- Exemplo 3 ------------------------
Get-CsUser | Where-Object {$_.RegistrarPool -ne $Null} | Get-CsUserPoolInfo
O comando mostrado no Exemplo 3 é uma variação do comando usado no Exemplo 2. No Exemplo 2, as informações de pool são retornadas para todos os usuários que tenham sido habilitados para o Lync Server. Porém, é possível ter usuários que tenham sido habilitados para o Lync Server mas que não tenham sido atribuídos a um pool de Registrador. O comando mostrado no Exemplo 2 exibe uma mensagem de erro para cada usuário que atenda a esses critérios; essas mensagens de erro são suprimidas no Exemplo 3.
Para suprimir a mensagem de erro, o Exemplo 3 torna a usar Get-CsUser para retornar uma coleção de todos os usuários habilitados para o Lync Server. Porém, desta vez, a coleção é canalizada para o cmdlet Where-Object, que seleciona apenas os usuários nos quais a propriedade RegistrarPool não seja igual a um valor nulo (em outras palavras, usuários que tenham sido atribuídos a um pool de Registrador). Essa coleção filtrada é então canalizada para Get-CsUserPoolInfo, que exibe informações de pool de todos os usuários da coleção filtrada.
-------------------------- Exemplo 4 ------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.PrimaryPoolFqdn -eq "redmond-cs-001.litwareinc.com"}
No comando anterior, as informações de pool são exibidas para todos os usuários que tenham sido atribuídos ao pool principal redmond-cs-001.litwareinc.com. Para isso, Get-CsUser é chamado para retornar uma coleção de todos os usuários que tenham sido habilitados para o Lync Server. Essa coleção é canalizada para Get-CsUserPoolInfo, que recupera informações de pool de todos os usuários da coleção. Essas informações de pool são canalizadas para o cmdlet Where-Object, que seleciona apenas os usuários nos quais a propriedade PrimaryPoolFqdn seja igual a redmond-cs-001.litwareinc.com.
-------------------------- Exemplo 5 ------------------------
Get-CsUser | Get-CsUserPoolInfo | Where-Object {$_.BackupPoolFqdn -eq $Null}
O comando mostrado no Exemplo 5 retorna informações de pool de todos os usuários que não tenham sido atribuídos a um pool de Registrador de backup. Para executar esta tarefa, o comando primeiro chama Get-CsUser para retornar uma coleção de todos os usuários que tenham sido habilitados para o Lync Server. Essas informações são canalizadas para Get-CsUserPoolInfo, que recupera informações de pool de todos os usuários da coleção. Por fim, essas informações de pool são canalizadas para Where-Object, que exibe dados apenas dos usuários nos quais a propriedade BackupPoolFqdn seja igual a um valor nulo.
-------------------------- Exemplo 6 ------------------------
Get-CsUserPoolInfo "Ken Myer" | Select-Object -Expand PrimaryPoolMachinesInPreferredOrder
No Exemplo 6, são relatadas as informações sobre os computadores individuais que compõem o pool de Registrador de Ken Myer. Para recuperar essas informações, Get-CsUserPoolInfo é chamado primeiro para retornar os dados relevantes sobre a conta de usuário de Ken Myer. Em seguida, esses dados são canalizados para o cmdlet Select-Object. Select-Object usa o parâmetro Expand para "expandir" as informações armazenadas na propriedade PrimaryPoolMachinesInPreferredOrder. Expandir uma propriedade significa que todos os valores armazenados nessa propriedade serão exibidos na tela em formato fácil de ler.