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 上本機執行此指令程式)。若要針對 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 之使用者帳戶的 Identity。可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (如 litwareinc\kenmyer)；4) 使用者的 Active Directory 顯示名稱 (如 Ken Myer)。您也可以利用使用者的 Active Directory 辨別名稱來參考使用者帳戶。 使用「顯示名稱」作為使用者 Identity 時，您可以使用星號 (*) 萬用字元。例如，Identity "* Smith" 會傳回顯示名稱結尾為字串值 " Smith" 的所有使用者。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Get-CsClientPinInfo 接受管線傳送的字串值輸入，代表使用者帳戶的 Identity。此指令程式也接受已傳送的使用者物件輸入。
傳回類型
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 用來顯示單一使用者的 PIN 資訊：Identity 為 litwareinc\kenmyer 的使用者。
-------------------------- 範例 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 資訊。