Split-SPServerScaleOutDatabase

  • Riferimento
Modulo:
sharepoint-server
Si applica a:
SharePoint Server Subscription Edition

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

Sintassi

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

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 viene usato 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.

Type:SPAssignmentCollection
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-Confirm

Richiede la conferma prima di eseguire il cmdlet.

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

-MoveLowerHalf

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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NewDatabaseCredentials

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.

Type:PSCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NewDatabaseFailoverServer

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NewDatabaseName

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-NewDatabaseServer

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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SourceDatabase

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

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SourcePercentage

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%.

Type:Int32
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-SourceServiceApplication

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

Type:SPServiceApplicationPipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-TargetDatabase

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

Type:SPDatabasePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Server Subscription Edition

-WhatIf

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

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

Input

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Output

System.Object