Start-AzureRmSqlServerUpgrade
SQL Database サーバーのアップグレードを開始します。
警告
AzureRM PowerShell モジュールは、2024 年 2 月 29 日の時点で正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。
AzureRM モジュールは引き続き機能する可能性がありますが、メインが維持またはサポートされなくなり、ユーザーの判断とリスクで引き続き使用できます。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。
構文
Start-AzureRmSqlServerUpgrade
-ServerVersion <String>
[-ScheduleUpgradeAfterUtcDateTime <DateTime>]
[-DatabaseCollection <RecommendedDatabaseProperties[]>]
[-ElasticPoolCollection <UpgradeRecommendedElasticPoolProperties[]>]
-ServerName <String>
[-ResourceGroupName] <String>
[-DefaultProfile <IAzureContextContainer>]
[<CommonParameters>]
説明
Start-AzureRmSqlServerUpgrade コマンドレットは、Azure SQL Database サーバー バージョン 11 からバージョン 12 へのアップグレードを開始します。 Get-AzureRmSqlServerUpgrade コマンドレットを使用して、アップグレードの進行状況を監視できます。
例
例 1: サーバーをアップグレードする
PS C:\>Start-AzureRmSqlServerUpgrade -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ServerVersion 12.0
ResourceGroupName : ResourceGroup01
ServerName : Server01
ServerVersion : 12.0
ScheduleUpgradeAfterUtcDateTime :
DatabaseCollection :
このコマンドは、リソース グループ TesourceGroup01 に割り当てられている server01 という名前のサーバーをアップグレードします。
例 2: スケジュール時刻とデータベースの推奨事項を使用してサーバーをアップグレードする
PS C:\>$ScheduleTime = (Get-Date).AddMinutes(5).ToUniversalTime()
PS C:\> $DatabaseMap = New-Object -TypeName Microsoft.Azure.Management.Sql.Models.RecommendedDatabaseProperties
PS C:\> $DatabaseMap.Name = "contosodb"
PS C:\> $DatabaseMap.TargetEdition = "Standard"
PS C:\> $DatabaseMap.TargetServiceLevelObjective = "S0"
PS C:\> Start-AzureRmSqlServerUpgrade -ResourceGroupName "ResourceGroup01" -ServerName "Server01" -ServerVersion 12.0 -ScheduleUpgradeAfterUtcDateTime $ScheduleTime -DatabaseCollection ($DatabaseMap)
最初のコマンドは、Get-Date コマンドレットを使用して、5 分後に時刻を作成します。
このコマンドは、変数$ScheduleTimeに日付を格納します。
詳細を表示するには「Get-Help Get-Date
」を入力します。
2 番目のコマンドは RecommendedDatabaseProperties オブジェクトを作成し、そのオブジェクトを変数$DatabaseMapに格納します。
次の 3 つのコマンドは、$DatabaseMapに格納されているオブジェクトのプロパティに値を割り当てます。
最後のコマンドは、Server01 という名前の既存のサーバーをバージョン 12.0 にアップグレードします。
アップグレードの最も早い時間は、$ScheduleTime変数で指定されたコマンドの実行後 5 分です。
アップグレード後、データベース contosodb は Standard エディションを実行し、サービス レベル目標 S0 を持ちます。
パラメーター
-DatabaseCollection
このコマンドレットがサーバーの アップグレードに使用する RecommendedDatabaseProperties オブジェクトの配列を指定します。
型: | RecommendedDatabaseProperties[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzureRmContext, AzureCredential |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ElasticPoolCollection
サーバーの アップグレードに使用する UpgradeRecommendedElasticPoolProperties オブジェクトの配列を指定します。
型: | UpgradeRecommendedElasticPoolProperties[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ResourceGroupName
サーバーが割り当てられているリソース グループの名前を指定します。
型: | String |
配置: | 0 |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ScheduleUpgradeAfterUtcDateTime
サーバーをアップグレードする最も早い時刻を DateTime オブジェクトとして指定します。
ISO8601形式の値を世界協定時刻 (UTC) で指定します。
詳細を表示するには「Get-Help Get-Date
」を入力します。
型: | Nullable<T>[DateTime] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-ServerName
このコマンドレットをアップグレードするサーバーの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | True |
ワイルドカード文字を受け取る: | False |
-ServerVersion
このコマンドレットがサーバーをアップグレードするバージョンを指定します。 有効な値は 12.0 のみです。
型: | String |
配置: | Named |
規定値: | None |
必須: | True |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
入力
出力
AzureSqlServerUpgradeStartModel