Set-SPScaleOutDatabaseDataSubRange
为指定的扩展数据库创建子范围。
语法
UnattachedDatabase
Set-SPScaleOutDatabaseDataSubRange
-ConnectionString <String>
-IsUpperSubRange <Boolean>
-Range <SPScaleOutDataRange>
-SubRangeMode <SPScaleOutDatabaseSubRangeMode>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-IgnoreSubRangePointOnBoundary]
[-IsAzureDatabase]
[-SubRangePoint <Byte[]>]
[-WhatIf]
[<CommonParameters>]
AttachedDatabase
Set-SPScaleOutDatabaseDataSubRange
-Database <SPDatabasePipeBind>
-IsUpperSubRange <Boolean>
-Range <SPScaleOutDataRange>
-SubRangeMode <SPScaleOutDatabaseSubRangeMode>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-IgnoreSubRangePointOnBoundary]
[-SubRangePoint <Byte[]>]
[-WhatIf]
[<CommonParameters>]
说明
Set-SPScaleOutDatabaseDataSubRange使用 cmdlet 为指定的横向扩展数据库创建具有指定参数的子范围，或者使用指定的连接字符串连接的数据库。
子范围是数据范围的一部分。
有关适用于 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
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
管理对象以便正确进行处理。 使用 SPWeb 或 SPSite 等对象可能会耗用大量内存，而且在 Windows PowerShell 脚本中使用这些对象需要正确管理内存。 通过使用 SPAssignment 对象，可以将对象分配给变量，然后在不需要这些对象时对它们进行处理，以释放内存。 在使用 SPWeb、SPSite 或 SPSiteAdministration 对象时，如果不使用分配集合或 Global 参数，则会自动处理这些对象。
使用全局参数时，所有对象均包含在全局存储中。
如果未立即使用对象，或未通过使用 Stop-SPAssignment 命令来处理对象，则可能会发生内存不足的情况。
参数属性
| 类型: | SPAssignmentCollection |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Confirm
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
执行命令前，看到确认提示。
有关详细信息，请键入以下命令：get-help about_commonparameters
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ConnectionString
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定扩展数据库的连接字符串以创建新的数据子范围。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UnattachedDatabase
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Database
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定扩展数据库以创建数据子范围。
参数属性
| 类型: | SPDatabasePipeBind |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
AttachedDatabase
| Position: | Named |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IgnoreSubRangePointOnBoundary
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定在新子范围起点和终点相同时是否完成而不出现任何错误。 如果指定此参数，则不显示任何错误。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IsAzureDatabase
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定数据库是否驻留在 SQL Azure 上。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UnattachedDatabase
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-IsUpperSubRange
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定是在数据范围的上半部分还是下半部分创建数据子范围。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Range
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定执行此操作之前扩展数据库的预期当前范围。
参数属性
| 类型: | SPScaleOutDataRange |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SubRangeMode
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要创建的数据子范围的模式。 数据子范围模式值如下：
--NULL - 将删除数据范围的指定部分（下半部分或上半部分）的数据子范围。 --ReadOnly - 可以读取位于新数据子范围内的分区，但不能修改。 --更改 -无法读取或修改新数据子范围内的分区 --Deleted - 无法读取或修改新数据子范围内的分区
参数属性
| 类型: | SPScaleOutDatabaseSubRangeMode |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-SubRangePoint
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
指定要按以下条件的定义创建的数据子范围的起始点和结束点：
--如果在数据范围的上半部分创建数据子范围，则为起始点。 --如果在数据范围的下半部分创建数据子范围，则为结束点。
最大值为 NULL。
参数属性
| 类型: | Byte[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-WhatIf
适用：SharePoint Server 2013、SharePoint Server 2016 SharePoint Server 2019
显示一条描述命令作用的消息，而不执行命令。
有关详细信息，请键入以下命令：get-help about_commonparameters
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。