Upgrade-SPContentDatabase
失敗したデータベース アップグレードを再開するか、またはビルド間のデータベース アップグレードを開始します。
構文
Upgrade-SPContentDatabase
[-Identity] <SPContentDatabasePipeBind>
[-ForceDeleteLock]
[-AssignmentCollection <SPAssignmentCollection>]
[-Confirm]
[-NoB2BSiteUpgrade]
[-ServerInstance <SPDatabaseServiceInstancePipeBind>]
[-SkipIntegrityChecks]
[-UseSnapshot]
[-WhatIf]
[-AllowUnattached]
[-SkipSiteUpgrade]
[<CommonParameters>] Upgrade-SPContentDatabase
[-ForceDeleteLock]
-Name <String>
-WebApplication <SPWebApplicationPipeBind>
[-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 ファームに接続していないコンテンツ データベースで、アップグレード処理を続行できるようにします。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-AssignmentCollection
適切な破棄を行うためにオブジェクトを管理します。 SPWeb や SPSite などのオブジェクトの使用によって大量のメモリが使用される場合があるので、Windows PowerShell スクリプトでこれらのオブジェクトを使用するには適切なメモリ管理が必要です。 メモリの解放が必要になった場合は、SPAssignment オブジェクトを使用して、変数へのオブジェクトの割り当てとオブジェクトの破棄を行うことができます。 割り当てコレクションまたは Global パラメーターが使用されていない場合、SPWeb、SPSite、または SPSiteAdministration オブジェクトが使用されていると、オブジェクトは自動的に破棄されます。
Global パラメーターが使用されている場合は、オブジェクトはすべてグローバル ストアに格納されます。
Stop-SPAssignment コマンドを使用してオブジェクトの使用または破棄を直接行わないと、メモリ不足のシナリオになる場合があります。
| Type: | SPAssignmentCollection |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Confirm
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。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 |
-ForceDeleteLock
アップグレードを開始する前に、データベースのロックを強制的に削除します。
| Type: | SwitchParameter |
| Position: | 2 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Identity
アップグレードするコンテンツ データベースを指定します。
値は、12345678-90ab-cdef-1234-567890bcdefgh という形式の有効な GUID であるか、有効な SPContentDatabase オブジェクト インスタンスであることが必要です。
| Type: | SPContentDatabasePipeBind |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-Name
接続されたコンテンツ データベースの名前を指定します。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-NoB2BSiteUpgrade
ビルド間アップグレードを実行するときにすべての子オブジェクトをアップグレードしないことを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-ServerInstance
接続されたコンテンツ データベースをホストする SQL Server インスタンスを指定します。
| Type: | SPDatabaseServiceInstancePipeBind |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SkipIntegrityChecks
アップグレード プロセスの一部として、テンプレートの不足や孤立検出などの内部整合性チェックを実行しないようにアップグレード プロセスを指定します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-SkipSiteUpgrade
アップグレードを実行するときにデータベースとその子オブジェクトをアップグレードしないことを指定します。
| Type: | SwitchParameter |
| Aliases: | NoB2BSiteUpgrade |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-UseSnapshot
スナップショット手法を使用して非接続アップグレードを実行することを指定します。 これにより、現在のデータベースのスナップショットが作成され、データベースに適用されるすべてのアップグレード操作が実行され、必要に応じてその内容に適用されます。
コンテンツ データベースへの既存の接続は、アップグレードの間スナップショットを使用するように設定され、アップグレードが正常に完了した後に切り替えられます。 アップグレードが失敗すると、データベースはスナップショット取得時の状態に戻されます。
このパラメーターは、スナップショットの作成と使用をサポートするバージョンのSQL Server (SQL ServerEnterprise エディションなど) でのみ機能します。
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WebApplication
接続されたコンテンツ データベースをホストする Web アプリケーションを指定します。
| Type: | SPWebApplicationPipeBind |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | SharePoint Server Subscription Edition |
-WhatIf
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。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 |