Compartilhar via

Split-SPScaleOutDatabase

Módulo:
SharePointServer module

Move uma porcentagem especificada de partições de um banco de dados de dimensionamento para outro.

Sintaxe

NewDatabase 

Split-SPScaleOutDatabase
    -NewDatabaseName <String>
    -SourceDatabase <SPDatabasePipeBind>
    -SourceServiceApplication <SPServiceApplicationPipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-MoveLowerHalf]
    [-NewDatabaseCredentials <PSCredential>]
    [-NewDatabaseFailoverServer <String>]
    [-NewDatabaseServer <String>]
    [-SourcePercentage <Int32>]
    [-WhatIf]
    [<CommonParameters>]

ExistingDatabase 

Split-SPScaleOutDatabase
    -SourceDatabase <SPDatabasePipeBind>
    -SourceServiceApplication <SPServiceApplicationPipeBind>
    -TargetDatabase <SPDatabasePipeBind>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-MoveLowerHalf]
    [-SourcePercentage <Int32>]
    [-WhatIf]
    [<CommonParameters>]

Description

Este cmdlet contém mais de um parâmetro definido. Você pode usar apenas parâmetros de um conjunto de parâmetro e você não pode combinar parâmetros de diferentes conjuntos de parâmetros. Para obter mais informações sobre como usar conjuntos de parâmetros, confira Conjuntos de parâmetros de Cmdlets.

Utilize o Split-SPScaleOutDatabase cmdlet para mover uma percentagem especificada de partições de uma base de dados de origem para uma base de dados de destino existente ou para uma nova base de dados criada com os parâmetros especificados.

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 1

$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
Split-SPScaleOutDatabase -NewDatabaseName Database2 -NewDatabaseServer MyDatabaseServer -SourceDatabase $database -SourceServiceApplication $serviceApplication -SourcePercentage 30

Este exemplo cria um novo banco de dados de dimensionamento chamado Database2 no servidor do banco de dados MyDatabaseServer no determinado aplicativo de serviço.

O exemplo também move 30% dos dados do lado superior do intervalo de dados na primeira base de dados de escalamento horizontal da aplicação de serviço especificada.

EXEMPLO 2

$ssa = Get-SPEnterpriseSearchServiceApplication

$newReportingDb = "Search_AnalyticsReporting2"
$reportingDb = Get-SPScaleOutDatabase -SearchApplication $ssa
Split-SPServerScaleOutDatabase -SourceServiceApplication $ssa -SourceDatabase $reportingDb -NewDatabaseName $newReportingDb -SourcePercentage 33

Este exemplo aumenta horizontalmente a base de dados do Search Analytics, movendo 33% dos dados para as novas bases de dados.

Parâmetros

-AssignmentCollection

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

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.

Propriedades do parâmetro

Tipo:SPAssignmentCollection
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:True
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-Confirm

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Solicita sua confirmação antes de executar o comando. Para saber mais, digite o seguinte comando: get-help about_commonparameters

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:cf

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-MoveLowerHalf

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica se deve mover o lado superior ou inferior do intervalo de dados no banco de dados de dimensionamento de origem. Se este parâmetro não é especificado, o comportamento padrão é mover o lado superior do intervalo de dados do banco de dados de dimensionamento de origem.

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NewDatabaseCredentials

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica as credenciais a usar ao criar o banco de dados de dimensionamento. Estas credenciais precisarão ter direitos de proprietário nos bancos de dados de dimensionamento criados recentemente. Se não for fornecido um valor, as credenciais do utilizador atual serão utilizadas por predefinição.

Propriedades do parâmetro

Tipo:PSCredential
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewDatabase
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NewDatabaseFailoverServer

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o nome do servidor de failover do novo banco de dados de dimensionamento a ser criado. Se um valor não é fornecido, o novo banco de dados de dimensionamento não possui um servidor de failover.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewDatabase
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NewDatabaseName

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o nome de um novo banco de dados de dimensionamento que você está criando.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewDatabase
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-NewDatabaseServer

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica o nome do servidor do novo banco de dados de dimensionamento a ser criado. Se um valor não é fornecido, o servidor do banco de dados padrão é usado.

Propriedades do parâmetro

Tipo:String
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

NewDatabase
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SourceDatabase

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

O banco de dados de dimensionamento de origem para obter os dados.

Propriedades do parâmetro

Tipo:SPDatabasePipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SourcePercentage

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

Especifica a porcentagem de dados no banco de dados de dimensionamento de origem para mover. Se um valor não é fornecido, o valor padrão de 50 por cento é usado.

Propriedades do parâmetro

Tipo:Int32
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-SourceServiceApplication

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

O aplicativo de serviço no qual a operação mover dados irá ocorrer.

Propriedades do parâmetro

Tipo:SPServiceApplicationPipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-TargetDatabase

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

O banco de dados de dimensionamento de destino para enviar os dados.

Propriedades do parâmetro

Tipo:SPDatabasePipeBind
Valor padrão:None
Dá suporte a curingas:False
DontShow:False

Conjuntos de parâmetros

ExistingDatabase
Cargo:Named
Obrigatório:True
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

-WhatIf

Aplicável: SharePoint Server 2013, SharePoint Server 2016 SharePoint Server 2019

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

Propriedades do parâmetro

Tipo:SwitchParameter
Valor padrão:None
Dá suporte a curingas:False
DontShow:False
Aliases:wi

Conjuntos de parâmetros

(All)
Cargo:Named
Obrigatório:False
Valor do pipeline:False
Valor do pipeline pelo nome da propriedade:False
Valor dos argumentos restantes:False

CommonParameters

Este cmdlet suporta os parâmetros comuns: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Para obter mais informações, confira about_CommonParameters.