Azure PowerShell とは

Azure PowerShell は、PowerShell から Azure リソースを直接管理するためのコマンドレットのセットです。 Azure PowerShell は、簡単に学習して使い始めることができるように設計されていますが、自動化のための強力な機能が用意されています。

Az PowerShell モジュール

重要

Az PowerShell モジュールは、Azure リソースを管理するためにすべてのプラットフォームで推奨される PowerShell モジュールです。

Az PowerShell モジュールは .NET Standard に基づいており、Windows、Linux、macOS を含むすべてのプラットフォーム上の PowerShell 7.2 以上で動作します。 また Windows PowerShell 5.1 と互換性があります

Note

PowerShell 7.2 以上が、すべてのプラットフォームで Az PowerShell モジュールに使用できる PowerShell の推奨バージョンです。

Az PowerShell モジュールは、Windows、Linux、macOS にローカルにインストールできます。 また、Azure Cloud Shell を介してブラウザーから使用したり、Docker コンテナー内から使用することもできます。 詳細については、「Azure PowerShell のドキュメント」をご覧ください。

認証

Azure PowerShell では、複数の認証方法がサポートされています。 Az PowerShell モジュールからの Azure に対する認証の詳細については、「Azure PowerShell を使用したサインイン」を参照してください。

モジュール設計

Az PowerShell モジュールは、Azure サービス関連の PowerShell モジュールのラッパー モジュールであり、通常、Azure サービスごとに 1 つのモジュールです。たとえば、Azure ネットワーク サービスの場合は Az.Network、Azure Kubernetes Service の場合 は Az.AKS などです。

Az PowerShell モジュールのコマンドレットは、Azure API に対して REST 呼び出しを行います。 Az PowerShell モジュールの破壊的変更は、年に 2 回に制限されています。 API レベルでの多くの破壊的変更は、破壊的変更の認識を防ぐために、コマンドレット内で処理されます。

Az PowerShell モジュールには、Azure でコントロール プレーンとデータ プレーンの両方の操作を実行するためのコマンドレットが含まれます。 コントロール プレーンは、サブスクリプション内のリソースを管理するために使用します。 データ プレーンは、リソースの種類のインスタンスによって公開される機能を使用するために使用します。 詳細については、「Azure コントロール プレーンとデータ プレーン」を参照してください。

出力オブジェクト

Az PowerShell モジュールのコマンドレットでは、.NET オブジェクトが生成されます。 出力を生成するすべての PowerShell コマンドと同様に、Az PowerShell モジュール内のコマンドレットを Get-Member コマンドレットにパイプ処理して、使用可能なプロパティとメソッドの一覧と共に生成されるオブジェクトの種類を決定できます。 詳細については、「Azure PowerShell のクエリ出力」と「Azure PowerShell コマンドレット出力の書式設定」を参照してください。

その他のモジュール

AzureAD および MSOnline の PowerShell モジュールは、Az PowerShell モジュールの一部ではありません。 これらのモジュールの詳細については、「Graph 用 Azure Active Directory PowerShell」のドキュメントを参照してください。

従来の Azure PowerShell モジュール

AzureRM PowerShell モジュール

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

AzureRM PowerShell モジュールは非推奨となり、新機能は追加されなくなり、クロス プラットフォームではありません。 詳細については、AzureRM PowerShell モジュールの概要に関するページをご覧ください。

Azure PowerShell モジュール

重要

Azure PowerShell モジュールのコマンドレットは、Service Management API を使用する従来の Azure リソースを管理するためのコマンドレットです。

Azure PowerShell モジュールのコマンドレットの一部は非推奨となりました。他のものは、対応するリファレンス ドキュメント ページに示されているように、既存のお客様に対して提供終了が通知されたことから、新しいお客様には非推奨となっています。 詳細については、「Azure PowerShell Service Management モジュールの概要」をご覧ください