Upgrade-SPSite
サイト コレクション上でアップグレード処理を開始します。
構文
Default (既定)
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://<サイト名>/sites/testsite サイト コレクションをアップグレードします。 この操作で SPSite.CompatibilityLevel は変更されません。
例 2
Upgrade-SPSite https://<site name>/sites/testsite -VersionUpgrade
この例では、現在のサイト コレクションの動作モードに関連付けられている使用可能なすべてのビルド間アップグレード操作を使用して、既存の https://<サイト名>/sites/testsite サイト コレクションをアップグレードし、バージョン間のアップグレードを実行します。
パラメーター
-AssignmentCollection
適用対象: 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 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する前に確認メッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | Cf |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
サイト コレクションのアップグレードが完了したときに、メールを送信するかどうかを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Identity
適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
アップグレード処理を実行する SPSite オブジェクトを指定します。
パラメーターのプロパティ
| 型: | SPSitePipeBind |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | 1 |
| 必須: | True |
| パイプラインからの値: | True |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Priority
適用対象: SharePoint Server 2016、SharePoint Server 2019
サイトをアップグレードする優先度を指定します。
有効な値は次のいずれかです。
128 から 255 (低優先度)
11 から 127 (標準優先度)
0 から 10 (高優先度)
パラメーターのプロパティ
| 型: | Byte |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-QueueOnly
適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
タイマー ジョブによって管理される遅延アップグレードのキューにサイトを入れることを指定します。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-Unthrottled
適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
ファームの管理者を指定して、スロットルをバイパスします。これにより、スロットル内にあるアップグレード対象のサイト コレクションが "多すぎる" 場合でも、サイト コレクションをアップグレードできます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-VersionUpgrade
適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
SPSite オブジェクトでバージョン間のアップグレードを実行することを指定します。 このパラメーターを設定すると、現在のサイト コレクションの動作モードに関連付けられている、使用可能なすべてのビルド間アクションが内部的にトリガーされます。 次のバージョンごとの操作により、新しいサイト コレクションの動作モードに関連付けられているすべての新しいビルド間の操作を含む、サイト コレクションを次のサイト コレクションの動作モードに移行します。 このパラメーターが設定されていない場合は、現在のサイト コレクションの動作モードに関連付けられている、使用可能なビルド間のアップグレード アクションのみがトリガーされます。
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
-WhatIf
適用対象: SharePoint Server 2013、SharePoint Server 2016、SharePoint Server 2019
コマンドを実行する代わりに、コマンドの実行結果を説明するメッセージを表示します。
詳細については、次のコマンドを入力します。get-help about_commonparameters
パラメーターのプロパティ
| 型: | SwitchParameter |
| 規定値: | None |
| ワイルドカードのサポート: | False |
| DontShow: | False |
| Aliases: | wi |
パラメーター セット
(All)
| 配置: | Named |
| 必須: | False |
| パイプラインからの値: | False |
| プロパティ名別のパイプラインからの値: | False |
| 残りの引数からの値: | False |
CommonParameters
このコマンドレットは、共通パラメーター -Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction、-WarningVariable をサポートします。 詳細については、「about_CommonParameters」を参照してください。