Split-SPServerScaleOutDatabase
지정한 비율의 파티션을 수평 확장 데이터베이스 간에 이동합니다.
Syntax
Split-SPServerScaleOutDatabase
-NewDatabaseName <String>
-SourceDatabase <SPDatabasePipeBind>
-SourceServiceApplication <SPServiceApplicationPipeBind>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-MoveLowerHalf]
[-NewDatabaseCredentials <PSCredential>]
[-NewDatabaseFailoverServer <String>]
[-NewDatabaseServer <String>]
[-SourcePercentage <Int32>]
[-WhatIf]
[<CommonParameters>] 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
올바른 삭제를 위해 개체를 관리합니다. 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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-Confirm
cmdlet을 실행하기 전에 확인 메시지를 표시합니다.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-MoveLowerHalf
원본 수평 확장 데이터베이스에서 데이터 범위의 낮은 쪽을 이동할지 아니면 높은 쪽을 이동할지 지정합니다. 이 매개 변수를 지정하지 않으면 기본적으로 원본 수평 확장 데이터베이스 데이터 범위의 높은 쪽을 이동합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NewDatabaseCredentials
수평 확장 데이터베이스를 만들 때 사용하는 자격 증명을 지정합니다. 이러한 자격 증명에는 새 수평 확장 데이터베이스에 대한 소유자 권한이 있습니다. 값을 제공하지 않으면 로그온된 사용자의 자격 증명이 사용됩니다.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NewDatabaseFailoverServer
만들려는 새 수평 확장 데이터베이스의 장애 조치(failover) 서버 이름을 지정합니다. 값을 제공하지 않으면 새 수평 확장 데이터베이스에 장애 조치(failover) 서버가 포함되지 않습니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NewDatabaseName
만들려는 새 수평 확장 데이터베이스의 이름을 지정합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-NewDatabaseServer
만들려는 새 수평 확장 데이터베이스의 서버 이름을 지정합니다. 값을 제공하지 않으면 기본 데이터베이스 서버의 이름이 사용됩니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SourceDatabase
데이터를 이동할 원본 수평 확장 데이터베이스입니다.
| Type: | SPDatabasePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SourcePercentage
이동할 원본 수평 확장 데이터베이스의 데이터 백분율을 지정합니다. 값을 제공하지 않으면 기본값인 50%가 사용됩니다.
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-SourceServiceApplication
데이터 이동 작업을 수행할 서비스 응용 프로그램입니다.
| Type: | SPServiceApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-TargetDatabase
데이터를 이동할 대상 수평 확장 데이터베이스입니다.
| Type: | SPDatabasePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-WhatIf
cmdlet이 실행되면 어떻게 되는지 보여줍니다. cmdlet이 실행되지 않습니다.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
입력
Microsoft.SharePoint.PowerShell.SPAssignmentCollection
출력
System.Object