Set-CsUser
Última modificación del tema: 2012-03-26
Modifica propiedades Microsoft Lync Server 2010 de una cuenta de usuario. Solo pueden modificarse propiedades de cuentas que se hayan habilitado para su uso con Lync Server 2010.
Sintaxis
Set-CsUser -Identity <UserIdParameter> [-AcpInfo <MultiValuedProperty>] [-AudioVideoDisabled <$true | $false>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-EnterpriseVoiceEnabled <$true | $false>] [-HostedVoiceMail <Nullable>] [-LineServerURI <String>] [-LineURI <String>] [-PassThru <SwitchParameter>] [-PrivateLine <String>] [-RemoteCallControlTelephonyEnabled <$true | $false>] [-SipAddress <String>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Set-CsUser permite modificar los atributos de cuenta relacionados con Lync Server almacenados en Active Directory Domain Services (AD DS). Por ejemplo, puede deshabilitar o volver a habilitar a un usuario para Lync Server; habilitar o deshabilitar a un usuario para comunicaciones de audio y vídeo (A/V) o modificar los números de línea privada y URI (Uniform Resource Identifier) de un usuario. Set-CsUser solo puede usarse para usuarios que se hayan habilitado para Lync Server.
Los únicos atributos que se pueden modificar por medio del uso de Set-CsUser son los atributos relacionados con Lync Server. Este cmdlet no permite modificar otros atributos de cuentas de usuarios, como el cargo o el departamento del usuario.
Quiénes pueden ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos tienen autorización para ejecutar el cmdlet Set-CsUser localmente: 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 "Set-CsUser\b"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
Identidad Xds |
Indica la identidad de la cuenta de usuario que se modificará. 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). También se puede hacer referencia a las identidades de usuario mediante el uso de un 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, el parámetro Identity "* Smith" devolvería todos los usuarios cuyo nombre para mostrar termine con el valor de cadena " Smith". |
ACPInfo |
Opcional |
Conjunto de objetos ACPInfo |
Permite asignar uno o varios proveedores de audioconferencias externos a un usuario. No obstante, se recomienda usar el cmdlet Set-UserAcp para asignar proveedores de audioconferencias. |
AudioVideoDisabled |
Opcional |
Booleano |
Indica si el usuario tiene permiso para hacer llamadas de audio y visuales (A/V) usando Lync 2010. Si está establecido en True, el usuario tendrá muchas restricciones para enviar y recibir mensajes instantáneos. No es posible deshabilitar las comunicaciones A/V si un usuario está habilitado para control de llamada remoto, Enterprise Voice o enrutamiento telefónico con central de conmutación privada mediante protocolo de Internet (IP-PBX). |
Enabled |
Opcional |
Booleano |
Indica si el usuario se ha habilitado para Lync Server. Si se define este valor como False, el usuario no podrá tener acceso a Lync Server; si se define como True se volverán a habilitar los privilegios de acceso del usuario. Si se deshabilita una cuenta con el parámetro Enabled, la información asociada con la cuenta se conservará (incluidas las directivas asignadas, si el usuario está habilitado para Enterprise Voice y/o control de llamada remoto). Si se vuelve a habilitar la cuenta más adelante con el parámetro Enabled, la información asociada con la cuenta se restaurará. Si se usa el cmdlet Disable-CsUser para deshabilitar una cuenta de usuario el resultado es diferente. Al ejecutar Disable-CsUser, todos los datos de Lync Server asociados con la cuenta se eliminan. |
DomainController |
Opcional |
Cadena de caracteres |
Le permite especificar un controlador de dominio para conectarse cuando modifica una cuenta de usuario. Si este parámetro no está incluido, el cmdlet usará el primer controlador de dominio disponible. |
EnterpriseVoiceEnabled |
Opcional |
Booleano |
Indica si el usuario se ha habilitado para Enterprise Voice, que es la implementación del protocolo de voz sobre IP (VoIP) de Microsoft. Con Enterprise Voice, los usuarios pueden hacer llamadas telefónicas a través de Internet, en lugar de usar la red telefónica estándar. |
HostedVoiceMail |
Opcional |
Booleano |
Cuando se establece en True, permite que las llamadas de correo de voz del usuario se enruten a una versión hospedada de Microsoft Exchange Server. Además, si se configura esta opción en True, permite que los usuarios de Lync 2010 realicen una llamada directamente al correo de voz de otro usuario. |
LineURI |
Opcional |
Cadena de caracteres |
Número telefónico asignado al usuario. El URI de línea debe especificarse en el formato E.164 y debe usar "TEL:" . Por ejemplo: TEL:+14255551297. Cualquier número de extensión debe agregarse al final del URI de línea, por ejemplo: TEL:+14255551297; ext=51297. Es importante tener en cuenta que Lync Server trata TEL:+14255551297 y TEL:+14255551297;ext=51297 como dos números diferentes. Si le asigna a Ken Myer el URI de línea TEL:+14255551297 y después intenta asignarle a Pilar Ackerman el URI de línea TEL:+14255551297;ext=51297, dicha asignación será correcta; el número asignado a Pilar no se marcará como duplicado. Esto se debe a que, en función de la configuración, esos dos números podrían ser diferentes en la realidad. Por ejemplo, en algunas organizaciones, si se marca 1-425-555-1297, la llamada se encamina a un operador automático de Exchange. En cambio, al marcar solo la extensión (51297) o al usar Microsoft Lync 2010 para marcar el número 1-425-555-1297, la extensión 51297 encaminará la llamada directamente al usuario. |
LineServerURI |
Opcional |
Cadena de caracteres |
El URI de la puerta de enlace de teléfono del control de llamadas remoto asignado al usuario. LineServerUri es el URI de la puerta de enlace, con el prefijo "sip:". Por ejemplo: sip:rccgateway@litwareinc.com |
PrivateLine |
Opcional |
Cadena de caracteres |
Número de teléfono de la línea privada del usuario. Una línea privada es un número de teléfono que no está publicado en los servicios Active Directory Domain Services (AD DS), y, por lo tanto, no está disponible para otras personas. Además, esta línea privada omite la mayoría de reglas de enrutamiento de llamadas entrantes; por ejemplo, una llamada a una línea privada no se desviará a los delegados de una persona. Las líneas privadas suelen usarse para llamadas personales o de negocios que deben mantenerse al margen de otros miembros del equipo. El valor de la línea privada debe especificarse en el formato E.164 y con el prefijo "TEL:". . Por ejemplo: TEL:+14255551297. |
RemoteCallControlTelephonyEnabled |
Opcional |
Booleano |
Indica si el usuario se ha habilitado para telefonía de control de llamada remoto. Si está habilitado para control de llamada remoto, el usuario puede usar Lync Server para responder llamadas telefónicas realizadas a su teléfono de escritorio. También pueden hacerse llamadas con Lync 2010. Estas llamadas usan la red telefónica estándar, llamada también Red Telefónica Conmutada (RTC). Para hacer y recibir llamadas a través de Internet, el usuario debe estar habilitado para Enterprise Voice. Si necesita información detallada, consulte el parámetro EnterpriseVoiceEnabled. Para poder habilitarlo para control de llamada remoto, un usuario debe tener un LineUri y un LineServerUri. |
SipAddress |
Opcional |
Cadena de caracteres |
Identificador único (similar a una dirección de correo electrónico) que permite al usuario comunicarse usando dispositivos SIP, como Lync 2010. La dirección SIP debe usar el prefijo: sip, así como también un dominio SIP válido; como por ejemplo: -SipAddress sip:kenmyer@litwareinc.com. |
PassThru |
Opcional |
Parámetro modificador |
Le permite pasar un objeto de usuario a través de la canalización que representa al usuario cuya cuenta se está modificando. De manera predeterminada, el cmdlet Set-CsUser no pasa objetos a través de 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. Set-CsUser acepta un valor de cadena canalizado que represente la identidad de una cuenta de usuario habilitada para Lync Server. El cmdlet también acepta entradas canalizadas del objeto de usuario de Active Directory.
Tipos de valores devueltos
Set-CsUser no devuelve ningún objeto.
Ejemplo
-------------------------- Ejemplo 1 --------------------------
Set-CsUser -Identity "Pilar Ackerman" -EnterpriseVoiceEnabled $True
En el Ejemplo 1, se usa Set-CsUser para modificar la cuenta de usuario con la identidad Pilar Ackerman. En este caso, la cuenta se modifica para habilitar Enterprise Voice, la solución de Microsoft que usa VoIP. Para ello, se agrega el parámetro EnterpriseVoiceEnabled y después se define el valor del parámetro como $True.
-------------------------- Ejemplo 2 --------------------------
Get-CsUser -LdapFilter "Department=Finance" | Set-CsUser -EnterpriseVoiceEnabled $True
En el Ejemplo 2, se habilitan todas las cuentas de los usuarios del departamento de finanzas para Enterprise Voice. En este comando, se usan primero el cmdlet Get-CsUser y el filtro LDAPFilter para devolver una recopilación de todos los usuarios que trabajan en el departamento de finanzas. A continuación, esa información se transfiere a Set-CsUser, que habilita Enterprise Voice en todas las cuentas de la recopilación.