Get-CsPinPolicy
上次修改主題的時間： 2012-03-23
傳回已設定在組織中使用之用戶端個人識別碼 (PIN) 原則的相關資訊。PIN 驗證可讓使用者提供 PIN (而不是使用者名稱和密碼) 來存取 Microsoft Lync Server 2010。
語法
Get-CsPinPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsPinPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
Lync Server 2010 可讓使用者連線至系統，或透過電話加入公用交換電話網路 (PSTN) 會議。登入系統或加入會議通常都需要使用者輸入使用者名稱或密碼；不過，如果您使用的電話沒有英數字元鍵盤，就會產生輸入使用者名稱和密碼的問題。基於上述考量，Lync Server 2010 可讓您將僅由數字組成的 PIN 提供給使用者。當出現提示時，使用者只要輸入 PIN 便能登入系統或加入會議，完全不需要使用者名稱和密碼。
Lync Server 使用 PIN 原則來管理 PIN 驗證屬性。例如，您可以指定 PIN 的長度下限，以及決定是否將允許使用「共同模式」(例如，連續數字) 的 PIN (例如，像是 123456 的 PIN)。您可以使用 Get-CsPinPolicy 指令程式，來擷取設定為目前要在組織內使用之 PIN 原則的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsPinPolicy Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPinPolicy"}
參數
| 參數 | 必要 | 類型 | 說明 |
|---|---|---|---|
Identity |
選用 |
Xds 識別碼 |
在建立原則時要指派給它的唯一 Identity。PIN 原則可以在通用、網站或個別使用者範圍指派。若要參考通用執行個體，請使用此語法：-Identity global。若要參考網站範圍的原則，請使用以下的語法：-Identity site:Redmond。若要在每個使用者範圍上參考原則，請使用類似下列的語法：-Identity RedmondPolicy. Identity 參數不能使用萬用字元，例如星號 (*)。若要以萬用字元搜尋原則，請改用 Filter 參數。 如果未指定 Identity 或 Filter 參數，Get-CsPinPolicy 會傳回已設定在組織中使用的所有 PIN 原則的相關資訊。 |
Filter |
選用 |
字串 |
可讓您針對 PIN 原則進行萬用字元搜尋。例如，若要在網站範圍尋找設定的所有原則，請使用下列 Filter：site:*。若要尋找網站原則 Seattle、Seville 以及 Saskatoon (開頭皆為字母 "S")，請使用此篩選：site:S*。請注意，此參數只能依據 Identity 內容來篩選。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區的本機複本擷取 PIN 原則資料，而非從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsPinPolicy 不接受管線傳送的輸入。
傳回類型
Get-CsPinPolicy 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.UserPin.UserPinPolicy物件的一或多個執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsPinPolicy
範例 1 所示的命令會傳回設定為在組織中使用之所有 PIN 原則的集合。呼叫 Get-CsPinPolicy 而不指定任何參數時，一律會傳回一組完整的 PIN 原則。
-------------------------- 範例 2 ------------------------
Get-CsPinPolicy -Identity "site:Redmond"
範例 2 會傳回單一 PIN 原則：Identity 為 site:Redmond 的原則。
-------------------------- 範例 3 ------------------------
Get-CsPinPolicy -Filter "tag:*"
範例 3 所示的命令會使用 Filter 參數傳回已在個別使用者範圍設定的所有原則。您可以使用篩選值 "tag:*" 來完成此工作；這個值會指示 Get-CsPinPolicy 僅傳回 Identity 開頭為字元 "tag:" 的原則。
-------------------------- 範例 4 ------------------------
Get-CsPinPolicy | Where-Object {$_.AllowCommonPatterns -eq $True}
範例 4 傳回 AllowCommonPatterns 內容為 True 的所有 PIN 原則。在此範例中，會呼叫不含任何額外參數的 Get-CsPinPolicy；這樣會傳回設定為在組織中使用之所有 PIN 原則的集合。接著，該集合會傳遞到 Where-Object 指令程式，只挑出 AllowCommonPatterns 屬性等於 True 的原則。
-------------------------- 範例 5 ------------------------
Get-CsPinPolicy | Where-Object {$_.PinLifetime -gt 30}
與範例 4 相同，範例 5 所示的命令會使用 Where-Object 傳回現有 PIN 原則的子集。在此例中，Where-Object 只會擷取 PinLifetime 屬性大於 30 的原則。也就是說，只會傳回 PIN 到期時間大於 30 天的原則。