共用方式為

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 模組具有下列優點：

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

注意

PowerShell 7.2 或更高版本是建議的 PowerShell 版本，可用於所有平臺上的 Az PowerShell 模組。

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 是一種以瀏覽器為基礎的殼層環境，內建已安裝的 Az 模組並啟用 Enable-AzureRM 相容性別名。
  • 將 AzureRM 模組安裝在 Windows PowerShell 5.1 中，並在 PowerShell 7 或更新版本中安裝 Az 模組。 Windows PowerShell 5.1 和 PowerShell 7 和更新版本使用不同的模組集合。 依照指示安裝 最新版的 PowerShell，然後 從 PowerShell 7 或更新版本安裝 Az 模組。

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

  1. 卸載 Azure PowerShell AzureRM 模組
  2. 安裝 Az PowerShell 模組
  3. OPTIONAL：啟用相容性模式，以使用 Enable-AzureRMAlias 為 AzureRM Cmdlet 新增別名，同時熟悉新的命令集。 如需詳細資訊，請參閱下一節或 從 AzureRM 開始移轉到 Az。

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

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

保障性

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 停用資料收集。 您也可以閱讀我們的 隱私聲明 以深入瞭解。