Share via


Set-SPScaleOutDatabaseDataSubRange

Cria um subintervalo para um banco de dados de dimensionamento especificado.

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

Use o Set-SPScaleOutDatabaseDataSubRange cmdlet para criar um subconjunto com os parâmetros especificados para um banco de dados de expansão especificado ou um banco de dados que será conectado com uma cadeia de conexão especificada. Um subintervalo é um subconjunto de um intervalo de dados.

Para obter as permissões e informações mais recentes sobre o Windows PowerShell para Produtos SharePoint, confira a documentação online em Cmdlets do SharePoint Server.

Exemplos

---------------------EXEMPLO-----------------------

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

Este exemplo cria um subintervalo somente leitura do ponto inicial e final do intervalo de dados do primeiro banco de dados de dimensionamento do aplicativo de serviço especificado.

Parâmetros

-AssignmentCollection

Gerencia objetos para o devido descarte. O uso de objetos como SPWeb ou SPSite pode consumir grandes quantidades de memória e o uso desses objetos em scripts do Windows PowerShell requer gerenciamento de memória adequado. Usando o objeto SPAssignment, você poderá atribuir objetos a uma variável e descartar os objetos após o uso para liberar memória. Quando objetos SPWeb, SPSite ou SPSiteAdministration são usados, os objetos são automaticamente descartados se um conjunto de atribuições ou o parâmetro Global não forem usados.

Quando o parâmetro Global é usado, todos os objetos estão contidos no repositório global. Quando os objetos não são usados imediatamente ou são descartados com o uso do comando Stop-SPAssignment, pode ocorrer um cenário de memória insuficiente.

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

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: 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

Especifica a cadeia de caracteres de conexão para bancos de dados de dimensionamento para criar o novo subintervalo de dados.

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

Especifica o banco de dados de dimensionamento para criar o subintervalo de dados.

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

Especifica se a conclusão será sem erros se os pontos de início e de extremidade do novo subrange forem os mesmos. Se este parâmetro é especificado, nenhum erro é exibido.

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

Especifica se o banco de dados é hospedado no 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

Especifica se deve criar o subintervalo de dados no lado superior e inferior do intervalo de dados.

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

Especifica o intervalo atual esperado do banco de dados de dimensionamento antes desta operação.

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

Especifica o modo do subintervalo de dados a ser criado. Os valores de modo de subintervalo de dados são os seguintes:

--NULL- O subintervalo de dados no lado especificado (inferior ou superior) do intervalo de dados será removido. --ReadOnly - As partições que estão dentro do novo subconjunto de dados podem ser lidas, mas não podem ser modificadas. --Changing-The partitions which are inside the new data subrange cannot be read or modified --Deleted- The partitions which are inside the new data subrange cannot be read or modified

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

Especifica o ponto inicial ou final do subintervalo de dados a ser criado como definido pelo seguinte critério:

--O ponto inicial se o subintervalo de dados for criado no lado superior do intervalo de dados. --O ponto final se o subintervalo de dados for criado no lado inferior do intervalo de dados.

O valor máximo é NULO.

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

Exibe uma mensagem que descreve o efeito do comando em vez de executar o comando. Para saber mais, digite o seguinte comando: 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