Set-SPScaleOutDatabaseDataSubRange

  • リファレンス
モジュール:
sharepoint-server
適用対象:
SharePoint Server Subscription Edition

指定したスケール アウト データベースの部分範囲を作成します。

構文

Set-SPScaleOutDatabaseDataSubRange
   -ConnectionString <String>
   -IsUpperSubRange <Boolean>
   -Range <SPScaleOutDataRange>
   -SubRangeMode <SPScaleOutDatabaseSubRangeMode>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-IgnoreSubRangePointOnBoundary]
   [-IsAzureDatabase]
   [-SubRangePoint <Byte[]>]
   [-WhatIf]
   [<CommonParameters>]
Set-SPScaleOutDatabaseDataSubRange
   -Database <SPDatabasePipeBind>
   -IsUpperSubRange <Boolean>
   -Range <SPScaleOutDataRange>
   -SubRangeMode <SPScaleOutDatabaseSubRangeMode>
   [-AssignmentCollection <SPAssignmentCollection>]
   [-Confirm]
   [-IgnoreSubRangePointOnBoundary]
   [-SubRangePoint <Byte[]>]
   [-WhatIf]
   [<CommonParameters>]

説明

コマンドレットを Set-SPScaleOutDatabaseDataSubRange 使用して、指定したスケールアウト データベースまたは指定した接続文字列で接続されるデータベースに対して、指定したパラメーターを持つサブ範囲を作成します。 部分範囲はデータ範囲のサブセットです。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンライン ドキュメントをご覧ください。

例

-------------------- 例 ---------------------

$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
$state = Get-SPScaleOutDatabaseDataState -Database $database
Set-SPScaleOutDatabaseDataSubRange -Database $database -Range $state.Range -SubRangePoint $state.Range.RangeEnd -SubRangeMode ReadOnly -IsUpperSubRange $false

この例では、指定したサービス アプリケーションの最初のスケールアウト データベースで、データ範囲の始点から始まりデータ範囲の終点で終わる読み取り専用の部分範囲を作成します。

パラメーター

-AssignmentCollection

適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。

Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。 Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

コマンドを実行する前に確認メッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-ConnectionString

新しいデータ部分範囲を作成するスケール アウト データベースの接続文字列を指定します。

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Database

データ部分範囲を作成するスケール アウト データベースを指定します。

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-IgnoreSubRangePointOnBoundary

新しいサブ範囲の始点と終点が同じ場合にエラーなしで完了するかどうかを指定します。 このパラメーターを指定した場合、エラーは表示されません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-IsAzureDatabase

SQL Azure でホストされているデータベースかどうかを指定します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-IsUpperSubRange

データ部分範囲をデータ範囲の下側と上側のどちらに作成するかを指定します。

Type:Boolean
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Range

この操作より前の時点で予想されるスケール アウト データベースの現在の範囲を指定します。

Type:SPScaleOutDataRange
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SubRangeMode

作成するデータ部分範囲のモードを指定します。 データ部分範囲のモード値は次のとおりです。

--NULL - データ範囲の指定した側 (下側または上側) のデータ部分範囲を削除します。 --ReadOnly - 新しいデータ サブ範囲内にあるパーティションは読み取ることができますが、変更することはできません。 --Changing -新しいデータ サブ範囲内にあるパーティションは読み取りまたは変更できません --Deleted- 新しいデータ サブ範囲内にあるパーティションは読み取りまたは変更できません

Type:SPScaleOutDatabaseSubRangeMode
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SubRangePoint

作成するデータ部分範囲の始点または終点を次の基準で指定します。

-- データ部分範囲をデータ範囲の上側に作成する場合は、始点。 -- データ部分範囲をデータ範囲の下側に作成する場合は、終点。

最大値は NULL です。

Type:Byte[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。 詳細については、次のコマンドを入力します。get-help about_commonparameters

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition