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，用户可以与其他人共享大量的状态信息：可以发布自己的照片；可以提供详细的位置信息；可以向组织中的所有人自动提供状态信息（而不是仅向用户联系人列表上的人员提供此信息）。
某些用户会乐于有机会向同事提供此信息；而其他用户可能不愿意共享此数据。（例如，许多人可能对在状态数据中提供其照片犹豫不决。）一般而言，用户可以控制他们将共享（或不共享）的信息；例如，用户可以选中或取消选中某个复选框以便控制是否与他人共享其位置信息。此外，通过隐私配置 cmdlet（Get-CsPrivacyConfiguration、Set-CsPrivacyConfiguration、New-CsPrivacyConfiguration 和 Remove-CsPrivacyConfiguration），管理员可以管理其用户的隐私设置。在某些情况下，管理员可以启用或禁用设置；例如，如果将属性 AutoInitiateContacts 设置为 True，则会将团队成员自动添加到每个用户的联系人列表；如果将此属性设置为 False，则不会将团队成员自动添加到每个用户的联系人列表。
在其他情况下，管理员可以在 Lync Server 2010 中配置默认值，同时还向用户授予更改这些值的权限。例如，默认情况下将发布用户的位置数据，但用户有权停止发布位置。通过将 PublishLocationDataByDefault 属性设置为 False，管理员可以更改此行为：此时，默认情况下不会发布位置数据，但用户仍将有权按照自己的意愿发布此数据。
可以在 global 作用域、site 作用域和 service 作用域（但仅限用户服务器服务）应用隐私配置设置。通过 Get-CsPrivacyConfiguration cmdlet，可以检索有关组织中当前正在使用的所有隐私配置设置的信息。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Get-CsPrivacyConfiguration cmdlet：RTCUniversalUserAdmins、RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Get-CsPrivacyConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
可选 |
Xds 标识 |
要检索的隐私配置设置的唯一标识符。要返回全局设置，请使用以下语法：-Identity global。要返回在 site 作用域配置的设置，请使用以下类似语法：-Identity site:Redmond。要修改服务级别的设置，请使用以下类似语法：-Identity service:UserServer:atl-cs-001.litwareinc.com 如果不指定此参数，则 Get-CsPrivacyConfiguration 将返回组织中当前正在使用的所有隐私配置设置。 |
Filter |
可选 |
字符串 |
使您可以使用通配符返回一个或多个隐私配置设置的集合。例如，要返回在 site 作用域配置的所有设置，可以使用以下语法：-Filter "site:*"。要返回在 service 作用域配置的所有设置，请使用以下语法：-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 中，返回在 site 作用域分配的所有隐私配置设置的信息。为执行此操作，包含 Filter 参数且筛选器值为“site:*”。该筛选器值可确保仅返回 Identity（可作为筛选依据的唯一属性）以字符“site:”开头的设置。
-------------------------- 示例 4 --------------------------
Get-CsPrivacyConfiguration | Where-Object {$_.EnablePrivacyMode -eq $True}
示例 4 中显示的命令返回有关已启用隐私模式的所有隐私配置设置的信息。为执行此操作，首先调用不带任何参数的 Get-CsPrivacyConfiguration 以返回所有隐私设置的集合。然后，将此集合通过管道传递给 Where-Object cmdlet，后者仅挑选出 EnablePrivacyMode 属性等于 True 的那些设置。