Condividi tramite

Split-SPServerScaleOutDatabase

Modulo:
SharePointServer module

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

Sintassi

NewDatabase 

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

ExistingDatabase 

Split-SPServerScaleOutDatabase
    -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.

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

Esempio

ESEMPIO

$databases = Get-SPServerScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
Split-SPServerScaleOutDatabase -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. Nell'esempio viene inoltre spostato il 30% dei dati dal lato superiore dell'intervallo di dati del primo database con scalabilità orizzontale dell'applicazione di servizio in questione.

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.

Nota: quando si usa il parametro Global, tutti gli oggetti sono contenuti nell'archivio 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 cmdlet.

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, per impostazione predefinita verranno utilizzate le credenziali dell'utente corrente.

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. 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. Se non viene specificato un valore, verrà utilizzato il nome del server del 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

Mostra cosa accade se viene eseguito il cmdlet. Il cmdlet non viene eseguito.

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.

Input

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Output

System.Object