Remove-SPSiteSubscriptionSettings

适用于: SharePoint Foundation 2010, SharePoint Server 2010

上一次修改主题: 2015-03-09

删除指定网站订阅的设置服务数据,或查找并删除孤立的数据。

Syntax

Remove-SPSiteSubscriptionSettings [-Identity] <SPServiceApplicationPipeBind> -SiteSubscriptions <Guid[]> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-WhatIf [<SwitchParameter>]]

Remove-SPSiteSubscriptionSettings [-Identity] <SPServiceApplicationPipeBind> -FindAllOrphans <SwitchParameter> [-AlternativeSiteSubscriptions <Guid[]>] [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-Force <SwitchParameter>] [-WhatIf [<SwitchParameter>]]

详细说明

Remove-SPSiteSubscriptionSettings cmdlet 可删除指定网站订阅的网站订阅存储数据。如果指定 FindAllOrphans 参数,则此 cmdlet 将在服务应用程序中查找本地网站订阅列表或订阅备用列表中不存在的所有数据。

可以直接指定网站订阅集,也可以通过将服务应用程序中的数据与现有网站订阅集进行比较,以找到与不存在的网站订阅对应的数据集来发现网站订阅集。

重要

如果在联合服务应用程序上运行此 cmdlet,而不指定与 AlternativeSiteSubscriptions 参数相对应的网站订阅 ID 的完整列表,可能导致数据丢失。

Parameters

参数 必需 类型 说明

Identity

必需

Microsoft.SharePoint.PowerShell.SPServiceApplicationPipeBind

指定包含要删除的服务数据的网站订阅设置服务应用程序。

类型必须是有效的 GUID(格式为 12345678-90ab-cdef-1234-567890bcdefgh);或是订阅设置服务应用程序的有效名称(例如,SubscriptionSettingsApp1)或有效的 SPSubscriptionSettingsServiceApplication 对象的实例。

FindAllOrphans

必需

System.Management.Automation.SwitchParameter

指定将删除服务应用程序中的孤立设置存储。

SiteSubscriptions

必需

System.Guid[]

指定其中包含要删除的设置服务数据的网站订阅。

类型必须为有效 GUID 的数组。

AlternativeSiteSubscriptions

可选

System.Guid[]

指定设置服务应用程序中应存在的网站订阅的完整集合或逗号分隔列表。将删除与此列表中的项不匹配的所有数据。

使用 FindAllOrphans 参数时,此参数非常重要。为 AlternativeSiteSubscriptions 参数指定的值指明将删除本地服务器场上不存在的所有网站订阅,除非提供网站订阅的备用列表。

类型必须为有效 GUID 的数组。

AssignmentCollection

可选

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

管理对象以便正确进行处理。使用 SPWebSPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWebSPSiteSPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。

注意Note
在使用 Global 参数时,所有对象均包含在全局存储中。如果未立即使用对象,或未通过使用 Stop-SPAssignment 命令来处理对象,则可能会发生内存不足的情况。

Confirm

可选

System.Management.Automation.SwitchParameter

在执行命令之前提示您确认。有关详细信息,请键入以下命令:get-help about_commonparameters

Force

可选

System.Management.Automation.SwitchParameter

操作前自动绕过 cmdlet 提供的辅助警告。

WhatIf

可选

System.Management.Automation.SwitchParameter

显示一条描述命令作用的消息,而不执行命令。有关详细信息,请键入以下命令:get-help about_commonparameters

输入类型

返回类型

错误

错误 说明

Exceptions

异常 说明

Example

------------------示例 1-----------------------

Remove-SPSiteSubscriptionSettings -FindAllOrphans -Whatif

此示例查找所有孤立的数据,并将它们显示在屏幕上。删除 WhatIf 参数可删除这些额外设置。

------------------示例 2-----------------------

Remove-SPSubscriptionSettingsServiceApplication -FindAllOrphans -AlternativeSiteSubscriptions $SubscriptionList

如果服务应用程序由远程服务器场使用,并且您希望清除孤立网站订阅设置数据,请使用此示例(将其数据必须保留在服务器应用程序中的所有网站订阅的数组分配给 $SubscriptionList 变量)。

See Also

Reference

Import-SPSiteSubscriptionSettings
Export-SPSiteSubscriptionSettings