Upgrade-SPOSite

  • リファレンス
モジュール:
Microsoft.Online.SharePoint.PowerShell
適用対象:
SharePoint Online

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

構文

Upgrade-SPOSite
       [-Confirm]
       -Identity <SpoSitePipeBind>
       [-NoEmail]
       [-QueueOnly]
       [-VersionUpgrade]
       [-WhatIf]
       [<CommonParameters>]

説明

Upgrade-SPOSite コマンドレットは、指定した SharePoint Online サイト コレクションのアップグレード処理を起動します。 このコマンドレットを使用して、失敗したアップグレード処理を再開することもできます。

アップグレードの開始時に、ビルドからビルドへのアップグレードとバージョンからバージョンへのアップグレードのどちらにするかを指定できます。 既定では、ビルドからビルドへのアップグレードになります。 バージョンからバージョンへのアップグレードを実行すると、まず、サイト コレクションの正常性チェックが修復モードで実行され、そのサイト コレクションを正しくアップグレードできることが確認されます。

コマンドレットを実行するには、SharePoint Online 管理者かグローバル管理者で、かつサイト コレクション管理者でもある必要があります。

SharePoint Online の Windows PowerShell のアクセス許可と最新の情報については、「SharePoint Online 管理シェルの概要」を参照してください。

例

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

Upgrade-SPOSite -Identity https://contoso.sharepoint.com/sites/marketing

例 1 では、既存のサイト コレクション https://contoso.sharepoint.com/sites/marketing. にビルドからビルドへのアップグレードを実行します。この操作によって、サイト コレクションに関連付けられている CompatibilityLevel プロパティは変更されません。 CompatibilityLevel の詳細については、「New-SPOSite」を参照してください。

例 2

Upgrade-SPOSite -Identity https://contoso.sharepoint.com/sites/marketing -VersionUpgrade

例 2 では、既存のサイト コレクション https://contoso.sharepoint.com/sites/marketing. にバージョンからバージョンへのアップグレードを実行します。この操作によって、サイト コレクションに関連付けられている CompatibilityLevel プロパティは SharePoint 2013 の値に変更されます。 CompatibilityLevel の詳細については、「New-SPOSite」を参照してください。

パラメーター

-Confirm

コマンドレットを実行する前に確認メッセージを表示します。

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-Identity

アップグレードする SharePoint Online サイト コレクションを指定します。

Type:SpoSitePipeBind
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False
Applies to:SharePoint Online

-NoEmail

アップグレード処理完了時に通知の電子メール メッセージを要求者およびサイト コレクション管理者に送信しないことを指定します。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-QueueOnly

アップグレード キューにサイト コレクションを追加します。 アップグレードは即座には実行されません。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-VersionUpgrade

サイト コレクションに対してバージョンからバージョンへのアップグレードを実行するかどうかを指定します。 このパラメーターを設定すると、現在のサイト コレクションの動作モードに関連付けられている使用可能なビルドからビルドへのアップグレードが内部的にトリガーされ、バージョンからバージョンへのアップグレードが続行されます。 このパラメーターを設定しなかった場合、サイト コレクションに対してビルドからビルドへのアップグレードのみが開始されます。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online

-WhatIf

コマンドレットが実行されるとどうなるかを示します。 コマンドレットは実行されません。

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:SharePoint Online