다음을 통해 공유


Split-SPServerScaleOutDatabase

지정한 비율의 파티션을 수평 확장 데이터베이스 간에 이동합니다.

구문

NewDatabase

Split-SPServerScaleOutDatabase
    -NewDatabaseName <String>
    -SourceDatabase <SPDatabasePipeBind>
    -SourceServiceApplication <SPServiceApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-MoveLowerHalf]
    [-NewDatabaseCredentials <PSCredential>]
    [-NewDatabaseFailoverServer <String>]
    [-NewDatabaseServer <String>]
    [-SourcePercentage <Int32>]
    [-WhatIf]
    [<CommonParameters>]

ExistingDatabase

Split-SPServerScaleOutDatabase
    -SourceDatabase <SPDatabasePipeBind>
    -SourceServiceApplication <SPServiceApplicationPipeBind>
    -TargetDatabase <SPDatabasePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-MoveLowerHalf]
    [-SourcePercentage <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Description

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

Split-SPServerScaleOutDatabase cmdlet을 사용하여 지정된 파티션 비율을 원본 데이터베이스에서 기존 대상 데이터베이스로 이동하거나 지정된 매개 변수를 사용하여 만든 새 데이터베이스로 이동합니다.

예제

본보기

$databases = Get-SPServerScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
Split-SPServerScaleOutDatabase -NewDatabaseName Database2 -NewDatabaseServer MyDatabaseServer -SourceDatabase $database -SourceServiceApplication $serviceApplication -SourcePercentage 30

이 예제에서는 지정된 서비스 응용 프로그램의 MyDatabaseServer 데이터베이스 서버에 Database2 라는 새 수평 확장 데이터베이스를 만듭니다. 또한 이 예제에서는 지정된 서비스 응용 프로그램의 첫 번째 수평 확장 데이터베이스에서 데이터 범위의 높은 쪽으로부터 30%의 데이터를 이동합니다.

매개 변수

-AssignmentCollection

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

참고: Global 매개 변수를 사용하면 모든 개체가 전역 저장소에 포함됩니다. 개체가 즉시 사용되지 않거나 Stop-SPAssignment 명령을 사용하여 삭제되지 않는 경우 메모리 부족 시나리오가 발생할 수 있습니다.

매개 변수 속성

형식:SPAssignmentCollection
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:True
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-Confirm

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

cmdlet을 실행하기 전에 확인 메시지를 표시합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:cf(cf)

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-MoveLowerHalf

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

원본 수평 확장 데이터베이스에서 데이터 범위의 낮은 쪽을 이동할지 아니면 높은 쪽을 이동할지 지정합니다. 이 매개 변수를 지정하지 않으면 기본적으로 원본 수평 확장 데이터베이스 데이터 범위의 높은 쪽을 이동합니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NewDatabaseCredentials

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

수평 확장 데이터베이스를 만들 때 사용하는 자격 증명을 지정합니다. 이러한 자격 증명에는 새 수평 확장 데이터베이스에 대한 소유자 권한이 있습니다. 값을 제공하지 않으면 로그온된 사용자의 자격 증명이 사용됩니다.

매개 변수 속성

형식:PSCredential
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

NewDatabase
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NewDatabaseFailoverServer

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

만들려는 새 수평 확장 데이터베이스의 장애 조치(failover) 서버 이름을 지정합니다. 값을 제공하지 않으면 새 수평 확장 데이터베이스에 장애 조치(failover) 서버가 포함되지 않습니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

NewDatabase
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NewDatabaseName

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

만들려는 새 수평 확장 데이터베이스의 이름을 지정합니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

NewDatabase
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-NewDatabaseServer

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

만들려는 새 수평 확장 데이터베이스의 서버 이름을 지정합니다. 값을 제공하지 않으면 기본 데이터베이스 서버의 이름이 사용됩니다.

매개 변수 속성

형식:String
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

NewDatabase
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SourceDatabase

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

데이터를 이동할 원본 수평 확장 데이터베이스입니다.

매개 변수 속성

형식:SPDatabasePipeBind
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SourcePercentage

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

이동할 원본 수평 확장 데이터베이스의 데이터 백분율을 지정합니다. 값을 제공하지 않으면 기본값인 50%가 사용됩니다.

매개 변수 속성

형식:Int32
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-SourceServiceApplication

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

데이터 이동 작업을 수행할 서비스 응용 프로그램입니다.

매개 변수 속성

형식:SPServiceApplicationPipeBind
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

(All)
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-TargetDatabase

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

데이터를 이동할 대상 수평 확장 데이터베이스입니다.

매개 변수 속성

형식:SPDatabasePipeBind
Default value:None
와일드카드 지원:False
DontShow:False

매개 변수 집합

ExistingDatabase
Position:Named
필수:True
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

-WhatIf

적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.

매개 변수 속성

형식:SwitchParameter
Default value:None
와일드카드 지원:False
DontShow:False
별칭:위스콘신

매개 변수 집합

(All)
Position:Named
필수:False
파이프라인의 값:False
속성 이름별 파이프라인의 값:False
나머지 인수의 값:False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

출력

System.Object