Azure PowerShell のバージョン管理、リリースの周期、破壊的変更

  • [アーティクル]

Az PowerShell モジュールは、PowerShell から直接 Azure リソースを管理するための 70 を超える一般提供 (GA) または安定したサービス モジュールを含むロールアップ モジュールです。

バージョン管理

Az PowerShell モジュールは、バージョン番号付けのためにセマンティック バージョニングに従っています。 Azure サービス モジュールのバージョンは、次の 3 つのカテゴリに分類されます。

  • 一般提供されています。 モジュールのバージョンが 1.0.0 以上で、バージョンに preview が含まれていません。 破壊的変更のポリシーに従います。
  • プレビュー。 バージョン 1.0.0 未満のモジュール。 破壊的変更のポリシーに従いません。
  • 機能プレビュー。 モジュールのバージョンが 1.0.0 以上で、バージョンに preview が含まれています。 破壊的変更のポリシーに従いません。

Az PowerShell ロールアップ モジュールには、次の 2 つがあります。

  • Az。 Azure リソースを管理するためのすべての GA サービス モジュールをインストールします。
  • AzPreview。 Azure リソースを管理するためのすべての GA モジュールとプレビュー モジュールをインストールします。 機能プレビュー モジュールは含まれません。

AzPreview モジュールは常に Az モジュールと同じバージョンであり、同時にリリースされます。

リリース サイクル

Az PowerShell モジュールの計画的な更新プログラムは、毎月第 1 火曜日にリリースされます。 カレンダー年ごとに 12 件の計画的な更新プログラムは、次の 2 つのカテゴリに分類されます。

  • メジャー バージョン。 カレンダー年あたり最大 2 件の破壊的変更が導入されます。 バージョン番号の最初の番号が更新されます。 たとえば、バージョン 6.6.0 からバージョン 7.0.0 になります。
  • マイナー バージョン。 カレンダー年あたり 10 件で、破壊的変更は導入されません。 バージョン番号の 2 番目の番号が更新されます。 たとえば、バージョン 7.0.0 からバージョン 7.1.0 になります。

警告

Az PowerShell モジュールのメジャーな破壊的変更バージョンにアップグレードする前に、移行ガイドを確認する必要があります。

バグを修正するために、計画外のパッチ バージョンがいつでもリリースされる可能性があります。 パッチ バージョンでは、破壊的変更は導入されません。 バージョン番号の 3 番目の番号が更新されます。 たとえば、バージョン 6.2.0 からバージョン 6.2.1 になります。

重大な変更

重要

GA 以外のプレビュー モジュールと機能プレビュー モジュールについては、いつでも破壊的変更が発生する可能性があります。 GA 以外のモジュールは、破壊的変更ポリシーに準拠する必要はありません。

破壊的変更はいつ発生するか

1 年に 2 回、破壊的変更バージョンをリリースします。

  • 春の後半に 1 つ
  • 秋に 1 つ

今後の破壊的変更リリースについては、Azure PowerShell のマイルストーンを参照してください。

破壊的変更の種類

コマンドレットでは、さまざまな種類の破壊的変更が発生する可能性があります。 詳細については、破壊的変更の定義に関するページを参照してください。

破壊的変更のリスト

Az PowerShell モジュールのメジャー リリースでの破壊的変更の詳細については、次の記事を参照してください。

破壊的変更の警告メッセージ

破壊的変更の警告メッセージにより、Azure PowerShell コマンドレットの作成者は、今後の破壊的変更をエンド ユーザーに知らせることができます。

破壊的変更の警告メッセージを抑止する

破壊的変更の警告メッセージを抑止するには、「Azure PowerShell の破壊的変更に関する警告メッセージを無効にするにはどうすればよいですか?」を参照してください。

詳細については、破壊的変更の属性のヘルプに関するページを参照してください。

フィードバックの提供

その他のリソース