Upgrade-SPContentDatabase
失敗したデータベース アップグレードを再開するか、またはビルド間のデータベース アップグレードを開始します。
構文
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>]
説明
このコマンドレットには、複数のパラメーター セットが含まれています。 使用できるのは、1 つのパラメーター セットのパラメーターだけであり、異なるパラメーター セットのパラメーターを組み合わせることはできません。 パラメーター セットの使用法に関する詳しい情報については、「コマンドレットのパラメーター セット」を参照してください。
Upgrade-SPContentDatabase コマンドレットを使用して、失敗したデータベースのアップグレードを再開するか、SharePoint コンテンツ データベースに対してビルドからビルドへのデータベースアップグレードを開始します。
Upgrade-SPContentDatabase コマンドレットは、現在のファームに接続されている既存のコンテンツ データベースのアップグレードを開始します。
このコマンドレットは、新しいアップグレード セッションを開始します。これは、失敗したバージョンからバージョンへのアップグレードを再開したり、コンテンツ データベースのビルドからビルドへのアップグレードを再開したり、コンテンツ データベースのビルドからビルドへのアップグレードを開始したりするために使用できます。
データベースが、データベースのスナップショットの作成と使用をサポートするバージョンのSQL Serverでホストされている場合、このコマンドレットは、ビルドからビルドへのアップグレードにデータベース スナップショットを使用できます。 アップグレードの間、ユーザーにはスナップショットが読み取り専用バージョンのデータベースとして提供されます。 アップグレードが終了すると、ユーザーにはアップグレードされたコンテンツが提供されます。
このコマンドレットの既定の動作では、データベースのスキーマがアップグレードされ、必要に応じて、指定したコンテンツ データベース内のすべてのサイト コレクションのビルド間アップグレードが開始されます。 サイト コレクションのビルドからビルドへのアップグレードを防ぐには、NoB2BSiteUpgrade パラメーターを使用します。
このコマンドレットでは、サイト コレクションのバージョンからバージョンへのアップグレードは行われません。
例
例 1
Upgrade-SPContentDatabase WSS_Content
この例では、既存の WSS_Content コンテンツ データベース スキーマをアップグレードした後、必要に応じて、既存のサイト コレクションに対するビルド間アップグレード操作のみを実行します。 この操作では、このデータベース内の既存のサイト コレクションに対する CompatibilityLevel は変更されません。
例 2
Upgrade-SPContentDatabase WSS_Content -NoB2BSiteUpgrade
この例では、既存の WSS_Content コンテンツ データベース スキーマのみをアップグレードします。 どのサイト コレクションに対してもビルド間のアップグレード操作は実行しません。 この操作では、このデータベース内の既存のサイト コレクションに対する CompatibilityLevel は変更されません。
例 3
Upgrade-SPContentDatabase WSS_Content -NoB2BSiteUpgrade -UseSnapshot
この例では、アップグレードの間もデータベースのスナップショットを使用してコンテンツへの読み取り専用アクセスを維持しながら、既存の WSS_Content コンテンツ データベース スキーマだけをアップグレードします。 どのサイト コレクションに対してもビルド間のアップグレード操作は実行しません。 この操作では、このデータベース内の既存のサイト コレクションに対する CompatibilityLevel は変更されません。
パラメーター
-AllowUnattached
適用対象: SharePoint Server 2016、SharePoint Server 2019
現在 SharePoint ファームに接続していないコンテンツ データベースで、アップグレード処理を続行できるようにします。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-AssignmentCollection
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。
Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
パラメーターのプロパティ
| 型: | SPAssignmentCollection |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Confirm
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ForceDeleteLock
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
アップグレードを開始する前に、データベースのロックを強制的に削除します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 2 |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
アップグレードするコンテンツ データベースを指定します。
値は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、有効な SPContentDatabase オブジェクト インスタンスであることが必要です。
パラメーターのプロパティ
| 型: | SPContentDatabasePipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ContentDatabaseById
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Name
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
接続されたコンテンツ データベースの名前を指定します。
パラメーターのプロパティ
| 型: | String |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ContentDatabaseByName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-NoB2BSiteUpgrade
適用対象: SharePoint Server 2010、SharePoint Server 2013
ビルド間アップグレードを実行するときにすべての子オブジェクトをアップグレードしないことを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-ServerInstance
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
接続されたコンテンツ データベースをホストする SQL Server インスタンスを指定します。
パラメーターのプロパティ
| 型: | SPDatabaseServiceInstancePipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipIntegrityChecks
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
アップグレード プロセスの一部として、テンプレートの不足や孤立検出などの内部整合性チェックを実行しないようにアップグレード プロセスを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-SkipSiteUpgrade
適用対象: SharePoint Server 2016、SharePoint Server 2019
アップグレードを実行するときにデータベースとその子オブジェクトをアップグレードしないことを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | NoB2BSiteUpgrade |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-UseSnapshot
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
スナップショット手法を使用して非接続アップグレードを実行することを指定します。 これにより、現在のデータベースのスナップショットが作成され、データベースとその内容に必要に応じて適用されるすべてのアップグレード操作が実行されます。
コンテンツ データベースへの既存の接続は、アップグレードの間、スナップショットを使用するように設定され、アップグレードが正常に完了した後に切り替えられます。 アップグレードが失敗すると、データベースはスナップショット取得時の状態に戻されます。
このパラメーターは、スナップショットの作成と使用をサポートするバージョンのSQL Server (SQL ServerEnterprise エディションなど) でのみ機能します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WebApplication
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
接続されたコンテンツ データベースをホストする Web アプリケーションを指定します。
パラメーターのプロパティ
| 型: | SPWebApplicationPipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
ContentDatabaseByName
| 配置: | Named |
| 必須: | True |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
該当: SharePoint Server 2010、SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | ウィスコンシン |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットでは、一般的なパラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable の各パラメーターがサポートされています。 詳細については、「about_CommonParameters」を参照してください。