Unlock-CsClientPin
上次修改主題的時間: 2012-03-24
讓系統管理員能夠解除鎖定特定使用者的個人識別碼 (PIN)。
語法
Unlock-CsClientPin -Identity <UserIdParameter> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]
詳細描述
Lync Server 2010 可讓使用者透過電話連接系統或加入公用交換電話網路 (PSTN) 會議。登入系統或加入會議通常需要使用者輸入使用者名稱或密碼。但是,如果您使用的是沒有英數字元鍵盤的電話,輸入使用者名稱和密碼將會是一大難題。基於上述考量,Lync Server 2010 可讓您將僅由數字組成的 PIN 提供給使用者。當出現提示時,使用者只要輸入 PIN 便能登入系統或加入會議,完全不需要使用者名稱和密碼。
但是,唯有當使用者的 PIN 已解除鎖定時,此條件才會成立。如果 PIN 號碼已遭鎖定 (可能是因為使用者重複登入失敗,或者因為系統管理員明確鎖定該 PIN),該使用者將無法使用 PIN 驗證來存取系統或加入會議 (但該使用者仍能透過提供使用者名稱和密碼的方式,使用諸如 Microsoft Lync 2010 的應用程式來登入系統)。如果某個 PIN 已遭鎖定,則只有一個方法可以還原使用者使用 PIN 驗證來存取系統的能力:必須由系統管理員解除鎖定該鎖定的 PIN。使用 Unlock-CsClientPin 指令程式可達成此目的。
請注意,當您安裝 Lync Server 2010 標準版時,預設不會啟用 SQL Server Express 的防火牆例外。這代表您無法從 Windows PowerShell 的遠端執行個體執行 Unlock-CsClientPin;這是因為您的命令無法周遊防火牆並存取 SQL Server Express 資料庫 (但是,您仍然可以在 Standard Edition 伺服器本機上執行指令程式)。您必須手動啟用 SQL Server Express 的防火牆例外,才能針對 Standard Edition 伺服器在遠端執行 Unlock-CsClientPin。
誰可以執行此 Cmdlet:下列群組的成員預設會獲授權可以在本機上執行 Unlock-CsClientPin Cmdlet:RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色),請在 Windows PowerShell 提示字元中執行下列命令:
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Unlock-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" 的使用者。 |
Force |
選用 |
切換參數 |
隱藏顯示當執行命令時可能發生的任何非嚴重錯誤訊息。 |
WhatIf |
選用 |
切換參數 |
描述執行命令後的結果,但無須實際執行命令。 |
Confirm |
選用 |
切換參數 |
執行命令前先要求您確認。 |
輸入類型
字串值或 Microsoft.Rtc.Management.ADConnect.Schema.ADUser 物件。Unlock-CsClientPin 會接受代表使用者帳戶 Identity 之字串值的管線傳送資料。此指令程式也接受已傳送的使用者物件輸入。
傳回類型
Unlock-CsClientPin 不會傳回值或物件。而是此指令程式會設定 Microsoft.Rtc.Management.UserPinService.PinInfoDetails 物件的一或多個執行個體。
範例
-------------------------- 範例 1 ------------------------
Unlock-CsClientPin -Identity "litwareinc\kenmyer"
在範例 1 中,使用 Unlock-CsClientPin 來解除鎖定隸屬於使用者 litwareinc\kenmyer 的 PIN。
-------------------------- 範例 2 ------------------------
Get-CsUser | Get-CsClientPinInfo | Where-Object {$_.IsLockedOut -eq $True} | Unlock-CsClientPin
在上述範例中,Unlock-CsClientPin 用來解除鎖定目前已鎖定的所有 PIN。為達成此目的,會先使用 Get-CsUser 來傳回已啟用 Lync Server 2010 之所有使用者的集合。然後將該集合傳送到 Get-CsClientPinInfo,該指令程式會與 Where-Object 指令程式搭配使用,藉此僅選取 IsLockedOut property 等於 (-eq) True ($True) 的使用者。
所產生的篩選集合接著會被傳送到 Unlock-CsClientPin,該指令程式會針對先前已遭鎖定 PIN 的每位使用者,解除鎖定 PIN。