Set-CsClientPin
上次修改主題的時間： 2012-03-25
將新的個人識別碼 (PIN) 指派給指定的使用者。
語法
Set-CsClientPin -Identity <UserIdParameter> [-Pin <String>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Lync Server 2010 可讓使用者透過電話連接系統或加入公用交換電話網路 (PSTN) 會議。登入系統或加入會議通常需要使用者輸入使用者名稱或密碼。但是，如果您使用的是沒有英數字元鍵盤的電話，輸入使用者名稱和密碼將會是一大難題。基於上述考量，Lync Server 2010 可讓您將僅由數字組成的 PIN 提供給使用者。當出現提示時，使用者只要輸入 PIN 便能登入系統或加入會議，完全不需要使用者名稱和密碼。
當使用者已啟用 Lync Server 2010 時，系統並不會指派 PIN 給使用者。也就是說，根據預設，使用者不能使用 PIN 驗證存取系統。使用者可從電話撥入式會議網頁取得 PIN；或者，系統管理員可以使用 Set-CsClientPin 指令程式，將 PIN 指派給每位使用者。您可以利用 Set-CsClientPin，將特定的 PIN 指派給使用者，或允許 Lync Server 2010 為您產生 PIN。若要自動產生 PIN，只要在呼叫 Set-CsClientPin 時省略 PIN 參數即可。執行上述作業後，就會產生新的 PIN，當命令完成時，使用者 Identity 和其新的 PIN 將會出現在螢幕上。
請注意，您明確指派的 PIN 必須要和負責控管有問題之使用者的 PIN 驗證原則中的指定條件相符。例如，PIN 的位數至少必須和 MinPasswordLength 屬性指定的位數相等。另請注意，PIN 只能含有數字，不允許使用字母或其他非數字的字元。
當您使用 Set-CsClientPin 來設定用戶端 PIN 時，不會強制執行 PIN 歷程記錄計數。例如，假設使用者的 PIN 號碼是 12345，而其用戶端 PIN 原則會防止他們立即重複使用相同的 PIN 號碼。如果該使用者嘗試使用電話撥入式會議網頁來更新其用戶端 PIN，則任何嘗試重複使用相同 PIN 號碼 (12345) 的作業都將遭到拒絕。但是，透過使用 Set-CsClientPin，系統管理員可以將 PIN 12345 發給該使用者。這是因為 Set-CsClientPin 並未受到 PIN 原則歷程記錄計數所束縛。
請注意，當您安裝 Lync Server 2010 標準版時，預設不會啟用 SQL Server Express 的防火牆例外。這表示您將無法從 Windows PowerShell 的遠端執行個體執行 Set-CsClientPin；這是因為您的命令將無法周遊防火牆和存取 SQL Server Express 資料庫 (但是，您仍然可以在 Standard Edition 伺服器本機上執行指令程式)。若要在 Standard Edition 伺服器上遠端執行 Set-CsClientPin，您需要針對 SQL Server Express 手動啟用防火牆例外。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Set-CsClientPin Cmdlet：RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Set-CsClientPin"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
必要 |
UserIdParameter |
應為其設定 PIN 之使用者帳戶的 Identity。可以使用下列四種格式的其中一種來指定使用者識別：1) 使用者的 SIP 位址；2) 使用者的使用者主體名稱 (UPN)；3) 使用者的網域名稱和登入名稱，格式為 domain\logon (如 litwareinc\kenmyer)；4) 使用者的 Active Directory 顯示名稱 (如 Ken Myer)。也可以透過使用者的 Active Directory 辨別名稱來參考使用者識別。 此外，使用顯示名稱作為使用者 Identity 時，可以使用星號 (*) 萬用字元。例如，若 Identity 為 "* Smith"，則會傳回所有顯示名稱結尾為字串值 " Smith" 的使用者。 |
Pin |
選用 |
整數 |
要指派給使用者的選用 PIN。如果未包含 PIN 參數，Lync Server 2010 便會隨機產生 PIN 並指派給有問題的使用者。請注意，PIN 必須和指派給使用者之用戶端 PIN 原則中的長度下限及共同模式等設定相符。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果，但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Set-CsClientPin 接受代表使用者帳戶之 Identity 的管線傳送輸入字串值。此指令程式也接受已傳送的使用者物件輸入。
傳回類型
Set-CsClientPin 不會傳回值或物件。而是指令程式會設定 Microsoft.Rtc.Management.UserPinService.PinInfoDetails 物件的執行個體。
範例
-------------------------- 範例 1 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer"
在範例 1 中，已為使用者 litwareinc\kenmyer 指派新自動產生的 PIN。若要指派自動產生的 PIN，請在呼叫 Set-CsClientPin 時略過 Pin 參數。當命令完成後，指派給 Ken Myer 的新 PIN 便會出現在螢幕上，而系統也會將該資訊轉送給使用者。
-------------------------- 範例 2 ------------------------
Set-CsClientPin -Identity "litwareinc\kenmyer" -Pin 18723834
範例 2 中的命令可將 PIN 18723834 指派給使用者 litwareinc\kenmyer。您可以使用 Pin 參數後面加上要指派的號碼來指派特定的 PIN。
-------------------------- 範例 3 ------------------------
Get-CsUser -OU "OU=Finance,DC=litwareinc,DC=com" | Set-CsClientPin
範例 3 示範如何將新的 PIN 自動指派給指定 Active Directory 組織單位 (OU) 中的所有使用者。為達成此目的，會使用 Get-CsUser 搭配 OU 參數，以傳回 Finance OU 中所有擁有帳戶的使用者集合。接著將該集合傳送給 Set-CsClientPin，這會針對集合中的每位使用者產生新的 PIN。
-------------------------- 範例 4 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsPinSet -eq $False} | Set-CsClientPin
範例 4 所示的命令可將新的 PIN 指派給所有目前尚未有 PIN 指派的使用者。若要完成這項作業，使用 Get-CsUser 以傳回所有已啟用 Lync Server 2010 的使用者集合。接著將該集合傳送到 Get-CsClientPin 和 Where-Object 指令程式；您可以使用這兩個指令程式，只選取 IsPinSet 內容等於 False 的使用者。利用這種方法產生的集合只會包含沒有 PIN 的使用者，接著將該集合傳送到 Set-CsClientPin，其會為集合中的每位使用者自動產生 PIN。