Get-CsPrivacyConfiguration
上次修改主題的時間： 2012-03-23
傳回組織目前所使用之隱私組態設定的相關資訊。隱私權組態設定可協助決定使用者能將多少資訊提供給其他的使用者。
語法
Get-CsPrivacyConfiguration [-Identity <XdsIdentity>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
Get-CsPrivacyConfiguration [-Filter <String>] [-LocalStore <SwitchParameter>] [-Tenant <Nullable>]
詳細描述
Microsoft Lync Server 2010 可以提供使用者與其他人共用大量目前狀態資訊的機會：他們可以發佈自己的照片、提供詳細的位置資訊，並將自己的目前狀態資訊自動提供給組織內的每一個人 (而不是只將此資訊提供給其連絡人清單上的人)。
有些使用者很高興有這個機會能將此資訊提供給他們的同事，但也有一些使用者不願意分享此資料(例如，許多人對於將他們的照片放在目前狀態資料中會有疑慮)。一般而言，使用者可控制是否分享哪些資訊，例如使用者可勾選或取消勾選核取方塊，來控制是否要與他人分享其位置資訊。此外，隱私權組態指令程式 (Get-CsPrivacyConfiguration、Set-CsPrivacyConfiguration、New-CsPrivacyConfiguration 和 Remove-CsPrivacyConfiguration) 可讓系統管理員管理使用者的隱私權設定。在某些情況下，系統管理員可以啟用或停用設定；例如，如果 AutoInitiateContacts 屬性設為 True，則會將小組成員自動新增至每個使用者的連絡人清單中；如果設為 False，則不會將小組成員自動新增至每個使用者的連絡人清單中。
在其他狀況下，系統管理員可在 Lync Server 2010 中設定預設值，同時仍讓使用者有權利變更這些值。例如會預設發佈使用者的位置資料，但使用者有權利停止發佈位置。透過將 PublishLocationDataByDefault 屬性設為 False，系統管理員可變更此行為：在此狀況下，預設不會發佈位置資料，但使用者仍有權利選擇發佈此資料。
隱私權組態設定會套用在全域範圍、站台範圍與服務範圍 (雖然僅適用於 User Server 服務)。Get-CsPrivacyConfiguration 指令程式讓您能夠擷取組織目前所使用之所有隱私組態設定的相關資訊。
誰可以執行此 Cmdlet：下列群組的成員預設會獲授權可以在本機上執行 Get-CsPrivacyConfiguration Cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。若要傳回所有獲指派此 Cmdlet 的角色存取控制 (RBAC) 角色清單 (包括您自行建立的自訂 RBAC 角色)，請在 Windows PowerShell 提示字元中執行下列命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPrivacyConfiguration"}
參數
| 參數 | 必要 | 類型 | 描述 |
|---|---|---|---|
Identity |
選用 |
Xds 識別身份 |
要擷取之隱私組態設定的唯一識別碼。若要傳回通用設定，請使用此語法：-Identity global。若要傳回在此站台範圍設定的設定，請使用如下的語法：-Identity site:Redmond。若要修改服務層級的設定，請使用如下的語法：-Identity service:UserServer:atl-cs-001.litwareinc.com 如果未指定此參數，則 Get-CsPrivacyConfiguration 會傳回組織目前所使用的所有隱私組態設定。 |
Filter |
選用 |
字串 |
讓您能夠使用萬用字元，傳回一或多個隱私組態設定的集合。例如，若要傳回已在站台範圍內設定的所有設定，您可以使用下列語法：-Filter "site:*"。若要傳回在服務範圍所設定的所有設定，請使用此語法：-Filter "service:*"。 |
Tenant |
選用 |
GUID |
這個參數不會與內部部署的 Lync Server 2010 版本搭配使用。 |
LocalStore |
選用 |
切換參數 |
從 中央管理存放區 的本機複本擷取私密性組態資料，而非從 中央管理存放區 本身擷取。 |
輸入類型
無。Get-CsPrivacyConfiguration 不會接受管線傳送的資料。
傳回類型
Get-CsPrivacyConfiguration 會傳回 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.PrivacyConfiguration 物件的現有執行個體。
範例
-------------------------- 範例 1 ------------------------
Get-CsPrivacyConfiguration
範例 1 所示的命令會傳回組織目前所使用的所有隱私組態設定。
-------------------------- 範例 2 ------------------------
Get-CsPrivacyConfiguration -Identity site:Redmond
上述命令會傳回隱私組態設定的單一集合：Identity 為 site:Redmond 的設定。
-------------------------- 範例 3 ------------------------
Get-CsPrivacyConfiguration -Filter "site:*"
在範例 3 中，會傳回所有已在站台範圍內指派之所有隱私組態設定的相關資訊。為達成此目的，會加上 Filter 參數並搭配篩選值 "site:*"。該篩選值確保只會包含 Identity (您可以篩選的唯一屬性) 是以字元 "site:" 開頭的設定。
-------------------------- 範例 4 ------------------------
Get-CsPrivacyConfiguration | Where-Object {$_.EnablePrivacyMode -eq $True}
範例 4 所示的命令會傳回已啟用隱私模式之所有隱私組態設定的相關資訊。這可藉由先呼叫 Get-CsPrivacyConfiguration 且不搭配任何參數，以傳回所有隱私設定的集合來完成。接著，此集合會傳送到 Where-Object 指令程式，這樣只會挑出 EnablePrivacyMode 屬性等於 True 的設定。