Disable-CsUser
Última modificación del tema: 2012-03-23
Modifica la cuenta de Active Directory del usuario (o usuarios) especificado. Esta modificación impide que los usuarios usen clientes de Microsoft Lync Server 2010, como Microsoft Lync 2010. Disable-CsUser solo restringe la actividad relacionada con Lync Server 2010; no deshabilita ni quita la cuenta de Active Directory de un usuario.
Sintaxis
Disable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
El cmdlet Disable-CsUser elimina toda la información de atributos relacionada con Lync Server de una cuenta de usuario de Active Directory; el usuario ya no podrá obtener acceso a Lync Server. Al ejecutar Disable-CsUser, se eliminan de una cuenta todos los atributos relacionados con Lync Server, incluidas las identidades de todas las directivas por usuario que se hubieran asignado a esa cuenta. La cuenta puede volver a habilitarse más adelante con el cmdlet Enable-CsUser. No obstante, será necesario volver a crear toda la información relacionada con Lync Server (como, por ejemplo, las asignaciones de directivas) que estuviera asociada previamente a esa cuenta. Si desea impedir que un usuario inicie sesión en Lync Server pero no quiere perder toda la información de su cuenta, puede usar Set-CsUser en lugar de este cmdlet. Si necesita información detallada, consulte el tema de ayuda Set-CsUser.
Cuando una cuenta se haya deshabilitado con Disable-CsUser, el usuario afectado ya no aparecerá en los datos devueltos por el cmdlet Get-CsUser, ya que el usuario ya no tendrá una cuenta de Lync Server válida. Para recuperar información sobre esa cuenta de usuario deshabilitada, use Get-CsAdUser.
Además, los datos de usuario que pertenecen a la cuenta de usuario borrada se eliminarán de las bases de datos back-end. Por ejemplo, el usuario se eliminará de las listas de contactos de la organización y las conferencias que pueda haber programado ese usuario serán borradas.
Quién puede ejecutar este cmdlet: De forma predeterminada, los miembros de los siguientes grupos están autorizados a ejecutar el cmdlet Disable-CsUser de forma local: RTCUniversalUserAdmins. Para devolver una lista de todos los roles de control de acceso basado en roles (RBAC) a los que se ha asignado este cmdlet (incluido cualquier otro rol RBAC personalizado que usted mismo haya creado), ejecute el siguiente comando desde Windows PowerShell:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsUser"}
Parámetros
| Parámetro | Requerido | Tipo | Descripción |
|---|---|---|---|
Identity |
Requerido |
UserIdParameter |
Indica la identidad de la cuenta de usuario que se deshabilitará. 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 consultar una cuenta de usuario utilizando el nombre distintivo de Active Directory. 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 cuyo nombre para mostrar termine con el valor de cadena " Smith". |
DomainController |
Opcional |
Cadena de caracteres |
Permite conectarse al controlador de dominio especificado para deshabilitar 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 |
Permite pasar un objeto de usuario a través de la canalización que representa a la cuenta de usuario que se está deshabilitando. De forma predeterminada, el cmdlet Disable-CsUser no pasa objetos a través de la canalización. |
Confirm |
Opcional |
Parámetro modificador |
Solicita confirmación antes de ejecutar el comando. |
WhatIf |
Opcional |
Parámetro modificador |
Describe lo que ocurriría si se ejecutara el comando sin ejecutarlo realmente. |
Tipos de entrada
Cadena u objeto Microsoft.Rtc.Management.ADConnect.Schema.ADUser. Disable-CsUser acepta un valor de cadena transmitido que representa la identidad de una cuenta de usuario habilitada para Lync Server. El cmdlet también acepta las instancias transmitidas del objeto de usuario de Active Directory.
Tipos de valores devueltos
Disable-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 --------------------------
Disable-CsUser -Identity "Ken Myer"
En el ejemplo anterior se deshabilita la cuenta de Lync Server del usuario Ken Myer. En este ejemplo, se usa el nombre para mostrar del usuario para indicar su identidad (Identity).
-------------------------- Ejemplo 2 --------------------------
Get-CsUser -LDAPFilter "Department=Finance" | Disable-CsUser
En el Ejemplo 2, se deshabilitan las cuentas de Lync Server de todos los usuarios del departamento de finanzas. Para llevar a cabo esta tarea, primero el comando usa el cmdlet Get-CsUser y el parámetro LDAPFilter para devolver una colección de todos los usuarios del departamento de finanzas (Finance). A continuación, la colección se envía a Disable-CsUser, que deshabilita todas las cuentas de la colección.
-------------------------- Ejemplo 3 --------------------------
Get-CsUser -UnassignedUser | Disable-CsUser
En el ejemplo anterior se deshabilitan todas las cuentas de usuario no asignadas a un grupo de registrador. Para ello, se llama a Get-CsUser, junto con el parámetro UnassignedUser. Este parámetro limita los datos devueltos a usuarios que tienen cuentas válidas pero no están asignados a un grupo de registrador. A continuación, la colección se envía a Disable-CsUser, que deshabilita todas las cuentas de la colección.