Enable-CsUser
上一次修改主题： 2012-03-23
启用 Microsoft Lync Server 2010 的一个或多个用户。只有用户帐户已启用 Lync Server 之后，用户才能使用 Microsoft Lync 2010 或其他 Lync Server 2010 客户端。
语法
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>]]
详细说明
用户必须满足以下两个要求，才能登录到 Lync Server：他或她必须具有有效的 Active Directory 帐户，而且该帐户必须已启用 Lync Server。启用 Lync Server 的用户帐户的方式之一是使用 Enable-CsUser cmdlet。要使用此 cmdlet 启用 Lync Server 的帐户，您必须：1) 选择要启用的一个帐户（或多个帐户）；2) 为帐户选择注册器池；3) 为帐户分配 SIP 地址。通过 Lync Server，管理员可以选择为用户分配一个特定 SIP 地址，或者使 Lync Server 创建一个 SIP 地址。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Enable-CsUser cmdlet：RTCUniversalUserAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Enable-CsUser"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
用户 ID 参数 |
指示要启用 Lync Server 的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。还可以使用用户的 Active Directory 可分辨名称引用用户帐户。 在使用显示名称作为用户标识时，可以使用通配符星号 (*)。例如，标识“* Smith”将返回显示名称以字符串值“Smith”结尾的所有用户。 |
RegistrarPool |
必需 |
FQDN |
指示将要“托管”用户的 Lync Server 帐户的注册器池。 |
SipAddressType |
可选 |
字符串 |
指示 Lync Server 为新用户自动生成 SIP 地址。为了使 Lync Server 自动生成 SIP 地址，必须包含 SipAddressType 参数并使用以下参数值之一： FirstLastName。SIP 地址是用户的名字和一个圆点，后跟该用户的姓和 SIP 域。例如，用户 Ken Myer 的 SIP 地址应该与此类似：Ken.Myer@litwareinc.com。如果您使用此地址类型，则还必须包含 SipDomain 参数。 EmailAddress。用户的电子邮件地址（如 Active Directory 中的定义）可以用作 SIP 地址。 UserPrincipalName。用户的 UPN 用作 SIP 地址。 SamAccountName。SIP 地址是用户的 SamAccountName（登录名），后跟 SIP 域。例如，SamAccountName 为 kmyer 的用户拥有的 SIP 地址应该与此类似：kmyer@litwareinc.com。如果您使用此地址类型，则还必须包含 SipDomain 参数。 如果使用 SIPAddress 参数并显式地为用户分配一个 SIP 地址，则无需 SipAddressType 参数。 |
SipDomain |
可选 |
字符串 |
启用的用户帐户的 SIP 域。如果使用 SIPAddressType 参数使 Lync Server 为用户自动生成 SIP 地址，并且 SIP 地址基于 SamAccountName 或用户的名和姓，则此参数是必需的。如果 SIP 地址基于用户的电子邮件地址或 UPN，则此参数不是必需的，这是因为域名已经包含在这些属性值中。 |
SipAddress |
可选 |
字符串 |
使您能够为用户分配特定的 SIP 地址。指定 SIP 地址时，地址需以“sip:”开头。这意味着为 SipAddress 参数提供的值看起来应该与此类似： sip:kenmyer@litwareinc.com 如果使用 SipAddressType 参数以使 Lync Server 为用户自动生成 SIP 地址，则不应使用 SipAddress 参数。 如果尝试同时启用多个用户，则不能使用 SipAddress 参数。您必须使用 SipAddressType 参数来为这些用户自动生成 SIP 地址。 |
HostingProviderProxyFqdn |
可选 |
字符串 |
此参数仅用于 Microsoft Lync Online 2010。不应将其与 Lync Server 的内部部署实现结合使用。 |
ProxyPool |
可选 |
字符串 |
此参数仅用于 Lync Online 2010。不应将其与 Lync Server 的内部部署实现结合使用。 |
DomainController |
可选 |
字符串 |
使您可以连接到指定的域控制器，以便启用用户帐户。要连接到特定的域控制器，请包含 DomainController 参数，后跟计算机名称（例如 atl-cs-001）或其完全限定域名 (FQDN)（例如 atl-cs-001.litwareinc.com）。 |
PassThru |
可选 |
开关参数 |
使您能够通过表示已针对 Lync Server 启用的用户帐户的管道来传递用户对象。默认情况下，Enable-CsUser cmdlet 不通过管道传递对象。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Enable-CsUser 接受通过管道传递的字符串值，代表已启用 Lync Server 的用户帐户的标识。该 cmdlet 还接受通过管道传递的 Active Directory 用户对象的实例。
返回类型
无。Enable-CsUser 不会返回值或对象。此 cmdlet 会配置 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象的实例。
示例
-------------------------- 示例 1 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
在示例 1 中，Enable-CsUser 启用显示名称为 Pilar Ackerman 的用户帐户。在此示例中，将该用户分配给注册器池 atl-cs-001.litwareinc.com，并且 Lync Server 使用用户的 SamAccountName (pilar) 并后跟 SIP 域 litwareinc.com 来自动生成 SIP 地址。
-------------------------- 示例 2 --------------------------
Enable-CsUser -Identity "Pilar Ackerman" -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddress "sip:pilar@litwareinc.com"
在上述示例中，启用了 Pilar Ackerman 所拥有的 Active Directory 用户帐户以与 Lync Server 结合使用。为了配置 Lync Server 的帐户，请将下列参数与 Enable-CsUser 结合使用：Identity，标识要启用的帐户；RegistrarPool，指示用户所属的 Standard Edition Server 或企业版前端池；SipAddress，为新用户指定 SIP 地址。在此示例中，明确分配了 SIP 地址，而不是使用 Lync Server 自动生成地址。
-------------------------- 示例 3 --------------------------
Get-CsAdUser -LDAPFilter "department=Finance" | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
在示例 3 中，为 Finance 部门工作的所有用户都启用了 Lync Server 的帐户。为完成此任务，使用 Get-CsAdUser cmdlet 以及 LDAPFilter 参数，返回为 Finance 部门工作的所有用户的集合。然后将该信息通过管道传递到 Enable-CsUser，这会为 Lync Server 启用集合中的每个帐户。
要启用帐户，必须指定用户的注册器池和用户的 SIP 地址。在此示例中，使用 RegistrarPool 参数来指定注册器池。但是，并不是直接分配 SIP 地址，而是在命令中添加了两个参数（SipAddressType 和 SipDomain）。这意味着将为每个帐户自动生成一个新的 SIP 地址，其中包含用户的 SamAccountName 和 SIP 域名。例如，向 SAMAccountName 为 kenmyer 的用户提供的 SIP 地址为 sip:kenmyer@litwareinc.com。
-------------------------- 示例 4 --------------------------
Get-CsAdUser -Filter {Enabled -ne $True} | Enable-CsUser -RegistrarPool "atl-cs-001.litwareinc.com" -SipAddressType SamAccountName -SipDomain litwareinc.com
上述命令启用所有尚未启用 Lync Server 的 Active Directory 用户。为此，调用了 Get-CsAdUser cmdlet 以及 Filter 参数。筛选器 {Enabled -ne $True} 返回尚未启用 Lync Server 的所有用户的集合。然后将此集合通过管道传递到 Enable-CsUser，这将启用每个帐户，将用户分配给注册器池 atl-cs-001.litwareinc.com，并为每个用户自动生成 SIP 地址。