Partager via

Set-SPScaleOutDatabaseDataSubRange

  • Référence
Module:
sharepoint-server
S’applique à:
SharePoint Server Subscription Edition

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

Syntax

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

Description

Utilisez l’applet Set-SPScaleOutDatabaseDataSubRange de commande pour créer une sous-plage avec les paramètres spécifiés pour une base de données avec montée en puissance horizontale 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.

Pour les autorisations et les informations les plus récentes sur Windows PowerShell pour les produits SharePoint, consultez la documentation en ligne sur les applets de commande SharePoint Server.

Exemples

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

$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

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.

Paramètres

-AssignmentCollection

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.

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.

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

-Confirm

Vous demande une confirmation avant d’exécuter la commande. Pour plus d’informations, entrez la commande suivante : 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

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.

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

-Database

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

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

-IgnoreSubRangePointOnBoundary

Spécifie s’il faut effectuer sans erreur si 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.

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

-IsAzureDatabase

Spécifie si la base de données est hébergée sur 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

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.

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

-Range

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

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

-SubRangeMode

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. --Modification -Les partitions qui se trouvent à l’intérieur de la nouvelle sous-plage de données ne peuvent pas être lues ou modifiées --Supprimées- Les partitions qui se trouvent à l’intérieur de la nouvelle sous-plage de données ne peuvent pas être lues ou modifiées

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

-SubRangePoint

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.

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

-WhatIf

Affiche un message qui explique l’effet de la commande au lieu de l’exécuter. Pour plus d’informations, entrez la commande suivante : 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