Set-SPServerScaleOutDatabaseDataSubRange

SharePoint 2013
 

Sapplique à :SharePoint Server 2013

Dernière rubrique modifiée :2015-03-09

Crée une sous-plage pour une base de données de mise à l'échelle spécifiée.

Set-SPServerScaleOutDatabaseDataSubRange -Database <SPDatabasePipeBind> -IsUpperSubRange <$true | $false> -Range <SPScaleOutDataRange> -SubRangeMode <ReadWrite | ReadOnly | Changing | Deleted> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-IgnoreSubRangePointOnBoundary <SwitchParameter>] [-SubRangePoint <Byte[]>] [-WhatIf [<SwitchParameter>]]
Set-SPServerScaleOutDatabaseDataSubRange -ConnectionString <String> -IsUpperSubRange <$true | $false> -Range <SPScaleOutDataRange> -SubRangeMode <ReadWrite | ReadOnly | Changing | Deleted> [-AssignmentCollection <SPAssignmentCollection>] [-Confirm [<SwitchParameter>]] [-IgnoreSubRangePointOnBoundary <SwitchParameter>] [-IsAzureDatabase <SwitchParameter>] [-SubRangePoint <Byte[]>] [-WhatIf [<SwitchParameter>]]

Cette cmdlet contient plus d’un jeu de paramètres. Vous ne pouvez utiliser les paramètres que d’un seul jeu et vous ne pouvez pas combiner les paramètres de différents jeux. Pour plus d’informations sur l’utilisation des jeux de paramètres, voir la rubrique relative aux jeux de paramètres de cmdlet.

Utilisez la cmdlet Set-SPServerScaleOutDatabaseDataSubRange pour créer une sous-plage avec les paramètres spécifiés pour une base de données mise à l'échelle spécifiée ou une base de données qui sera connectée avec une chaîne de connexion spécifiée. Une sous-plage est un sous-ensemble d'une plage de données.

 

Paramètre Obligatoire Type Description

ConnectionString

Requis

System.String

Spécifie la chaîne de connexion pour la base de données mise à l'échelle pour créer la nouvelle sous-plage de données.

Database

Obligatoire

Microsoft.SharePoint.PowerShell.SPDatabasePipeBind

Spécifie la base de données mise à l'échelle pour créer la sous-plage de données.

IsUpperSubRange

Obligatoire

System.Boolean

Spécifie si la création de la sous-plage de données doit être créée au-dessus ou au-dessous de la plage de données.

Range

Obligatoire

Microsoft.SharePoint.SPScaleOutDataRange

Spécifie la plage actuelle attendue de la base de données mise à l'échelle avant cette opération.

SubRangeMode

Obligatoire

Microsoft.SharePoint.SPScaleOutDatabaseSubRangeMode

Spécifie le mode de sous-plage de données à créer. Les valeurs de mode de sous-plage de données sont les suivantes :

--NULL- La sous-plage de données du côté spécifié (au-dessus ou au-dessous) de la plage de données sera supprimée.

--ReadOnly - Les partitions qui se trouvent à l'intérieur de la nouvelle sous-plage de données peuvent être lues, mais ne peuvent pas être modifiées.

--Changing - Les partitions qui se trouvent à l'intérieur de la nouvelle sous-plage de données ne peuvent pas être lues ni modifiées.

--Deleted- Les partitions qui se trouvent à l'intérieur de la nouvelle sous-plage de données ne peuvent pas être lues ni modifiées

AssignmentCollection

Facultatif

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Gère les objets de manière à optimiser leur libération. L’utilisation d’objets, tels que SPWeb ou SPSite, peut consommer des quantités de mémoire élevées et le recours à ces objets dans des scripts Windows PowerShell implique une gestion appropriée de la mémoire. À l’aide de l’objet SPAssignment, vous pouvez affecter des objets à une variable et les libérer dès qu’ils ne sont plus nécessaires afin de libérer de la mémoire. Lorsque les objets SPWeb, SPSite ou SPSiteAdministration sont utilisés, ils sont automatiquement libérés si une collection d’attributions ou le paramètre Global ne sont pas utilisés.

RemarqueRemarque :
Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. Si des objets ne sont pas utilisés immédiatement ou libérés à l’aide de la commande Stop-SPAssignment, un scénario d’insuffisance de mémoire peut se produire.

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Vous demande confirmation avant d’exécuter la commande. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

IgnoreSubRangePointOnBoundary

Facultatif

System.Management.Automation.SwitchParameter

Spécifie si des erreurs d'exécution s'affichent quand les points de début et de fin de la nouvelle sous-plage sont identiques. Si ce paramètre est spécifié, aucune erreur ne s'affiche.

IsAzureDatabase

Facultatif

System.Management.Automation.SwitchParameter

Spécifie si la base de données est hébergée sur SQL Azure.

SubRangePoint

Facultatif

System.Byte[]

Spécifie le point de début et de fin de la sous-plage de données à créer, définis par les critères suivants :

--Le point de départ si la sous-plage de données est créée au-dessus de la plage de données.

--Le point de terminaison si la sous-plage de données est créée au-dessous de la plage de données.

La valeur maximale est NULL.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, tapez la commande suivante : get-help about_commonparameters

--------------EXEMPLE-------------

$databases = Get-SPServerScaleOutDatabase -ServiceApplication $serviceApplication
$database = $databases[0]
$state = Get-SPServerScaleOutDatabaseDataState -Database $database
Set-SPServerScaleOutDatabaseDataSubRange -Database $database -Range $state.Range -SubRangePoint $state.Range.RangeEnd -SubRangeMode ReadOnly -IsUpperSubRange $false

Cet exemple montre comment créer une sous-plage en lecture seule qui commence au point de départ de la plage de données et se termine au point de terminaison de plage de données de la première base de données mise à l'échelle de l'application de service spécifiée.

Afficher: