Enable-CsUser
Última modificación del tema: 2012-03-23
Habilita uno o varios usuarios para Microsoft Lync Server 2010. Los usuarios no pueden usar Microsoft Lync 2010 ni otros clientes Lync Server 2010 hasta que sus cuentas de usuario estén habilitadas para Lync Server.
Sintaxis
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>]]
Descripción detallada
Para que un usuario pueda tener acceso a Lync Server, debe cumplir dos requisitos: tener una cuenta válida de Active Directory y que dicha cuenta esté habilitada para Lync Server. Un sistema para habilitar una cuenta de usuario para Lync Server es usar el cmdlet Enable-CsUser. Para usar este cmdlet a fin de habilitar una cuenta de Lync Server, deberá: 1) seleccionar la cuenta (o cuentas) que se habilitarán; 2) seleccionar un grupo de registrador para la cuenta; y 3) asignar una dirección SIP a la cuenta. Lync Server ofrece a los administradores la opción de asignar al usuario una dirección SIP específica o hacer que Lync Server cree una dirección SIP para usted.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los grupos siguientes están autorizados a ejecutar el cmdlet Enable-CsUser de forma local: RTCUniversalUserAdmins. Para obtener una lista de todos los roles de control de acceso basado en roles (RBAC) que se han asignado a este cmdlet (incluidos los roles personalizados RBAC que haya creado usted), ejecute el siguiente comando en el aviso de Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Enable-CsUser"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
UserIDParameter |
Indica la identidad de la cuenta de usuario que se habilitará para Lync Server. Las identidades de usuario pueden especificarse con cuatro formatos: 1) la dirección SIP del usuario; 2) el nombre principal del usuario (UPN); 3) el nombre del dominio y el nombre de inicio de sesión del usuario, con formato dominio\nombre (por ejemplo, litwareinc\kenmyer), y 4) el nombre para mostrar de Active Directory del usuario (por ejemplo, Ken Myer). Para hacer referencia a una cuenta de usuario también puede usar el nombre distintivo de Active Directory del usuario. Puede usar el asterisco (*) como comodín al usar el Nombre para mostrar como identidad del usuario. Por ejemplo, la identidad "* Smith" devuelve todos los usuarios con un nombre para mostrar que termine con el valor de cadena de caracteres " Smith". |
RegistrarPool |
Requerido |
FQDN |
Indica el grupo de registrador al que se asignará la cuenta Lync Server del usuario. |
SipAddressType |
Opcional |
Cadena de caracteres |
Solicita a Lync Server que genere automáticamente una dirección SIP para el nuevo usuario. Para que Lync Server genere automáticamente la dirección SIP, debe incluir el parámetro -SipAddressType y usar uno de los siguientes valores de parámetro: FirstLastName. La dirección SIP es el nombre del usuario, un punto, el apellido y el dominio SIP. Por ejemplo, el usuario Ken Myer tendría una dirección SIP similar a: Ken.Myer@litwareinc.com. Si usa este tipo de dirección, también deberá usar el parámetro SipDomain. EmailAddress. La dirección de correo electrónico del usuario definida en Active Directory se usa como dirección SIP. UserPrincipalName. El UPN del usuario se usa como dirección SIP. SamAccountName. La dirección SIP es el SamAccountName del usuario (nombre de inicio de sesión) seguido del dominio SIP. Por ejemplo, el usuario con el SamAccountName kmyer tendrá una dirección SIP similar a: kmyer@litwareinc.com. Si usa este tipo de dirección, también deberá usar el parámetro SipDomain. El parámetro SipAddressType no es necesario si se usa SIPAddress y se asigna de manera explícita una dirección SIP al usuario. |
SipDomain |
Opcional |
Cadena de caracteres |
Dominio SIP de la cuenta de usuario que se habilitará. Este parámetro es necesario si se usa el parámetro SIPAddressType para que Lync Server genere automáticamente una dirección SIP para el usuario y las direcciones SIP están basadas en el SamAccountName o el nombre y apellido del usuario. Este parámetro no será necesario si las direcciones SIP están basadas en la dirección de correo electrónico o en el UPN del usuario; eso ocurre porque el nombre de dominio ya está incluido en esos valores de atributos. |
SipAddress |
Opcional |
Cadena de caracteres |
Permite asignar al usuario una dirección SIP específica. Al especificar la dirección SIP, asegúrese de usar el prefijo "sip:". El valor suministrado al parámetro SipAddress debería ser similar a: sip:kenmyer@litwareinc.com El parámetro SipAddress no debe usarse si se usa el parámetro SipAddressType para que Lync Server genere una dirección SIP automáticamente para el usuario. El parámetro SipAddress no se puede usar si se intenta habilitar múltiples usuarios al mismo tiempo. En su lugar, se debe generar automáticamente la dirección SIP para esos usuarios mediante el parámetro SipAddressType. |
HostingProviderProxyFqdn |
Opcional |
Cadena de caracteres |
Este parámetro se usa únicamente para Microsoft Lync Online 2010. No debe usarse en una instalación interna de Lync Server. |
ProxyPool |
Opcional |
Cadena de caracteres |
Este parámetro se usa únicamente para Lync Online 2010. No debe usarse en una instalación interna de Lync Server. |
DomainController |
Opcional |
Cadena de caracteres |
Lo habilita a conectarse al controlador de dominio especificado para habilitar una cuenta de usuario. Para conectarse a un controlador de dominio específico, debe incluir el parámetro DomainController seguido del nombre del equipo (por ejemplo, atl-cs-001) o su nombre de dominio completo (FQDN) (por ejemplo, atl-cs-001.litwareinc.com). |
PassThru |
Opcional |
Parámetro modificador |
Le permite pasar un objeto de usuario por una canalización que representa la cuenta de usuario que se habilita para Lync Server. De manera predeterminada, el cmdlet Enable-CsUser no pasa objetos por la canalización. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
Tipos de entrada
Cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Enable-CsUser acepta un valor de cadena canalizado que representa la identidad de una cuenta de usuario que se ha habilitado para Lync Server. El cmdlet también acepta entradas canalizadas del objeto de usuario de Active Directory.
Tipos de valores devueltos
Ninguno. Enable-CsUser no devuelve un valor u objeto. En su lugar, el cmdlet configura instancias del objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
En el Ejemplo 1, Enable-CsUser habilita la cuenta de usuario con el nombre para mostrar Pilar Ackerman. En este ejemplo, el usuario se asigna al grupo de registrador atl-cs-001.litwareinc.com y Lync Server genera automáticamente la dirección SIP mediante el SamAccountName del usuario (pilar) seguido por el dominio SIP litwareinc.com.
-------------------------- Ejemplo 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
En el ejemplo anterior, la cuenta de usuario de Active Directory perteneciente a Pilar Ackerman se habilita para su uso con Lync Server. A fin de configurar la cuenta para Lync Server se usan los siguientes parámetros junto con Enable-CsUser: Identity, que identifica la cuenta que se habilitará; RegistrarPool, que indica el servidor Standard Edition o grupo de servidores front-end Enterprise Edition en donde se hospedará al usuario; y SipAddress, que especifica la dirección SIP del nuevo usuario. En este caso, la dirección SIP se asigna de manera explícita en lugar de usar Lync Server para generar automáticamente la dirección.
-------------------------- Ejemplo 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
En el Ejemplo 3, se habilitan todos los usuarios que trabajan en el departamento de finanzas para las cuentas habilitadas para Lync Server. Para realizar esta tarea, se usa el cmdlet Get-CsAdUser, junto con el parámetro LDAPFilter, para devolver una recopilación de todos los usuarios que trabajan en el departamento de finanzas. Esa información después se canaliza a Enable-CsUser, que habilita todas las cuentas de la recopilación para Lync Server.
Para habilitar una cuenta, debe especificar el grupo de registrador del usuario y la dirección SIP del usuario. En este ejemplo, el grupo de registrador se especifica con el parámetro RegistrarPool. Aunque la dirección SIP no se asigna directamente. En su lugar, se agregan dos parámetros al comando, SIPAddressType y SIPDomain. Eso significa que se generará una nueva dirección SIP para cada cuenta automáticamente, que consistirá en el SamAccountName del usuario y el nombre del dominio SIP. Por ejemplo, un usuario con el nombre SAMAccountName kenmyer tendrá la dirección SIP sip:kenmyer@litwareinc.com.
-------------------------- Ejemplo 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
Con el comando anterior se habilita a todos los usuarios de Active Directory que todavía no estén habilitados para Lync Server. Para ello, se invoca el cmdlet Get-CsAdUser junto con el parámetro Filter. El filtro {Enabled -ne $True} devuelve una recopilación de todos los usuarios que no han sido habilitados para Lync Server. Esa recopilación después se canaliza a Enable-CsUser, que habilita todas las cuentas, asigna los usuarios al grupo de registrador atl-mcs-001.litwareinc.com y genera automáticamente una dirección SIP para cada usuario.