Upgrade-SPContentDatabase

リファレンス

モジュール:: sharepoint-server

適用対象:: SharePoint Server Subscription Edition

失敗したデータベースアップグレードを再開するか、またはビルド間のデータベースアップグレードを開始します。

構文

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