Upgrade-SPSite

リファレンス

モジュール:: SharePointServer

適用対象:: SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

サイトコレクション上でアップグレード処理を開始します。

構文

Upgrade-SPSite
       [-Identity] <SPSitePipeBind>
       [-AssignmentCollection <SPAssignmentCollection>]
       [-Confirm]
       [-Email]
       [-QueueOnly]
       [-Unthrottled]
       [-VersionUpgrade]
       [-WhatIf]
       [-Priority <Byte>]
       [<CommonParameters>]

説明

コマンドレットは Upgrade-SPSite 、サイトコレクションでアップグレードプロセスを開始します。

コマンドレットは Upgrade-SPSite 、指定された SPSite オブジェクトのアップグレードプロセスをアクティブ化します。このコマンドレットを使って、失敗したアップグレード処理を再開することもできます。このコマンドレットを使って SPSite オブジェクトのアップグレードを開始する場合、ビルドからビルドへのアップグレードとバージョンからバージョンへのアップグレードのどちらかを指定できます。

既定では、コマンドレットは Upgrade-SPSite ビルドからビルドへのアップグレードとして動作します。これによって、このコマンドレットを修正プログラム適用操作の後に使う場合に、サイトコレクションのバージョンアップグレードを予期せず行うことはありません。バージョンからバージョンへのアップグレードモードでは、サイトコレクションの正常性チェックを修復モードで実行し、サイトコレクションが正常で正しくアップグレードできることを確認します。問題がなければ、アップグレードの残りの処理を行います。

Windows PowerShell for SharePoint 製品のアクセス許可と最新情報については、「SharePoint Server コマンドレット」のオンラインドキュメントをご覧ください。

例

------------- 例 1 ----------

Upgrade-SPSite https://<site name>/sites/testsite

次の使用例は、現在のサイトコレクションの操作モードに関連付けられている使用可能なビルドからビルドへのアップグレードアクションのみを使用して、既存<の https:// サイト名>/サイト/テストサイトサイトコレクションをアップグレードします。この操作で SPSite.CompatibilityLevel は変更されません。

------------- 例 2 ----------

Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade

次の使用例は、現在の<サイトコレクションの動作モードに関連付け、バージョンからバージョンへのアップグレードを実行するすべての使用可能なビルドからビルドへのアップグレードアクションを使用して、既存の https:// サイト名>/サイト/テストサイトサイトコレクションをアップグレードします。

パラメーター

-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 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2013, SharePoint Server 2016, SharePoint Server 2019

-Email

サイトコレクションのアップグレードが完了したときに、メールを送信するかどうかを指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Identity

アップグレード処理を実行する SPSite オブジェクトを指定します。

Type:	SPSitePipeBind
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Priority

サイトをアップグレードする優先度を指定します。

有効な値は次のいずれかです。

128 から 255 (低優先度)
11 から 127 (標準優先度)
0 から 10 (高優先度)

Type:	Byte
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2016, SharePoint Server 2019

-QueueOnly

タイマージョブによって管理される遅延アップグレードのキューにサイトを配置することを指定します。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-Unthrottled

ファームの管理者を指定して、スロットルをバイパスします。これにより、スロットル内にあるアップグレード対象のサイトコレクションが "多すぎる" 場合でも、サイトコレクションをアップグレードできます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-VersionUpgrade

SPSite オブジェクトでバージョンからバージョンへのアップグレードを実行するように指定します。このパラメーターを設定すると、現在のサイトコレクションの動作モードに関連付けられている使用可能なすべてのビルドからビルドへのアクションが内部的にトリガーされます。次のバージョン間アクションは、新しいサイトコレクションの操作モードに関連付けられているすべての新しいビルドからビルドへのアクションを含む、サイトコレクションを次のサイトコレクションの操作モードに移動します。このパラメーターが設定されていない場合、現在のサイトコレクションの動作モードに関連付けられている使用可能なビルドからビルドへのアップグレードアクションのみがトリガーされます。

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	SharePoint Server 2013, SharePoint Server 2016, SharePoint Server 2019

-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 2013, SharePoint Server 2016, SharePoint Server 2019

Share via