Partager via


Set-SPServerScaleOutDatabaseDataSubRange

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

Syntaxe

UnattachedDatabase

Set-SPServerScaleOutDatabaseDataSubRange
    -ConnectionString <String>
    -IsUpperSubRange <Boolean>
    -Range <SPScaleOutDataRange>
    -SubRangeMode <SPScaleOutDatabaseSubRangeMode>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-IgnoreSubRangePointOnBoundary]
    [-IsAzureDatabase]
    [-SubRangePoint <Byte[]>]
    [-WhatIf]
    [<CommonParameters>]

AttachedDatabase

Set-SPServerScaleOutDatabaseDataSubRange
    -Database <SPDatabasePipeBind>
    -IsUpperSubRange <Boolean>
    -Range <SPScaleOutDataRange>
    -SubRangeMode <SPScaleOutDatabaseSubRangeMode>
    [-AssignmentCollection <SPAssignmentCollection>]
    [-Confirm]
    [-IgnoreSubRangePointOnBoundary]
    [-SubRangePoint <Byte[]>]
    [-WhatIf]
    [<CommonParameters>]

Description

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, consultez [Cmdlet Parameter Sets] (https://msdn.microsoft.com/library/dd878348(VS.85).aspx).

Exemples

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.

Paramètres

-AssignmentCollection

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Remarque : Lorsque le paramètre Global est utilisé, tous les objets sont contenus dans le magasin global. If objects are not immediately used, or disposed of by using the Stop-SPAssignment command, an out-of-memory scenario can occur.

Propriétés du paramètre

Type:SPAssignmentCollection
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Confirm

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Une invite de confirmation apparaît avant d’exécuter le cmdlet.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:cf

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-ConnectionString

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:String
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UnattachedDatabase
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Database

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPDatabasePipeBind
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

AttachedDatabase
Position:Named
Obligatoire:True
Valeur du pipeline:True
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IgnoreSubRangePointOnBoundary

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsAzureDatabase

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

UnattachedDatabase
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-IsUpperSubRange

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:Boolean
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-Range

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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

Propriétés du paramètre

Type:SPScaleOutDataRange
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SubRangeMode

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Propriétés du paramètre

Type:SPScaleOutDatabaseSubRangeMode
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:True
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-SubRangePoint

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

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.

Propriétés du paramètre

Type:

Byte[]

Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

-WhatIf

Applicable : SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

Présente ce qui se produit si le cmdlet s’exécute. Le cmdlet n’est pas exécutée.

Propriétés du paramètre

Type:SwitchParameter
Valeur par défaut:None
Prend en charge les caractères génériques:False
DontShow:False
Alias:Wi

Jeux de paramètres

(All)
Position:Named
Obligatoire:False
Valeur du pipeline:False
Valeur du pipeline par nom de propriété:False
Valeur des arguments restants:False

CommonParameters

Cette applet de commande prend en charge les paramètres courants : -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction et -WarningVariable. Pour plus d’informations, consultez about_CommonParameters.

Entrées

Microsoft.SharePoint.PowerShell.SPDatabasePipeBind

Microsoft.SharePoint.PowerShell.SPAssignmentCollection

Sorties

System.Object