Upgrade-SPOSite
サイト コレクション上でアップグレード処理を開始します。
構文
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 |