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 |
管理对象以便正确进行处理。使用 SPWeb 或 SPSite 等对象可能会耗用大量内存,而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。通过使用 SPAssignment 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时,如果不使用分配集合或 Global 参数,则会自动处理这些对象。 ![]()
在使用 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