Get-CsClientPolicy
上次修改主題的時間： 2012-03-23
傳回針對在組織中使用而設定之用戶端原則的相關資訊。除了在其他方面的功用之外，用戶端原則還能用來決定供使用者使用的 Microsoft Lync 2010 功能。例如，您可能會將傳輸檔案的權限授與某些使用者，然而卻拒絕將相同權限授與其他使用者。
語法
Get-CsClientPolicy [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>]
Get-CsClientPolicy [-Filter <String>] [-LocalStore <SwitchParameter>]
詳細描述
在 Lync Server 2010 中，用戶端原則取代了舊版產品中所使用的「群組原則」設定。在 Microsoft Office Communicator 2007 和 Microsoft Office Communicator 2007 R2 中，可使用「群組原則」協助決定使用者可以用 Communicator 做些什麼；例如，「群組原則」設定決定使用者是否可以儲存其立即訊息交談的記錄、來自 Microsoft Outlook 的資訊是否整合到他們的目前狀態資訊，以及使用者是否可以在立即訊息中加入表情或格式化文字。
儘管「群組原則」如此有用，它在技術上仍有限制，尤其是在套用到 Lync Server 2010 時。首先，「群組原則」的設計是根據個別網域或個別組織單位 (OU) 而套用原則；這使得它很難將原則套用到更精確選取的使用者群組 (例如，在特定部門工作的所有使用者，或是所有有特定工作職稱的使用者)。另一方面，[群組原則] 只會套用到登入網域且使用電腦登入的使用者；[群組原則] 不會套用到透過網際網路或使用行動電話存取系統的使用者。這就表示，同一名使用者隨著登入裝置以及登入位置的不同，就會有不同的使用經驗。
為了解決這些不一致的問題，Lync Server 2010 會使用用戶端管理原則而不是「群組原則」。用戶端原則會在使用者每一次存取系統時套用，不管使用者從何處登入以及使用何種裝置登入。此外，用戶端原則 (如同其他 Lync Server 2010 原則) 很容易便可套用到選取的使用者群組。您甚至可以建立指派給單一使用者的自訂原則。
用戶端原則可在通用、站台和個別使用者範圍設定。Get-CsClientPolicy 指令程式可讓您針對在組織中使用而設定的所有用戶端原則，傳回這些原則的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsClientPolicy Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsClientPolicy"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要傳回之用戶端原則的唯一識別碼。若要參考通用原則，請使用此語法：-Identity global。若要參考網站原則，請使用類似如下的語法：-Identity site:Redmond。若要參考個別使用者原則，請使用類似如下的語法：-Identity SalesDepartmentPolicy。 如果省略這個參數，則會傳回所有針對在組織中使用而設定的用戶端原則。 |
Filter |
選用 |
字串 |
可讓您在指定要傳回的原則時使用萬用字元。例如，若要傳回所有在站台範圍內設定的原則，請使用下列語法：-Filter "site:*"。若要傳回所有個別使用者原則的集合，請使用下列語法：-Filter "tag:*"。 |
LocalStore |
選用 |
切換參數 |
從中央管理存放區本機複本擷取用戶端原則資料，而不是從中央管理存放區本身擷取。 |
輸入類型
無。Get-CsClientPolicy 不會接受管線傳送的輸入。
傳回類型
Get-CsClientPolicy 會傳回 Microsoft.Rtc.Management.WritableConfig.Policy.Client.ClientPolicy 物件的執行個體。
範例
-------------------------- 範例 1 --------------------------
Get-CsClientPolicy
在上述範例中，Get-CsClientPolicy 是在未搭配其他任何參數的情況下呼叫的；如此會傳回已設定用於組織之所有用戶端原則的集合。
-------------------------- 範例 2 --------------------------
Get-CsClientPolicy -Identity SalesPolicy
在範例 2 中，Get-CsClientPolicy 是用來傳回 Identity 為 SalesPolicy 的個別使用者用戶端原則。由於是唯一的識別身分，因此這個命令永遠只會傳回一個項目。
-------------------------- 範例 3 --------------------------
Get-CsClientPolicy -Filter "tag:*"
範例 3 使用 Filter 參數來傳回所有在個別使用者範圍內設定的用戶端原則。篩選值 "tag:*" 會要求 Get-CsClientPolicy 只傳回 Identity 開頭為字串值 "tag:" 的原則。
-------------------------- 範例 4 --------------------------
Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True}
上述命令會傳回所有 DisableSavingIM 屬性為 True 的用戶端原則集合。為達成此目的，此命令會先呼叫沒有任何參數的 Get-CsClientPolicy，以傳回針對在組織中使用而設定的所有用戶端原則集合。接著，這個集合會傳送到 Where-Object 指令程式，這樣只會選取 DisableSavingIM 屬性等於 True 的原則。
-------------------------- 範例 5 --------------------------
Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -and $_.EnableIMAutoArchiving -eq $False}
在範例 5 中，只會傳回滿足下列兩個準則的用戶端原則：DisableSavingIM 屬性必須為 True 且 EnableIMAutoArchiving 屬性必須為 False。為達成此目的，此命令需要先呼叫 Get-CsClientPolicy，以傳回針對在組織中使用而設定的所有用戶端原則集合。接著，系統會將這個集合傳送到 Where-Object 指令程式；該指令程式只會挑選同時滿足下列準則的原則：DisableSavingIM 必須等於 True 且 EnableIMAutoArchiving 必須等於 False。-and 運算子會要求 Where-Object 只選取滿足所有指定之準則的物件。
-------------------------- 範例 6 --------------------------
Get-CsClientPolicy | Where-Object {$_.DisableSavingIM -eq $True -or $_.EnableIMAutoArchiving -eq $False}
範例 6 是範例 5 所示之命令的變化。不過這次只要滿足下列至少一項準則的原則均會獲得選取：DisableSavingIM 內容為 True 和/或 EnableIMAutoArchiving 內容為 False。若要完成這項作業，該命令需要先呼叫 Get-CsClientPolicy，以傳回針對在組織中使用而設定的所有用戶端原則集合。接著，系統會將這個集合傳送到 Where-Object 指令程式；該指令程式只會挑選至少滿足下列任一項準則的原則：DisableSavingIM 等於 True 和/或 EnableIMAutoArchiving 等於 False。-or 運算子會要求 Where-Object 選取所有至少滿足一項指定條件的物件。