Azure Networking documentation update: Change prerelease string to empty for Az.NetworkCloud は、Azure PowerShell の Az.NetworkCloud モジュールを「preview扱い」から外すためのメタデータ変更です。結論から言うと、Azure Networking や NetworkCloud リソースの設定、API、既存のクラスター構成を直接変更する更新ではありません。ただし、PowerShell Gallery、CI/CD、Azure Automation、社内リポジトリで Az.NetworkCloud をインストール・更新している管理者は、-AllowPrerelease やバージョン固定の扱いを確認する必要があります。GitHub の公式 PR では、2026年5月20日に Az.NetworkCloud.psd1 の prerelease string を空にする変更が main ブランチへマージされています。(GitHub)
Azure Networking documentation updateで何が変わったのか
今回の変更点は、src/NetworkCloud/NetworkCloud/Az.NetworkCloud.psd1 にある PowerShell モジュールマニフェストの PrivateData.PSData.Prerelease です。PR の説明には「Updated prerelease string to empty in Az.NetworkCloud.psd1.」とあり、差分では Prerelease = 'preview' が有効な設定として残らない形に変更されています。現在の main ブランチ上の Az.NetworkCloud.psd1 でも、# Prerelease = '' はコメント行として残っています。(GitHub)
| 確認項目 | 変更内容 | 実務上の意味 |
|---|---|---|
| 対象ファイル | Az.NetworkCloud.psd1 | PowerShell モジュールの公開メタデータが対象 |
| 変更前 | Prerelease = 'preview' | PowerShell Gallery などで prerelease として扱われる可能性がある |
| 変更後 | prerelease string を空扱いにする | 通常版、つまり非 prerelease として扱われる方向の変更 |
| 直接変わらないもの | NetworkCloud リソース、Azure Networking の設定、既存クラスター | 既存環境のネットワーク構成を自動で変更する更新ではない |
| 確認すべきもの | インストール、更新、バージョン固定、Automation 実行環境 | モジュール取得方法によって挙動が変わる可能性がある |
重要なのは、この変更を「新しいネットワーク機能の追加」や「Azure Networking の設定変更」と混同しないことです。対象は Az.NetworkCloud モジュールのマニフェストであり、Azure リソースそのものの変更ではありません。
Az.NetworkCloudとは何か
Az.NetworkCloud は、Azure PowerShell から NetworkCloud 関連リソースを操作するためのモジュールです。Microsoft Learn のモジュールページには、ベアメタルマシン、クラスター、Kubernetes クラスター、L2/L3 ネットワーク、トランクネットワーク、ボリュームなどを扱う多数のコマンドレットが掲載されています。(Microsoft Learn)
NetworkCloud は、主に Azure Operator Nexus と関係する領域です。Azure Operator Nexus は通信事業者向けのキャリアグレードなハイブリッドクラウドプラットフォームで、ネットワーク集中型ワークロードやミッションクリティカルなアプリケーション向けに設計されています。Microsoft の説明では、ネットワークファブリック、ベアメタルホスト、ストレージアプライアンスなどのライフサイクル管理を自動化するサービスとして位置付けられています。(Microsoft Learn)
また、Network Cloud REST API は、オンプレミスのクラスターやラック、ベアメタルホスト、仮想マシン、ワークロードネットワークなどを管理する API として説明されています。つまり Az.NetworkCloud は、一般的な仮想ネットワーク管理というより、通信事業者や大規模インフラ向けの NetworkCloud / Operator Nexus 管理で使われるモジュールと考えると理解しやすくなります。(Microsoft Learn)
prerelease stringが空になると何が起きるのか
PowerShell の prerelease は、単なる表示上のラベルではありません。Microsoft の PowerShell Gallery ドキュメントでは、モジュールマニフェストの PSData セクションに Prerelease string を追加すると、そのモジュールは prerelease バージョンとして識別されると説明されています。また、prerelease パッケージを Find-Module、Install-Module、Update-Module、Save-Module で取得するには、通常 -AllowPrerelease が必要です。(Microsoft Learn)
そのため、Az.NetworkCloud の prerelease string が空扱いになると、次のような違いが出る可能性があります。
| 利用場面 | これまで起きやすかったこと | 変更後に確認すべきこと |
|---|---|---|
Find-Module | -AllowPrerelease を付けないと preview 版が見えない | 通常の検索で対象バージョンが見えるか確認する |
Install-Module | preview 版の取得に -AllowPrerelease が必要 | -AllowPrerelease なしで意図した版が入るか確認する |
Update-Module | prerelease を含めるかどうかで更新候補が変わる | 更新後のバージョンとモジュールパスを確認する |
| CI/CD | 2.0.0-preview のような接尾辞付きバージョンを前提にすることがある | exact version の指定を見直す |
| Azure Automation | インポート済みモジュールや依存関係が固定されている場合がある | Runbook の実行環境で読み込まれる版を確認する |
ただし、「prerelease string が空になった」ことと「すべての API や機能が完全に一般提供になった」ことは同じ意味ではありません。PR のチェックリストでも、target release と API readiness は別概念として扱われています。運用判断では、モジュールの表示ラベルだけでなく、リリースノート、破壊的変更の案内、実際に利用しているコマンドレットの動作確認を合わせて見るべきです。(GitHub)
影響を受けやすい対象者
今回の Azure Networking documentation update は、全 Azure 利用者に緊急対応を求める内容ではありません。影響が出やすいのは、Az.NetworkCloud を明示的に使っている環境です。
| 対象者 | 影響度 | 確認ポイント |
|---|---|---|
| Azure Operator Nexus / NetworkCloud 管理者 | 高 | クラスター、ベアメタル、L2/L3 ネットワーク操作用スクリプトで Az.NetworkCloud を使っているか |
| PowerShell で Azure Networking 関連運用を自動化している開発者 | 中〜高 | Install-Module、Update-Module、Import-Module の指定方法 |
| CI/CD パイプライン管理者 | 中 | -AllowPrerelease、RequiredVersion、社内ミラーのキャッシュ |
| Azure Automation Runbook 管理者 | 中 | Automation アカウントに入っている Az モジュールのバージョンと依存関係 |
| Azure ポータル中心で運用している担当者 | 低 | 直接の影響は小さいが、PowerShell 自動化を併用していないか確認 |
特に、通信事業者向けの Operator Nexus 環境では、ネットワークファブリック、Kubernetes クラスター、ベアメタルホストなどの操作が業務影響に直結します。メタデータ変更であっても、更新のタイミングは検証環境で確認してから本番へ展開するのが安全です。(Microsoft Learn)
管理者がまず確認すべき設定
インストール済みのAz.NetworkCloudを確認する
最初に、端末や実行環境に入っている Az.NetworkCloud のバージョンを確認します。
Get-Module -ListAvailable Az.NetworkCloud |
Sort-Object Version -Descending |
Select-Object Name, Version, PathPowerShellGet でインストール済みモジュールを管理している場合は、次のコマンドも確認に使えます。
Get-InstalledModule Az.NetworkCloud -AllVersions -ErrorAction SilentlyContinue |
Select-Object Name, Version, InstalledLocationprerelease 情報をより直接確認したい場合は、モジュールマニフェストの PrivateData.PSData.Prerelease を見ます。
$module = Get-Module -ListAvailable Az.NetworkCloud |
Sort-Object Version -Descending |
Select-Object -First 1
$module.PrivateData.PSData.Prerelease空、または値が返らない場合は、そのローカルモジュールでは prerelease string が有効設定として入っていないと判断できます。
PowerShell Gallery上の見え方を確認する
PowerShell Gallery から取得している場合は、通常版と prerelease 版の見え方を比べます。
Find-Module -Name Az.NetworkCloud -Repository PSGallery
Find-Module -Name Az.NetworkCloud -Repository PSGallery -AllowPrereleaseMicrosoft の prerelease ドキュメントでは、-AllowPrerelease を付けると prerelease パッケージが含まれ、付けない場合は prerelease パッケージが表示されないと説明されています。今回の変更後に通常検索で意図したバージョンが見えるなら、スクリプト側で -AllowPrerelease に依存し続ける必要があるかを見直せます。(Microsoft Learn)
インストール・更新コマンドを見直す
Azure PowerShell のインストールでは Install-Module -Name Az -Repository PSGallery -Force、更新では Update-Module -Name Az -Force が案内されています。ただし、Update-Module は古いバージョンを削除しないため、複数バージョンが残っている環境では、どのモジュールが読み込まれているかまで確認が必要です。(Microsoft Learn)
Az.NetworkCloud を単体で管理している場合は、次のようにテスト環境で確認します。
Install-Module -Name Az.NetworkCloud -Scope CurrentUser -Force
Import-Module Az.NetworkCloud -Force
Get-Command -Module Az.NetworkCloud | Measure-Object本番環境では、いきなり最新版へ追従するより、検証済みバージョンを明示したほうが安全です。
Install-Module -Name Az.NetworkCloud -RequiredVersion 2.0.0 -Scope CurrentUser -Forceここで注意したいのは、以前のスクリプトが 2.0.0-preview のような prerelease 接尾辞付きのバージョン文字列を前提にしているケースです。prerelease string が空になると、同じ ModuleVersion でもバージョン文字列の扱いが変わるため、RequiredVersion の指定を実際の公開バージョンに合わせて更新する必要があります。
Azure Automationでの注意点
Azure Automation で Az.NetworkCloud を使う Runbook がある場合は、ローカル端末だけでなく Automation アカウント側のモジュール状態を確認してください。Microsoft Learn では、Azure Automation の Az モジュール更新はポータルから行う手順が案内されており、既定の Az モジュールを選択してバージョンとランタイムを指定する流れになっています。(Microsoft Learn)
確認すべきポイントは次の3つです。
| 確認項目 | 見るべき場所 | 失敗しやすい例 |
|---|---|---|
| モジュールバージョン | Automation アカウントの「モジュール」 | ローカルでは更新済みだが Automation では旧版のまま |
| 依存モジュール | Az.Accounts などの依存関係 | Az.NetworkCloud だけ更新して依存モジュールと不整合が出る |
| Runbook の指定 | Import-Module、スクリプト内のバージョン前提 | preview 接尾辞を前提にした条件分岐が残っている |
Runbook は、まず読み取り系のコマンドで検証します。たとえば、クラスターやネットワーク一覧の取得など、状態変更を伴わない処理から確認してください。
Import-Module Az.NetworkCloud
Get-Command -Module Az.NetworkCloud |
Select-Object -First 10 Name本番のクラスター操作、再イメージ化、削除、更新系コマンドをテストなしで実行するのは避けるべきです。
CI/CDや社内リポジトリで見落としやすいポイント
CI/CD では、Az.NetworkCloud を毎回 PowerShell Gallery から取得しているとは限りません。社内の NuGet フィード、プロキシ、キャッシュ、コンテナイメージ、ビルドエージェントの事前インストール済みモジュールを使っている場合があります。
特に次のような指定は見直し対象です。
Install-Module -Name Az.NetworkCloud -AllowPrerelease -ForceInstall-Module -Name Az.NetworkCloud -RequiredVersion 2.0.0-preview -AllowPrerelease -Force-AllowPrerelease 自体が悪いわけではありません。問題は、「preview 版を取ること」を前提にしたスクリプトが、通常版へ移行した後も正しく動くかどうかです。安定版として公開されるバージョンを利用するなら、RequiredVersion を実在するバージョンに合わせ、不要な preview 接尾辞を外すことを検討してください。
また、コンテナ化されたデプロイ環境では、ベースイメージに古い Az.NetworkCloud が残っていることがあります。Update-Module は古いバージョンを自動削除しないため、Import-Module が想定外のパスから読み込んでいないかも確認してください。(Microsoft Learn)
展開前の実務チェックリスト
本番展開前には、以下の順で確認すると抜け漏れを減らせます。
| 手順 | 作業 | 判断基準 |
|---|---|---|
| 現状把握 | 端末、CI/CD、Automation の Az.NetworkCloud バージョンを一覧化する | どの環境にどの版が入っているか分かる |
| スクリプト棚卸し | AllowPrerelease、RequiredVersion、Az.NetworkCloud を検索する | preview 前提の記述が見つかる |
| 検証環境で更新 | 本番と同じ手順でモジュールをインストールする | インストール、インポート、依存関係でエラーが出ない |
| 読み取り系テスト | Get-* 系コマンドを中心に実行する | 認証、権限、接続、戻り値が想定どおり |
| 変更系テスト | 影響の小さい対象で New-*、Update-*、Remove-* を検証する | 既存スクリプトのパラメーターが通る |
| 本番展開 | バージョンを固定して段階的に反映する | ロールバック手順がある |
| 展開後確認 | 実行ログ、Runbook ジョブ、パイプライン結果を確認する | 旧版読み込みや失敗ジョブがない |
更新後の最低限の確認には、次のようなコマンドが使えます。
Import-Module Az.NetworkCloud -Force
Get-Module Az.NetworkCloud |
Select-Object Name, Version, Path
Get-Command -Module Az.NetworkCloud |
Group-Object Verb |
Sort-Object Count -DescendingGet-Module の Path は必ず見てください。複数バージョンが残っている環境では、意図したバージョンではなく、古いパスのモジュールを読み込んでいることがあります。
よくある誤解と注意点
「previewが外れたなら本番で即更新してよい」は危険
prerelease string が空になったことは、PowerShell Gallery や PowerShellGet 上の扱いに関係するメタデータ変更です。実際の API readiness、破壊的変更、個別コマンドレットの互換性までは別途確認が必要です。PR のチェックリストでも target release と API readiness は別概念として注意されています。(GitHub)
「Azure Networking全体が変わる」という更新ではない
今回の対象は Az.NetworkCloud.psd1 です。Azure Virtual Network、Azure Firewall、Application Gateway、ExpressRoute など、一般的な Azure Networking リソースの設定が自動変更されるものではありません。NetworkCloud / Operator Nexus 関連の PowerShell モジュールを利用している環境を中心に確認すれば十分です。
「-AllowPrereleaseを消せばよい」と単純化しない
-AllowPrerelease を外すかどうかは、社内のモジュール取得方針によります。preview 版を意図的に検証環境へ入れているチームでは、引き続き必要な場合があります。逆に、本番で通常版だけを使う方針なら、-AllowPrerelease が残っていることで意図しない候補を拾う可能性があります。
「Azバンドル」と「Az.NetworkCloud単体」の違いを確認する
Az モジュール全体を更新している環境と、Az.NetworkCloud を単体でインストールしている環境では、更新手順や依存関係の見え方が変わります。PowerShell Gallery の Az.NetworkCloud ページでは、モジュール単体のインストールコマンドや依存関係、関数一覧、リリースノートを確認できます。([PowerShell Gallery][8])
この記事の結論と次に取るべき行動
今回の Azure Networking documentation update: Change prerelease string to empty for Az.NetworkCloud は、Az.NetworkCloud の prerelease 表示・取得方法に関わるモジュールマニフェスト更新です。既存の Azure Networking 設定や NetworkCloud リソースを直接変更するものではありませんが、PowerShell のインストール、更新、CI/CD、Azure Automation では影響が出る可能性があります。
まずやるべきことは、Az.NetworkCloud を使っているスクリプトを検索し、-AllowPrerelease、RequiredVersion、社内フィード、Automation モジュールの4点を確認することです。そのうえで、検証環境に通常版として取得される Az.NetworkCloud を入れ、読み取り系コマンドから動作確認を進めてください。メタデータ変更は小さく見えますが、インフラ自動化では「どのモジュールを、どのバージョンで、どの実行環境が読み込むか」が安定運用の分かれ目です。
[8]: https://www.powershellgallery.com/packages/Az.NetworkCloud/2.0.0 “
PowerShell Gallery
| Az.NetworkCloud 2.0.0
“
コメント