Remove-SPSiteSubscriptionSettings

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

语法

FindAllOrphans

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

SpecifySiteSubscriptions

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

说明

此 cmdlet 包含多个参数集。 只能使用一个参数集中的参数,而不能结合使用不同参数集中的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集

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

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

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

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

示例 1

Remove-SPSiteSubscriptionSettings -FindAllOrphans -Whatif

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

示例 2

Remove-SPSubscriptionSettingsServiceApplication -FindAllOrphans -AlternativeSiteSubscriptions $SubscriptionList

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

参数

-AlternativeSiteSubscriptions

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

键入的值必须为有效 GUID 的数组。

参数属性

类型:

Guid[]

默认值:None
支持通配符:False
不显示:False

参数集

FindAllOrphans
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-AssignmentCollection

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

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

参数属性

类型:SPAssignmentCollection
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Confirm

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-FindAllOrphans

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

FindAllOrphans
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Force

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False

参数集

FindAllOrphans
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Identity

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

指定包含要删除的服务数据的网站 Subscription Settings Service 应用程序。

键入的值必须是有效的 GUID(格式为 12345678-90ab-cdef-1234-567890bcdefgh);或是 Subscription Settings Service 应用程序的有效名称(例如,SubscriptionSettingsApp1)或有效的 SPSubscriptionSettingsServiceApplication 对象的实例。

参数属性

类型:SPServiceApplicationPipeBind
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:1
必需:True
来自管道的值:True
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SiteSubscriptions

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

键入的值必须为有效 GUID 的数组。

参数属性

类型:

Guid[]

默认值:None
支持通配符:False
不显示:False

参数集

SpecifySiteSubscriptions
Position:Named
必需:True
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

适用:SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019

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

参数属性

类型:SwitchParameter
默认值:None
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters