다음을 통해 공유


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

출력

System.Object