Set-SPScaleOutDatabaseDataSubRange
Crée une sous-plage pour une base de données de mise à l'échelle spécifiée.
Syntaxe
UnattachedDatabase
Set-SPScaleOutDatabaseDataSubRange
-ConnectionString <String>
-IsUpperSubRange <Boolean>
-Range <SPScaleOutDataRange>
-SubRangeMode <SPScaleOutDatabaseSubRangeMode>
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-IgnoreSubRangePointOnBoundary]
[-IsAzureDatabase]
[-SubRangePoint <Byte[]>]
[-WhatIf]
[<CommonParameters>]
AttachedDatabase
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 à un chaîne de connexion spécifié.
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
C:\PS>$databases = Get-SPScaleOutDatabase -ServiceApplication $serviceApplication
C:\PS>$database = $databases[0]
C:\PS>$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
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.
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.
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
Vous demande une confirmation avant d’exécuter la commande.
Pour plus d’informations, entrez la commande suivante : get-help about_commonparameters
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
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
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
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
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.