Get-CsClientPinInfo
上一次修改主题： 2012-03-23
检索分配给用户的个人标识号 (PIN) 的相关信息。
语法
Get-CsClientPinInfo -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]
详细说明
通过 Lync Server 2010，用户可以使用电话连接到系统或加入公用电话交换网 (PSTN) 会议。通常，登录到系统或加入会议会要求用户输入用户名或密码。然而，如果您使用的是没有字母数字小键盘的电话，则输入用户名和密码就存在问题。因此，您可以通过 Lync Server 2010 为用户提供仅数字的 PIN；当系统提示时，用户可以通过输入 PIN 而不是用户名和密码来登录到系统或加入会议。
通过运行 Get-CsClientPinInfo cmdlet，管理员可以检索一个用户或用户组的 PIN 设置。请注意，管理员无法检索已分配到用户的 PIN。如果用户忘记其 PIN，则在管理员为其分配新 PIN，或用户从电话拨入式会议网页获取新 PIN 前，其将无法使用 PIN 身份验证访问系统。
请注意，在默认情况下，当安装标准版本的 Lync Server 2010 时，不会对 SQL Server Express 启用防火墙例外。这意味着，将无法从 Windows PowerShell 的远程实例运行 Get-CsClientPinInfo；这是因为您的命令将无法穿越防火墙访问 SQL Server Express 数据库。（但是，您仍可以在Standard Edition Server上本地运行该 cmdlet。） 要针对Standard Edition Server远程运行 Get-CsClientPinInfo，需要手动对 SQL Server Express 启用防火墙例外。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsClientPinInfo cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientPinInfo"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
UserId 参数 |
指示应锁定其 PIN 的用户帐户的标识。可以采用下列四种格式之一来指定用户标识：1) 用户的 SIP 地址；2) 用户的用户主体名称 (UPN)；3) 用户的域名和登录名，格式为“域名\登录名”（如 litwareinc\kenmyer）；以及 4) 用户的 Active Directory 显示名称（例如 Ken Myer）。还可以使用用户的 Active Directory 可分辨名称引用用户帐户。 在使用显示名称作为用户标识时，可以使用通配符星号 (*)。例如，Identity“* Smith”会返回显示名称以字符串值“ Smith”结尾的所有用户。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
字符串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 对象。Get-CsClientPinInfo 接受通过管道传递的字符串值的输入，代表用户帐户的标识。该 cmdlet 还接受通过管道传递的用户对象的输入。
返回类型
Get-CsClientPinInfo 会返回 Microsoft.Rtc.Management.UserPinService.PinInfoDetails 对象的一个或多个实例。
示例
-------------------------- 示例 1 ------------------------
Get-CsUser | Get-CsClientPinInfo
上述命令会返回所有已启用 Lync Server 2010 的用户的 PIN 信息。为执行此操作，命令首先调用 Get-CsUser 以返回启用了 Lync Server 2010 的所有用户。将该集合通过管道传递到 Get-CsClientPinInfo，后者会显示集合中每个用户的 PIN 信息。
-------------------------- 示例 2 ------------------------
Get-CsClientPinInfo -Identity "litwareinc\kenmyer"
在示例 2 中，使用 Get-CsClientPinInfo 显示单个用户的（Identity 为 litwareinc\kenmyer 的用户） PIN 信息。
-------------------------- 示例 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Get-CsClientPinInfo
示例 3 可返回 Finance 组织单位 (OU) 中具有帐户的所有用户的 PIN 信息。为执行此操作，使用了 Get-CsUser 和 OU 参数返回 Finance OU 中的所有用户的集合。然后，将该集合通过管道传递到 Get-CsClientPinInfo，它会显示集合中每个用户的 PIN 信息。
-------------------------- 示例 4 ------------------------
Get-CsUser -LdapFilter "Title=Manager" | Get-CsClientPinInfo
示例 4 中显示的命令可显示组织中所有 Manager 的 PIN 信息。为检索所有 Manager 的集合，命令将使用 Get-CsUser 和 LdapFilter 参数；筛选器值“Title=Manager”会将返回的集合限制为以“Manager”为职务的用户。然后，使用 Get-CsClientPinInfo 显示所有这些用户的 PIN 信息。