Condividi tramite

Split-SPScaleOutDatabase

Modulo:
SharePointServer module

Sposta una percentuale specificata delle partizioni da un database con scalabilità orizzontale a un altro.

Sintassi

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>]

Descrizione

Questo cmdlet include più set di parametri. È possibile utilizzare solo i parametri di un set di parametri e non è possibile combinare parametri appartenenti a set di parametri diversi. Per altre informazioni su come usare i set di parametri, vedere Set di parametri del cmdlet.

Usare il Split-SPScaleOutDatabase cmdlet per spostare una percentuale specificata di partizioni da un database di origine a un database di destinazione esistente o a un nuovo database creato con i parametri specificati.

Per le autorizzazioni e le informazioni più recenti su Windows PowerShell per i prodotti SharePoint, vedere la documentazione online nella pagina Cmdlet server SharePoint.

Esempio

ESEMPIO 1

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

In questo esempio viene creato un nuovo database con scalabilità orizzontale denominato Database2 nel server di database MyDatabaseServer nell'applicazione di servizio specificata.

L'esempio sposta anche il 30% dei dati dal lato superiore dell'intervallo di dati nel primo database con scalabilità orizzontale dell'applicazione di servizio specificata.

ESEMPIO 2

$ssa = Get-SPEnterpriseSearchServiceApplication

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

In questo esempio viene ridimensionato il database di Analisi della ricerca, spostando il 33% dei dati nei nuovi database.

Parametri

-AssignmentCollection

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Consente di gestire gli oggetti ai fini della corretta eliminazione dalla memoria. Oggetti quali SPWeb o SPSite richiedono quantità di memoria elevate e per utilizzarli negli script Windows PowerShell è necessario gestire la memoria in modo appropriato. Tramite l'oggetto SPAssignment è possibile assegnare oggetti a una variabile ed eliminarli quando è necessario liberare memoria. Gli oggetti SPWeb, SPSite e SPSiteAdministration utilizzati vengono automaticamente eliminati dalla memoria se non viene utilizzato un insieme di assegnazioni o il parametro Global.

Quando viene utilizzato il parametro Global, tutti gli oggetti vengono memorizzati nell'area di archiviazione globale. Se gli oggetti non vengono utilizzati immediatamente o eliminati dalla memoria tramite il comando Stop-SPAssignment, può verificarsi una condizione di memoria insufficiente.

Proprietà dei parametri

Tipo:SPAssignmentCollection
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:True
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-Confirm

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Richiede la conferma prima di eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:cfr

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-MoveLowerHalf

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica se dal database con scalabilità orizzontale di origine deve essere spostato il lato inferiore oppure quello superiore dell'intervallo di dati. Se questo parametro non viene specificato, il comportamento predefinito consiste nello spostare il lato superiore dell'intervallo di dati del database con scalabilità orizzontale di origine.

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NewDatabaseCredentials

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica le credenziali da utilizzare durante la creazione del database con scalabilità orizzontale. Tali credenziali disporranno dei diritti di proprietario per il nuovo database creato. Se non viene specificato un valore, le credenziali dell'utente corrente verranno usate per impostazione predefinita.

Proprietà dei parametri

Tipo:PSCredential
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NewDatabase
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NewDatabaseFailoverServer

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome del server di failover del nuovo database con scalabilità orizzontale da creare. Se non viene specificato un valore, il nuovo database con scalabilità orizzontale non disporrà di un server di failover.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NewDatabase
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NewDatabaseName

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome di un nuovo database con scalabilità orizzontale da creare.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NewDatabase
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-NewDatabaseServer

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica il nome del server del nuovo database con scalabilità orizzontale da creare. Se non viene specificato un valore, verrà utilizzato il server di database predefinito.

Proprietà dei parametri

Tipo:String
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

NewDatabase
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SourceDatabase

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Database con scalabilità orizzontale di origine da cui spostare i dati.

Proprietà dei parametri

Tipo:SPDatabasePipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SourcePercentage

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Specifica la percentuale di dati del database con scalabilità orizzontale di origine da spostare. Se non viene specificato un valore, verrà utilizzato il valore predefinito, ovvero 50 (%).

Proprietà dei parametri

Tipo:Int32
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-SourceServiceApplication

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Applicazione di servizio in cui avrà luogo l'operazione di spostamento dei dati.

Proprietà dei parametri

Tipo:SPServiceApplicationPipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

(All)
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-TargetDatabase

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Database con scalabilità orizzontale di destinazione in cui spostare i dati.

Proprietà dei parametri

Tipo:SPDatabasePipeBind
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False

Set di parametri

ExistingDatabase
Posizione:Named
Obbligatorio:True
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

-WhatIf

Applicabile: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando. Per ulteriori informazioni, digitare il comando seguente: get-help about_commonparameters

Proprietà dei parametri

Tipo:SwitchParameter
Valore predefinito:None
Supporta i caratteri jolly:False
DontShow:False
Alias:Wi

Set di parametri

(All)
Posizione:Named
Obbligatorio:False
Valore dalla pipeline:False
Valore dalla pipeline in base al nome della proprietà:False
Valore dagli argomenti rimanenti:False

CommonParameters

Questo cmdlet supporta i parametri comuni: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction e -WarningVariable. Per altre informazioni, vedere about_CommonParameters.