Set-SPScaleOutDatabaseDataSubRange
Crea un intervallo secondario per un database con scalabilità orizzontale specificato.
Sintassi
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>]
Descrizione
Usare il Set-SPScaleOutDatabaseDataSubRange
cmdlet per creare un intervallo secondario con i parametri specificati per un database con scalabilità orizzontale specificato o un database che verrà connesso con una stringa di connessione specificata.
Un intervallo secondario è un subset di un intervallo di dati.
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---------------------
$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
$state = Get-SPScaleOutDatabaseDataState -Database $database
Set-SPScaleOutDatabaseDataSubRange -Database $database -Range $state.Range -SubRangePoint $state.Range.RangeEnd -SubRangeMode ReadOnly -IsUpperSubRange $false
In questo esempio vene creato un intervallo secondario di sola lettura che inizia dal punto iniziale dell'intervallo di dati e termina in corrispondenza del punto finale dell'intervallo di dati nel primo database con scalabilità orizzontale dell'applicazione di servizio specificata.
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.
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.
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 comando.
Per ulteriori informazioni, digitare il comando seguente: 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 Subscription Edition |
-ConnectionString
Specifica la stringa di connessione del database con scalabilità orizzontale per creare il nuovo intervallo secondario di dati.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Database
Specifica il database con scalabilità orizzontale per creare l'intervallo secondario di dati.
Type: | SPDatabasePipeBind |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-IgnoreSubRangePointOnBoundary
Specifica se completare senza errori se i punti iniziale e finale del nuovo intervallo secondario sono gli stessi. Se questo parametro viene specificato, non verrà visualizzato alcun errore.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-IsAzureDatabase
Specifica se il database è ospitato in SQL Azure.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-IsUpperSubRange
Specifica se creare l'intervallo secondario di dati in corrispondenza del limite superiore o inferiore dell'intervallo di dati.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-Range
Specifica l'intervallo corrente previsto del database con scalabilità orizzontale prima di questa operazione.
Type: | SPScaleOutDataRange |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-SubRangeMode
Specifica la modalità dell'intervallo secondario di dati da creare. I valori di questa modalità sono i seguenti:
- NULL - L'intervallo secondario di dati in corrispondenza del limite specificato (inferiore o superiore) dell'intervallo di dati verrà rimosso. --ReadOnly: le partizioni che si trovano all'interno del nuovo intervallo secondario di dati possono essere lette, ma non possono essere modificate. --Changing -Le partizioni che si trovano all'interno del nuovo intervallo di dati non possono essere lette o modificate --Deleted- Le partizioni che si trovano all'interno del nuovo intervallo di dati non possono essere lette o modificate
Type: | SPScaleOutDatabaseSubRangeMode |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-SubRangePoint
Specifica il punto iniziale o finale dell'intervallo secondario di dati da creare secondo i criteri seguenti:
- Il punto iniziale, se l'intervallo secondario di dati viene creato in corrispondenza del limite superiore dell'intervallo di dati. - Il punto finale, se l'intervallo secondario di dati viene creato in corrispondenza del limite inferiore dell'intervallo di dati.
Il valore massimo è NULL.
Type: | Byte[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | SharePoint Server Subscription Edition |
-WhatIf
Visualizza un messaggio che illustra gli effetti del comando anziché eseguire il comando.
Per ulteriori informazioni, digitare il comando seguente: 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 Subscription Edition |