Upgrade-SPSite
サイト コレクション上でアップグレード処理を開始します。
構文
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 |
サイト コレクションのアップグレードが完了したときに、メールを送信するかどうかを指定します。
| 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 |