Set-SPServerScaleOutDatabaseDataSubRange
지정된 수평 확장 데이터베이스에 대한 하위 범위를 만듭니다.
구문
UnattachedDatabase
Set-SPServerScaleOutDatabaseDataSubRange
-ConnectionString <String>
-IsUpperSubRange <Boolean>
-Range <SPScaleOutDataRange>
-SubRangeMode <SPScaleOutDatabaseSubRangeMode>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-IgnoreSubRangePointOnBoundary]
[-IsAzureDatabase]
[-SubRangePoint <Byte[]>]
[-WhatIf]
[<CommonParameters>]
AttachedDatabase
Set-SPServerScaleOutDatabaseDataSubRange
-Database <SPDatabasePipeBind>
-IsUpperSubRange <Boolean>
-Range <SPScaleOutDataRange>
-SubRangeMode <SPScaleOutDatabaseSubRangeMode>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-IgnoreSubRangePointOnBoundary]
[-SubRangePoint <Byte[]>]
[-WhatIf]
[<CommonParameters>]
Description
이 cmdlet에는 둘 이상의 매개 변수 집합이 포함됩니다. 한 매개 변수 집합의 매개 변수만 사용할 수 있으며 서로 다른 매개 변수 집합의 매개 변수를 결합하면 안 됩니다. 매개 변수 집합을 사용하는 방법에 대한 자세한 내용은 [Cmdlet 매개 변수 집합](https://msdn.microsoft.com/library/dd878348(VS.85).aspx)을 참조하세요.
예제
본보기
$databases = Get-SPServerScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
$state = Get-SPServerScaleOutDatabaseDataState -Database $database
Set-SPServerScaleOutDatabaseDataSubRange -Database $database -Range $state.Range -SubRangePoint $state.Range.RangeEnd -SubRangeMode ReadOnly -IsUpperSubRange $false
이 예제에서는 지정한 서비스 응용 프로그램의 첫 번째 수평 확장 데이터베이스에 대한 데이터 범위 시작점에서 시작되고 끝점에서 끝나는 읽기 전용 하위 범위를 만듭니다.
매개 변수
-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 |
-ConnectionString
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
새 데이터 하위 범위를 만들 수평 확장 데이터베이스에 대한 연결 문자열을 지정합니다.
매개 변수 속성
| 형식: | String |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
UnattachedDatabase
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Database
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
데이터 하위 범위를 만들 수평 확장 데이터베이스를 지정합니다.
매개 변수 속성
| 형식: | SPDatabasePipeBind |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
AttachedDatabase
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | True |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IgnoreSubRangePointOnBoundary
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
새 하위 범위의 시작점과 끝점이 동일한 경우 오류 없이 완료할지 여부를 지정합니다. 이 매개 변수를 지정하면 오류가 표시되지 않습니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsAzureDatabase
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
데이터베이스가 SQL Azure에서 호스팅되는지 여부를 지정합니다.
매개 변수 속성
| 형식: | SwitchParameter |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
UnattachedDatabase
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-IsUpperSubRange
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
데이터 하위 범위를 만들 위치(데이터 범위의 위쪽 또는 아래쪽)를 지정합니다.
매개 변수 속성
| 형식: | Boolean |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-Range
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
이 작업 전에 수평 확장 데이터베이스의 예상 현재 범위를 지정합니다.
매개 변수 속성
| 형식: | SPScaleOutDataRange |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SubRangeMode
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
매개 변수 속성
| 형식: | SPScaleOutDatabaseSubRangeMode |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | True |
| 파이프라인의 값: | False |
| 속성 이름별 파이프라인의 값: | False |
| 나머지 인수의 값: | False |
-SubRangePoint
적용 가능: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
다음 조건에 의해 정의된 대로 데이터 하위 범위의 시작점 또는 끝점을 만들도록 지정합니다.
--데이터 범위 위쪽에 데이터 하위 범위를 만드는 경우 시작점 --데이터 범위 아래쪽에 데이터 하위 범위를 만드는 경우 끝점
최대값은 NULL입니다.
매개 변수 속성
| 형식: | Byte[] |
| Default value: | None |
| 와일드카드 지원: | False |
| DontShow: | False |
매개 변수 집합
(All)
| Position: | Named |
| 필수: | False |
| 파이프라인의 값: | 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.SPDatabasePipeBind
Microsoft.SharePoint.PowerShell.SPAssignmentCollection