Disable-CsUser
上一次修改主题: 2012-03-23
修改一个或多个指定用户的 Active Directory 帐户,此修改可阻止用户使用 Microsoft Lync 2010 等 Microsoft Lync Server 2010 客户端。Disable-CsUser 仅限制与 Lync Server 2010 相关的活动,而不会禁用或删除用户的 Active Directory 帐户。
语法
Disable-CsUser -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-PassThru <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
详细说明
Disable-CsUser cmdlet 可从 Active Directory 用户帐户中删除所有与 Lync Server 相关的属性信息,这会阻止用户登录 Lync Server。运行 Disable-CsUser 时,将从帐户中删除所有与 Lync Server 相关的属性,包括分配给该帐户的任何每用户策略的 Identity。稍后您可以使用 Enable-CsUser cmdlet 重新启用此帐户。然而,将需要重新创建之前与该帐户关联的所有与 Lync Server 相关的信息(如策略分配)。如果要阻止用户登录 Lync Server,但不希望丢失此帐户的所有信息,可以改用 Set-CsUser。有关详细信息,请参阅 Set-CsUser 帮助主题。
使用 Disable-CsUser 禁用某个帐户后,Get-CsUser cmdlet 将不再返回受影响的用户,这是因为此用户不再具有有效的 Lync Server 帐户。要检索此禁用用户帐户的信息,请使用 Get-CsAdUser。
此外,将从后端数据库删除已删除用户帐户的用户数据;例如,将从组织中的联系人列表删除相应的用户,且该用户预定的任何会议都将删除。
谁能运行此 cmdlet:默认情况下,以下各组的成员有权在本地运行 Disable-CsUser cmdlet:RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表(包括您自己创建的任何自定义 RBAC 角色),请从 Windows PowerShell 提示符处运行以下命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Disable-CsUser"}
参数
参数 | 必需 | 类型 | 描述 |
---|---|---|---|
Identity |
必需 |
UserIdParameter |
指示要禁用的用户帐户的标识。可以采用下列四种格式之一来指定用户标识:1) 用户的 SIP 地址;2) 用户的用户主体名称 (UPN);3) 用户的域名和登录名,格式为“域名\登录名”(如 litwareinc\kenmyer);以及 4) 用户的 Active Directory 显示名称(例如 Ken Myer)。还可以使用 Active Directory 可分辨名称引用用户帐户。 在使用显示名称作为用户标识时,可以使用通配符星号 (*)。例如,标识“* Smith”将返回显示名称以字符串值“Smith”结尾的所有用户。 |
DomainController |
可选 |
字符串 |
使您可以连接到指定的域控制器,以便禁用用户帐户。要连接到特定的域控制器,请包含 DomainController 参数,后跟计算机名称(例如 atl-cs-001)或其完全限定域名 (FQDN)(例如 atl-cs-001.litwareinc.com)。 |
PassThru |
可选 |
开关参数 |
使您可以通过代表禁用的用户帐户的管道传递用户对象。默认情况下,Disable-CsUser cmdlet 不通过管道传递对象。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况(无需实际执行命令)。 |
输入类型
字符串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Disable-CsUser 接受通过管道传递的代表已启用 Lync Server 的用户帐户 Identity 的字符串值。此 cmdlet 还接受 Active Directory 用户对象通过管道传递的实例。
返回类型
Disable-CsUser 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Disable-CsUser -Identity "Ken Myer"
上述示例禁用用户 Ken Myer 的 Lync Server 帐户。在此示例中,使用用户的显示名称来指示其标识。
-------------------------- 示例 2 --------------------------
Get-CsUser -LDAPFilter "Department=Finance" | Disable-CsUser
在示例 2 中,Finance 部门中的所有用户都禁用了其 Lync Server 帐户。为完成此任务,此命令首先使用 Get-CsUser cmdlet 和 LDAPFilter 参数返回属于 Finance 部门的所有用户的集合。然后将此集合通过管道传递到 Disable-CsUser,后者将禁用集合中的每个帐户。
-------------------------- 示例 3 --------------------------
Get-CsUser -UnassignedUser | Disable-CsUser
在上述示例中,将禁用所有当前未分配到注册器池的用户帐户。为执行此操作,调用了带有 UnassignedUser 参数的 Get-CsUser。此参数可将返回的数据限制为具有有效用户帐户但未分配到注册器池的用户。然后将此集合通过管道传递到 Disable-CsUser,后者将禁用集合中的每个帐户。