Az PowerShell 模組簡介

概觀

Az PowerShell 模組是一組 Cmdlet，可直接從 PowerShell 管理 Azure 資源。 PowerShell 提供強大的自動化功能，可用來管理 Azure 資源，例如在 CI/CD 流水線的情境中。

Az PowerShell 模組取代了 AzureRM，也是用來與 Azure 互動的建議模組。

警告

自 2024 年 2 月 29 日起，AzureRM PowerShell 模組已正式淘汰。 建議使用者從 AzureRM 遷移到 Az PowerShell 模組，以確保獲得持續的支援和更新。

雖然 AzureRM 模組可能仍可運作，但它已不再維護或支援，若繼續使用則需由用戶自行承擔風險和責任。 請參考我們的 遷移資源，以獲取關於轉換至 Az 模組的指引。

您可以使用 Az PowerShell 模組搭配下列其中一種方法：

• 安裝 Az PowerShell 模組。
• 使用 Azure Cloud Shell。
• 使用 Az PowerShell Docker 容器。

特徵

Az PowerShell 模組具有下列優點：

• 安全性和穩定性
  • Token 緩存加密
  • 防範中間人攻擊類型
  • 支持使用ADFS 2019進行驗證
  • PowerShell 7 中的使用者名稱和密碼驗證
  • 對連續存取評估等功能的支援
• 支援所有 Azure 服務
  • 所有正式運作的 Azure 服務都有對應支援的 PowerShell 模組
  • 自 AzureRM 以來的多個錯誤修正和 API 版本升級
• 新功能
  • Cloud Shell 與跨平台服務的支援
  • 可以取得和使用存取令牌來存取 Azure 資源
  • Azure 資源的進階 REST 作業可使用 Cmdlet 進行

備註

若要搭配所有平台上的 Az PowerShell 模組使用，建議的 PowerShell 版本是 PowerShell 7.2 或更新版本。

Az PowerShell 模組是以 .NET Standard 連結庫為基礎，可在 Windows、Linux 和 macOS 等所有平臺上使用 PowerShell 7.2 和更新版本。 它也與 Windows PowerShell 5.1 相容。

我們致力於為所有平臺提供 Azure 支援，而所有 Az PowerShell 模組都是跨平臺。

將您的環境升級至 Az

若要跟上 PowerShell 中最新的 Azure 功能，您應該移轉至 Az 模組。 若您尚未準備好要安裝 Az 模組來取代 AzureRM，您可以透過下列方式試用 Az：

• 在 PowerShell 環境中使用 Azure Cloud Shell。 Azure Cloud Shell 是一種以瀏覽器為基礎的 Shell 環境，內建已安裝的 Az 模組，並已啟用 Enable-AzureRM 相容性別名。
• 保留 Windows PowerShell 5.1 中安裝的 AzureRM 模組，並在 PowerShell 7 或更新版本中安裝 Az 模組。 Windows PowerShell 5.1 和 PowerShell 7 以及更新版本分別使用不同的模組集合。 請依照指示安裝最新版 PowerShell，然後從 PowerShell 7 或更新版本安裝 Az 模組。

若要從現有的 AzureRM 安裝升級：

1. 將 Azure PowerShell AzureRM 模組解除安裝
2. 安裝 Az PowerShell 模組
3. 選用：當您熟悉新的命令集時，請使用 Enable-AzureRMAlias 啟用相容性模式來新增 AzureRM Cmdlet 的別名。 如需詳細資訊，請參閱下一節或開始從 AzureRM 移轉至 Az。

將現有的腳本從 AzureRM 遷移至 Az

如果您的腳本仍以 AzureRM 模組為基礎，我們有數個資源可協助您進行移轉：

• 開始從 AzureRM 移轉至 Az
• 從 AzureRM 到 Az 1.0.0 的重大變更完整清單
• Enable-AzureRmAlias Cmdlet 指令

保障性

Az 是 Azure 的最新 PowerShell 模組。 問題或功能要求可以直接記錄在 GitHub 存放庫上，或透過 Microsoft 支援，如果您有支援合約。 功能要求會在最新版本的 Az 中實作。 重大問題存在於最近的兩個 Az 版本中。

因為 Az PowerShell 模組現在具有 AzureRM PowerShell 模組的所有功能，因此自 2024 年 2 月 29 日起，我們已淘汰 AzureRM PowerShell 模組。

為了避免服務中斷，將使用 AzureRM PowerShell 模組的腳本更新為使用 Az PowerShell 模組。 若要自動更新您的指令碼，請遵循快速入門指南。

數據採集

Azure PowerShell 預設會收集遙測數據。 Microsoft 彙總收集的資料，以識別使用模式、識別常見的問題，以及改善 Azure PowerShell 的體驗。 Microsoft Azure PowerShell 不會收集任何私人或個人資料。 例如，使用方式數據可協助識別成功率低的 Cmdlet 之類的問題，並協助排定工作優先順序。

我們非常感謝這類資料所提供的見解，但也了解不是每個人都想要傳送使用資料。 您可以使用 Disable-AzDataCollection Cmdlet 停用資料收集。 若要深入了解，您也可以閱讀我們的隱私權聲明。