Test-SPContentDatabase

测试内容数据库。

语法

Test-SPContentDatabase
    [-Identity] <SPContentDatabasePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-DatabaseCredentials <PSCredential>]
    [-ExtendedCheck]
    [-ServerInstance <SPDatabaseServiceInstancePipeBind>]
    [-ShowLocation]
    [-ShowRowCounts]
    [<CommonParameters>]
Test-SPContentDatabase
    -Name <String>
    -WebApplication <SPWebApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-DatabaseCredentials <PSCredential>]
    [-ExtendedCheck]
    [-ServerInstance <SPDatabaseServiceInstancePipeBind>]
    [-ShowLocation]
    [-ShowRowCounts]
    [<CommonParameters>]

说明

此 cmdlet 包含多个参数集。 您可以只使用来自一个参数集的参数,也可以不合并来自不同参数集的参数。 若要详细了解如何使用参数集,请参阅 Cmdlet 参数集

Test-SPContentDatabase使用 cmdlet 针对 Web 应用程序测试内容数据库,以验证内容数据库中引用的所有自定义项是否也安装在 Web 应用程序中。 此 cmdlet 可以对当前连接到服务器场的内容数据库发出,也可以对未连接到服务器场的内容数据库发出。 它可以用来从 SharePoint 2010 产品以及从 SharePoint 产品和技术测试内容数据库。

cmdlet Test-SPContentDatabase 不会更改内容数据库的任何数据或结构,但可能会在检查过程中导致数据库负载,这可能会暂时阻止使用内容数据库。 此 cmdlet 应该只对当前使用率较低,或未在使用的内容数据库使用。

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

示例

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

Test-SPContentDatabase -name WSS_Content_DB -webapplication https://sitename

此示例针对 sitename Web 应用程序测试WSS_Content_DB内容数据库,并返回问题列表。

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

$DB = Get-SPContentDatabase -site https://contoso.com
Test-SPContentDatabase $DB -showrowcounts

此示例获取包含 的网站集 https://contoso.com 的内容数据库,然后针对托管该集合的 Web 应用程序测试该数据库以确定问题。 除了显示问题列表之外,因为指定了 ShowRowCounts 参数,所以此 cmdlet 还将从内容数据库返回表大小度量。

参数

-AssignmentCollection

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

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

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-DatabaseCredentials

指定包含要用于数据库 SQL Server 身份验证的用户名和密码的 PSCredential 对象。

键入的值必须是有效的 PSCredential 对象。

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ExtendedCheck

在数据库附加升级过程中检查不一致的身份验证模式。

在两个版本中,选定模式(声明模式或经典模式)必须相同。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

将现有的已连接的 SharePoint 内容数据库指定为 GUID 或数据库名称(如果唯一)格式的两个参数集之一。

Type:SPContentDatabasePipeBind
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Name

指定要测试的现有内容数据库。

键入的值必须是有效的 SharePoint 内容数据库名称;例如,SPContentDB1。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ServerInstance

指定要用来测试指定内容数据库的数据库服务的实例。

键入的值必须为有效的 GUID,如 12345678-90ab-cdef-1234-567890bcdefgh;SQL Server 实例的有效名称(例如,DBSvrInstance1);或者有效 SPDatabaseServiceInstance 对象的实例。

Type:SPDatabaseServiceInstancePipeBind
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ShowLocation

指定数据库中将使用缺少的模板和功能的位置。 通常情况下,报告的位置限定在指定的内容数据库内的网站集中。

使用此参数会显著增加完成测试过程的时间。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-ShowRowCounts

返回数据库统计信息,在内容数据库的表中是指行计数。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-WebApplication

指定要用来测试内容数据库的 SharePoint Web 应用程序。

键入的值必须为 12345678-90ab-cdef-1234-567890bcdefgh 形式的有效 GUID;SharePoint Web 应用程序的有效名称(例如,MyOfficeApp1);或者有效 SPWebApplication 对象的实例。

Type:SPWebApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019