Set-SPScaleOutDatabaseDataSubRange
建立指定之向外延展資料庫的子範圍。
Syntax
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>] Description
使用 Cmdlet 為指定的 Set-SPScaleOutDatabaseDataSubRange 向外延展資料庫或將使用指定連接字串連接的資料庫，建立具有指定參數的子範圍。
子範圍是資料範圍的子集。
如需適用於 SharePoint 產品的 Windows PowerShell 權限及最新資訊，請參閱線上文件 SharePoint Server Cmdlet。
範例
--------------------範例---------------------
C:\PS>$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
C:\PS>$database = $databases[0]
C:\PS>$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 物件將物件指派給變數，並在不需要時處置這些物件，以釋放記憶體。 使用 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
在執行命令之前，提示您確認操作。
如需詳細資訊，請輸入下列命令：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 2013, SharePoint Server 2016, SharePoint Server 2019 |
-ConnectionString
指定向外延展資料庫的連線字串，以建立新的資料子範圍。
| 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 |
-Database
指定向外延展資料庫，以建立資料子範圍。
| Type: | SPDatabasePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019 |
-IgnoreSubRangePointOnBoundary
指定如果新子範圍的開始和結束點相同，是否要完成而不發生任何錯誤。 如有指定此參數，即不會顯示錯誤。
| 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 |
-IsAzureDatabase
指定資料庫是否要由 SQL Azure 主控。
| 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 |
-IsUpperSubRange
指定要在資料範圍的上半部還是下半部建立資料子範圍。
| Type: | Boolean |
| 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 |
-Range
指定在此作業之前，向外延展資料庫的預定目前範圍。
| Type: | SPScaleOutDataRange |
| 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 |
-SubRangeMode
指定要建立之資料子範圍的模式。 資料子範圍模式值如下：
--NULL- 將會移除資料範圍指定部分 (下半部或上半部) 的資料子範圍。 --ReadOnly - 可讀取新資料子範圍內的資料分割，但無法修改。 --變更 -無法讀取或修改新資料子範圍內的資料分割 --Deleted- 無法讀取或修改新資料子範圍內的資料分割
| Type: | SPScaleOutDatabaseSubRangeMode |
| 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 |
-SubRangePoint
指定要依據下列準則來建立資料子範圍的起點和終點：
--若資料子範圍是從資料範圍的上半部建立而來，即為起點。 --若資料子範圍是從資料範圍的下半部建立而來，即為終點。
最大值為 NULL。
| Type: | Byte[] |
| 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 |
-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 2013, SharePoint Server 2016, SharePoint Server 2019 |