Upgrade-SPContentDatabase
Relance une mise à niveau ayant échoué ou débute une mise à niveau d'une base de données build à build.
Syntaxe
ContentDatabaseById
Upgrade-SPContentDatabase
[-Identity] <SPContentDatabasePipeBind>
[-ForceDeleteLock]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-NoB2BSiteUpgrade]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-SkipIntegrityChecks]
[-UseSnapshot]
[-WhatIf]
[-AllowUnattached]
[-SkipSiteUpgrade]
[<CommonParameters>]
ContentDatabaseByName
Upgrade-SPContentDatabase
-Name <String>
-WebApplication <SPWebApplicationPipeBind>
[-ForceDeleteLock]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-NoB2BSiteUpgrade]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-SkipIntegrityChecks]
[-UseSnapshot]
[-WhatIf]
[-AllowUnattached]
[-SkipSiteUpgrade]
[<CommonParameters>]
Description
Cette applet de commande 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 les Jeux de paramètres des applets de commande.
Utilisez l’applet Upgrade-SPContentDatabase de commande pour reprendre une mise à niveau de base de données ayant échoué ou commencer une mise à niveau de base de données de build à build sur une base de données de contenu SharePoint.
L’applet Upgrade-SPContentDatabase de commande lance une mise à niveau d’une base de données de contenu existante qui est attachée à la batterie de serveurs actuelle.
Cette applet de commande commence une nouvelle session de mise à niveau, qui peut être utilisée soit pour reprendre une mise à niveau version à version ou build à build échouée d’une base de données de contenu ou pour commencer une mise à niveau build à build d’une base de données de contenu.
Si la base de données est hébergée sur une version de SQL Server qui prend en charge la création et l’utilisation d’instantanés de la base de données, cette applet de commande peut utiliser une base de données instantané pour les mises à niveau de build à build. Lors de la mise à niveau, les utilisateurs voient une version en lecture seule de la base de données qui est l’instantané. Après la mise à niveau, les utilisateurs voient le contenu mis à niveau.
Le comportement par défaut de cette applet de commande met à niveau le schéma de la base de données et lance des mises à niveau build à build pour toutes les collections de sites situées dans la base de données de contenu spécifiée, si nécessaire. Pour empêcher les mises à niveau build à build des collections de sites, utilisez le paramètre NoB2BSiteUpgrade.
Cette applet de commande ne déclenche pas de mise à niveau version-à-version d’une collection de site.
Exemples
EXEMPLE 1
Upgrade-SPContentDatabase WSS_Content
Cet exemple met à niveau le schéma de base de données de contenu WSS_Content existant, puis exécute uniquement les actions de mise à niveau build à build sur les collections de sites existantes, si nécessaire. Cette opération ne change pas CompatibilityLevel pour les collections de sites existantes dans cette base de données.
EXEMPLE 2
Upgrade-SPContentDatabase WSS_Content -NoB2BSiteUpgrade
Cet exemple met à niveau uniquement le schéma de base de données de contenu WSS_Content existant. Aucune action de mise à niveau build à build n’est effectuée sur les collections de sites. Cette opération ne change pas CompatibilityLevel pour les collections de sites existantes dans cette base de données.
EXEMPLE 3
Upgrade-SPContentDatabase WSS_Content -NoB2BSiteUpgrade -UseSnapshot
Cet exemple met à niveau le schéma de base de données de contenu WSS_Content existant uniquement lors de l'utilisation d'un instantané de la base de données pour conserver un accès en lecture seule au contenu lors de la mise à niveau. Aucune action de mise à niveau build à build n'est effectuée sur les collections de sites. Cette opération ne change pas CompatibilityLevel pour les collections de sites existantes dans cette base de données.
Paramètres
-AllowUnattached
Applicable : SharePoint Server 2016, SharePoint Server 2019
Permet au processus de mise à niveau de continuer sur une base de données de contenu qui n’est pas liée à une batterie de serveurs SharePoint.
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 |
-AssignmentCollection
Applicable : SharePoint Server 2010, 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 2010, 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 |
-ForceDeleteLock
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Oblige la suppression des verrous sur la base de données avant de démarrer la mise à niveau.
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: | 2 |
| Obligatoire: | False |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Identity
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie la base de données de contenu à mettre à niveau.
La valeur doit être un GUID valide au format 12345678-90ab-cdef-1234-567890bcdefgh ou une instance d'un objet SPContentDatabase valide.
Propriétés du paramètre
| Type: | SPContentDatabasePipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ContentDatabaseById
| Position: | 1 |
| Obligatoire: | True |
| Valeur du pipeline: | True |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-Name
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le nom de la base de données de contenu associée.
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
ContentDatabaseByName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-NoB2BSiteUpgrade
Applicable : SharePoint Server 2010, SharePoint Server 2013
Spécifie que les objets enfants ne sont pas mis à niveau lors d'une mise à niveau build à build.
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 |
-ServerInstance
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
L'instance SQL Server qui héberge la base de données de contenu associée.
Propriétés du paramètre
| Type: | SPDatabaseServiceInstancePipeBind |
| 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 |
-SkipIntegrityChecks
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie le processus de mise à niveau pour ne pas exécuter les vérifications d’intégrité internes telles que les modèles manquants et la détection orpheline dans le cadre du processus de mise à niveau.
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 |
-SkipSiteUpgrade
Applicable : SharePoint Server 2016, SharePoint Server 2019
Spécifie que les bases de données et leurs objets enfants ne doivent pas être mis à niveau pendant la mise à niveau.
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: | NoB2BSiteUpgrade |
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 |
-UseSnapshot
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie l'utilisation de la méthode d'instantané pour exécuter une mise à niveau détachée. Cela crée une instantané de la base de données active, puis effectue toutes les opérations de mise à niveau qui s’appliquent à la base de données et éventuellement à son contenu.
Les connexions existantes à la base de données de contenu sont définies pour utiliser le instantané pendant la durée de la mise à niveau, puis réaméndées une fois la mise à niveau réussie. L'échec de la mise à niveau retourne la base de données à l'état qu'elle avait avant la prise de l'instantané.
Ce paramètre fonctionne uniquement pour les versions de SQL Server qui prennent en charge la création et l’utilisation d’instantanés, par exemple SQL ServerEnterprise Edition.
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 |
-WebApplication
Applicable : SharePoint Server 2010, SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019
Spécifie l'application web qui héberge la base de données de contenu associée.
Propriétés du paramètre
| Type: | SPWebApplicationPipeBind |
| Valeur par défaut: | None |
| Prend en charge les caractères génériques: | False |
| DontShow: | False |
Jeux de paramètres
ContentDatabaseByName
| Position: | Named |
| Obligatoire: | True |
| Valeur du pipeline: | False |
| Valeur du pipeline par nom de propriété: | False |
| Valeur des arguments restants: | False |
-WhatIf
Applicable : SharePoint Server 2010, 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.