Enable-CsUser
Tópico modificado em: 2012-03-23
Permite a um ou vários usuários para o Microsoft Lync Server 2010. Os usuários não podem usar os clientes do Microsoft Lync 2010 ou do Lync Server 2010 até que suas contas de usuário tenham sido habilitadas para o Lync Server.
Sintaxe
Enable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-HostingProviderProxyFqdn <Fqdn>] [-PassThru <SwitchParameter>] [-ProxyPool <Fqdn>] [-RegistrarPool <Fqdn>] [-SipAddress <String>] [-SipAddressType <FirstLastName | EmailAddress | UserPrincipalName | SAMAccountName | None>] [-SipDomain <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descrição Detalhada
Antes que um usuário possa fazer log on ao Lync Server, o usuário deve atender duas exigências: ter uma conta válida do Active Directory e ter essa conta habilitada para o Lync Server. Um modo para habilitar uma conta de usuário para o Lync Server é usar cmdlet Enable-CsUser. Para usar o cmdlet para habilitar uma conta para o Lync Server é preciso: 1) Selecionar a conta ou as contas a serem habilitadas; 2) Selecionar um pool de Registrador para a conta; e 3) Atribuir à conta um endereço SIP. O Lync Server dá aos administradores a opção de atribuir ao usuário um endereço SIP específico ou de deixar que o Lync Server crie um endereço SIP para você.
Quem pode executar este cmdlet: Por padrão, membros dos seguintes grupos estão autorizados a executar o cmdlet Enable-CsUser localmente: RTCUniversalUserAdmins. 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 "Enable-CsUser"}
Parâmetros
| Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
Identity |
Obrigatório |
UserIDParameter |
Indica a Identidade da conta de usuário a ser habilitada para Lync Server. A Identidade de Usuário pode ser especificada 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 de exibição do Active Directory 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 caráter curinga (*) asterisco ao usar o Nome de Exibição como a Identidade de usuário. Por exemplo, a Identidade "* Smith" retorna todos os usuários com nome para exibição que termine com o valor de cadeia de caracteres " Smith". |
RegistrarPool |
Obrigatório |
FQDN |
Indica o pool de Registrador no qual a conta do usuário do Lync Server será hospedada. |
SipAddressType |
Opcional |
Cadeia de caracteres |
Instrui Lync Server para auto-gerar um endereço SIP para o novo usuário. Para que o Lync Server gere automaticamente o endereço SIP, você deve incluir o parâmetro SipAddressType e usar um dos seguintes valores de parâmetro: FirstLastName. O endereço SIP é o nome do usuário e um período seguido pelo sobrenome do usuário e o domínio SIP. Por exemplo, o usuário Ken Myer teria um endereço SIP semelhante a este: Ken.Myer@litwareinc.com. Caso utilize este tipo de endereço, você deve incluir também o parâmetro SipDomain. EmailAddress O endereço de email do usuário (conforme definido no Active Directory) é usado como o endereço SIP. UserPrincipalName. O nome UPN do usuário é usado como o endereço SIP. SamAccountName. O endereço SIP é o SamAccountName do usuário (nome de logon) seguido pelo domínio SIP. Por exemplo, o usuário com o SamAccountName kmyer teria um endereço SIP semelhante a este: kmyer@litwareinc.com. Caso utilize este tipo de endereço, você deve incluir também o parâmetro SipDomain. O parâmetro SipAddressType não é exigido se você usar o parâmetro SIPAddress e explicitamente destinar o usuário um endereço SIP. |
SipDomain |
Opcional |
Cadeia de caracteres |
O domínio SIP para a conta de usuário a ser habilitada. Este parâmetro é necessário se você usar o parâmetro SIPAddressType para que o Lync Server gere automaticamente um endereço SIP para o usuário e se você basear endereços SIP no SamAccountName ou no primeiro nome e no sobrenome do usuário. Este parâmetro não é necessário se seus endereços SIP forem baseados no endereço de email ou no nome UPN do usuário; o nome de domínio já está incluído nesses valores de atributos. |
SipAddress |
Opcional |
Cadeia de caracteres |
Permite atribuir ao usuário um endereço SIP específico. Ao especificar o endereço SIP, prefacie o endereço com "sip:". Isto significa que o valor fornecido ao parâmetro SipAddress deve ter algo como este: sip:kenmyer@litwareinc.com O parâmetro SipAddress não deve ser usado se você usar o parâmetro SipAddressType para que o Lync Server gere automaticamente um endereço SIP para o usuário. O parâmetro SipAddress não pode ser usado se você estiver tentando habilitar mais de um usuário ao mesmo tempo. Em vez disso, é preciso gerar automaticamente endereços SIP para esses usuários com o parâmetro SipAddressType. |
HostingProviderProxyFqdn |
Opcional |
Cadeia de caracteres |
Este parâmetro é usado somente para o Microsoft Lync Online 2010. Não deve ser usado com uma implementação em-premissas do Lync Server. |
ProxyPool |
Opcional |
Cadeia de caracteres |
Este parâmetro é usado somente para o Lync Online 2010. Não deve ser usado com uma implementação em-premissas do Lync Server. |
DomainController |
Opcional |
Cadeia de caracteres |
Permite conectar ao controlador de domínio especificado para habilitar uma conta de usuário. Para conectar a um determinado controlador de domínio, inclua o parâmetro DomainController seguido pelo nome de computador (por exemplo, atl-cs-001) ou o seu FQDN (nome de domínio totalmente qualificado); por exemplo, atl-cs-001.litwareinc.com. |
PassThru |
Opcional |
Parâmetros de opção |
Permite passar um objeto de usuário pela pipeline que representa a conta de usuário que está sendo habilitada para o Lync Server. Por padrão, o cmdlet Enable-CsUser não passa objetos pela pipeline. |
WhatIf |
Opcional |
Parâmetros de opção |
Descreve o que aconteceria se o comando fosse executado sem ser executado de fato. |
Confirm |
Opcional |
Parâmetros de opção |
Solicita confirmação antes da execução do comando. |
Tipos de Entrada
Cadeia de caracteres ou objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Enable-CsUser aceita um valor de cadeia de caracteres em pipeline representando o parâmetro Identity de uma conta de usuário que tenha sido habilitada para o Lync Server. O cmdlet também aceita instâncias em pipeline do objeto de usuário do Active Directory.
Tipos de Retorno
Nenhuma. Enable-CsUser não retorna um valor ou objeto. Em vez disso, o cmdlet configura instâncias do objeto do Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Exemplo
-------------------------- Exemplo 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
No Exemplo 1, Enable-CsUser habilita a conta de usuário com nome para exibição Pilar Ackerman. Neste exemplo, o usuário é atribuído ao pool de Registrador atl-cs-001.litwareinc.com, e o Lync Server gera automaticamente o endereço SIP usando o SamAccountName (pilar) do usuário seguido pelo domínio SIP litwareinc.com.
-------------------------- Exemplo 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
No exemplo anterior, a conta de usuário do Active Directory que pertence a Pilar Ackerman é habilitada para o uso com o Lync Server. Para configurar a conta para o Lync Server, os parâmetros a seguir são usados com Enable-CsUser: Identity, que identifica a conta a ser habilitada; RegistrarPool, que indica o servidor Standard Edition ou pool de Front-Ends do Enterprise Edition no qual o usuário será hospedado; e SipAddress, que especifica o endereço SIP do novo usuário. Neste caso, o endereço SIP é explicitamente atribuído; o Lync Server não é usado para gerar automaticamente o endereço.
-------------------------- Exemplo 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
No Exemplo 3, todos os usuários que trabalham no departamento financeiro (Finance) têm suas contas habilitadas para o Lync Server. Executar esta tarefa, o cmdlet Get-CsAdUser é usado, junto com o parâmetro LDAPFilter, para retornar uma coleção de todos os usuários que trabalham para o departamento Financeiro. Essa informação é então canalizada para Enable-CsUser, que habilita cada conta na coleção para o Lync Server.
Para habilitar uma conta, é preciso especificar o pool de Registrador do usuário e o endereço SIP do usuário. Neste exemplo, o pool de Registrador é especificado usando o parâmetro RegistrarPool. Entretanto, o endereço SIP não é atribuído diretamente. Em vez disso, dois parâmetros, SIPAddressType e SipDomain, são adicionados ao comando. Isso significa que um novo endereço SIP, composto do SamAccountName do usuário e do nome de domínio SIP, será gerado automaticamente para cada conta. Por exemplo, um usuário com SamAccountName kenmyer receberá o endereço SIP sip:kenmyer@litwareinc.com.
-------------------------- Exemplo 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
O comando anterior habilita todos os usuários do Active Directory que ainda não foram habilitados para o Lync Server. Para fazer isso, o cmdlet Get-CsAdUser é invocado, junto com o parâmetro com Filtro. O filtro {Enabled -ne $True} retorna uma coleção de todos os usuários que não tenham sido habilitados para o Lync Server. Essa coleção é então canalizada para Enable-CsUser, que habilita cada conta, atribuindo o usuário ao pool de Registrador atl-cs-001.litwareinc.com e gerando automaticamente um endereço SIP para cada usuário.