次の方法で共有


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

-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