Test-SPContentDatabase

콘텐츠 데이터베이스를 테스트합니다.

Syntax

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>]

Description

이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 세트를 사용하는 방법에 대한 자세한 내용은 Cmdlet 매개 변수 세트를 참조하세요.

cmdlet을 Test-SPContentDatabase 사용하여 웹 애플리케이션에 대해 콘텐츠 데이터베이스를 테스트하여 콘텐츠 데이터베이스 내에서 참조되는 모든 사용자 지정이 웹 애플리케이션에도 설치되어 있는지 확인합니다. 현재 팜에 연결되어 있는 콘텐츠 데이터베이스나 팜에 연결되지 않은 콘텐츠 데이터베이스에 대해 이 cmdlet을 실행할 수 있습니다. 이 cmdlet을 사용하여 SharePoint 2010 제품 및 SharePoint 제품 및 기술에서 콘텐츠 데이터베이스를 테스트할 수 있습니다.

cmdlet은 Test-SPContentDatabase 콘텐츠 데이터베이스의 데이터 또는 구조를 변경하지 않지만 검사가 진행되는 동안 데이터베이스에 부하가 발생할 수 있으므로 콘텐츠 데이터베이스의 사용을 일시적으로 차단할 수 있습니다. 현재 사용량이 적거나 사용되지 않는 콘텐츠 데이터베이스에 대해서만 이 cmdlet을 사용해야 합니다.

SharePoint 제품용 Windows PowerShell에 대한 사용 권한 및 최신 정보는 SharePoint Server Cmdlets를 참조하세요.

예제

---------------예제 1---------------

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

다음은 사이트 이름 웹 애플리케이션에 대해 WSS_Content_DB 콘텐츠 데이터베이스를 테스트하고 문제 목록을 반환하는 예제입니다.

---------------예제 2---------------

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

이 예제에서는 에서 사이트 모음 https://contoso.com 이 포함된 콘텐츠 데이터베이스를 가져오고 호스트하는 웹 애플리케이션에 대해 데이터베이스를 테스트하여 문제를 확인합니다. 문제 목록을 표시하는 것 외에도 ShowRowCounts 매개 변수를 지정하여 콘텐츠 데이터베이스의 테이블 크기 기준을 반환합니다.

매개 변수

-AssignmentCollection

올바른 삭제를 위해 개체를 관리합니다. SPWeb 또는 SPSite와 같은 개체를 사용하는 경우 많은 양의 메모리를 사용할 수 있으며, Windows PowerShell 스크립트에서 이러한 개체를 사용하려면 올바른 메모리 관리가 필요합니다. SPAssignment 개체를 사용하면 개체를 하나의 변수에 지정하고 해당 개체가 필요한 시기가 지나면 개체를 삭제하여 메모리를 확보할 수 있습니다. SPWeb, SPSite 또는 SPSiteAdministration 개체를 사용하는 경우 지정 컬렉션 또는 Global 매개 변수가 사용되지 않으면 해당 개체가 자동으로 삭제됩니다.

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

고유한 경우 GUID 또는 데이터베이스 이름의 형태로 두 매개 변수 집합 중 하나에 연결된 기존 SharePoint 콘텐츠 데이터베이스를 지정합니다.

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 웹 응용 프로그램을 지정합니다.

형식은 12345678-90ab-cdef-1234-567890bcdefgh 형식의 유효한 GUID, 유효한 SharePoint 웹 응용 프로그램 이름(예: 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