Set-SPScaleOutDatabaseDataSubRange

为指定的扩展数据库创建子范围。

语法

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使用 cmdlet 为指定的横向扩展数据库或将使用指定连接字符串连接的数据库创建具有指定参数的子范围。 子范围是数据范围的一部分。

有关适用于 SharePoint 产品的 Windows PowerShell 的权限和最新信息,请参阅 SharePoint Server cmdlet

示例

--------------------示例---------------------

$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 对象,可以将对象分配给变量,然后在不需要这些对象时对它们进行处理,以释放内存。 在使用 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 - 新数据子范围内的分区可以读取,但不能修改。 --更改 -无法读取或修改新数据子范围内的分区 --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