Remove-CsPrivacyConfiguration
上一次修改主题： 2012-03-25
删除现有的隐私配置设置集合。隐私配置设置有助于确定用户向其他用户提供的信息量。
语法
Remove-CsPrivacyConfiguration -Identity <XdsIdentity> [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-Tenant <Nullable>] [-WhatIf [<SwitchParameter>]]
详细说明
通过 Microsoft Lync Server 2010，用户可以与其他人共享大量的状态信息：可以发布自己的照片；可以提供详细的位置信息；可以向组织中的所有人自动提供状态信息（而不是仅向用户联系人列表上的人员提供此信息）。
某些用户会乐于有机会向同事提供此信息；而其他用户可能不愿意共享此数据。（例如，许多人可能对在状态数据中提供其照片犹豫不决。）一般而言，用户可以控制他们将共享（或不共享）的信息；例如，用户可以选中或取消选中某个复选框以便控制是否与他人共享其位置信息。此外，通过隐私配置 cmdlet（Get-CsPrivacyConfiguration、Set-CsPrivacyConfiguration、New-CsPrivacyConfiguration 和 Remove-CsPrivacyConfiguration），管理员可以管理其用户的隐私设置。在某些情况下，管理员可以启用或禁用设置。例如，如果将属性 AutoInitiateContacts 设置为 True，则会将团队成员自动添加到每个用户的联系人列表；如果将此属性设置为 False，则不会将团队成员自动添加到每个用户的联系人列表。
在其他情况下，管理员可以在 Lync 2010 中配置默认值，同时还向用户授予更改这些值的权限。例如，默认情况下将发布用户的位置数据，但用户有权停止发布位置。通过将 PublishLocationDataByDefault 属性设置为 False，管理员可以更改此行为：此时，默认情况下不会发布位置数据，但用户仍将有权按照自己的意愿发布此数据。
可以在 global 作用域、site 作用域和 service 作用域（但仅限用户服务器服务）应用隐私配置设置。Remove-CsPrivacyConfiguration cmdlet 提供了一种方法，用于删除在 site 作用域或 service 作用域配置的设置；例如，如果针对在 site 作用域配置的设置运行此 cmdlet，则会删除这些设置，并且该站点中的用户的隐私设置将由全局集合管理。此外，也可以针对全局集合运行 Remove-CsPrivacyConfiguration；但是，不会删除全局集合。该集合中的所有属性都将重置为其默认值。例如，假设您以前将 EnablePrivacyMode 属性更改为 True。现在，如果“删除”全局集合，则 EnablePrivacyMode 将还原为其默认值 False。
谁能运行此 cmdlet：默认情况下，以下各组的成员有权在本地运行 Remove-CsPrivacyConfiguration cmdlet：RTCUniversalServerAdmins。要返回分配了此 cmdlet 的所有基于角色的访问控制 (RBAC) 角色列表（包括您自己创建的任何自定义 RBAC 角色），请从 Windows PowerShell 提示符处运行以下命令：
Get-CsAdminRole | Where-Object {$_.Cmdlets –match "Remove-CsPrivacyConfiguration"}
参数
| 参数 | 必需 | 类型 | 描述 |
|---|---|---|---|
Identity |
必需 |
Xds 标识 |
要删除的隐私配置设置的唯一标识符。要删除在 site 作用域配置的设置，请使用以下类似语法：-Identity site:Redmond。要删除服务级别的设置，请使用以下类似语法：-Identity service:UserServer:atl-cs-001.litwareinc.com。 此外，也可以针对全局设置集合运行 Remove-CsPrivacyConfiguration。但是在这种情况下，将不会删除全局设置。该集合中的所有属性都将重置为其默认值。 |
Tenant |
可选 |
GUID |
此参数不用于 Lync Server 2010 的内部部署版本。 |
Force |
可选 |
开关参数 |
禁止显示运行此命令时可能出现的任何非严重错误消息。 |
WhatIf |
可选 |
开关参数 |
描述如果执行命令会发生什么情况（无需实际执行命令）。 |
Confirm |
可选 |
开关参数 |
在执行命令之前提示您进行确认。 |
输入类型
Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.PrivacyConfiguration 对象。Remove-CsPrivacyConfiguration 接受通过管道传递的隐私配置对象的输入。
返回类型
无。Remove-CsPrivacyConfiguration 会删除 Microsoft.Rtc.Management.WritableConfig.Settings.UserServices.PrivacyConfiguration 对象的现有实例。
示例
-------------------------- 示例 1 --------------------------
Remove-CsPrivacyConfiguration -Identity site:Redmond
上述命令返回分配给 Redmond 站点的隐私配置设置。删除这些设置之后，Redmond 站点中的用户将自动继承全局隐私配置设置。
-------------------------- 示例 2 --------------------------
Get-CsPrivacyConfiguration -Filter "site:*" | Remove-CsPrivacyConfiguration
在示例 2 中，将删除在 site 作用域分配的所有隐私配置设置。为执行此操作，该命令首先调用带有 Filter 参数的 Get-CsPrivacyConfiguration；筛选器值“site:*”可确保仅返回 Identity 以字符“site”开头的设置。然后，将筛选出的集合通过管道传递到 Remove-CsPrivacyConfiguration，后者会删除集合中的每一项。
-------------------------- 示例 3 --------------------------
Get-CsPrivacyConfiguration | Where-Object {$_.EnablePrivacyMode -eq $False} | Remove-CsPrivacyConfiguration
示例 3 中显示的命令删除已禁用隐私模式的所有隐私配置设置。为了执行此任务，该命令首先调用不带任何参数的 Get-CsPrivacyConfiguration；这将返回组织中使用的所有隐私配置设置的集合。然后，将该集合通过管道传递到 Where-Object cmdlet，后者会仅选择 EnablePrivacyMode 属性等于 False 的设置。将筛选出的集合通过管道传递到 Remove-CsPrivacyConfiguration，后者将删除集合中的每一项。