Azure PowerShell 的離線安裝

在某些環境中，無法連上網際網路或 PowerShell Gallery。在這些情況下，您可以使用其中一種方法離線安裝 Az PowerShell 模組。

備註

本文中的離線安裝選項需要至少一個具有因特網存取權的系統才能下載 Az PowerShell 模組，該模組可能與您計劃安裝模組的系統不同。

先決條件

安裝支援的 PowerShell 第 7 版或更新版本
如果你使用的是 Windows 作業系統，也支援 Windows PowerShell 5.1。

跨平台

以下 Az PowerShell 模組的安裝選項可在所有平台（包括 Windows、Linux 與 macOS）跨平台使用。

從 tar 壓縮檔安裝

小提示

需要命令列公用程式才能使用此安裝選項。預設支援 Windows 10 版本 1803 或更高版本、大多數 Linux 發行版以及目前版本的 macOS。

在可存取網際網路的系統上，定義您要儲存 tar 保存檔的目的地路徑。
```
$downloadFolderPath = "$home/Downloads"
```

確認下載資料夾是否存在。在其他情況下，建立資料夾。

if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
    New-Item -Path $downloadFolderPath -ItemType Directory
}

請在 GitHub 上確定最新版本 Az PowerShell 模組的 tar 壓縮檔網址。

$tarSourceUrl = (
    Invoke-RestMethod -Uri https://api.github.com/repos/azure/azure-powershell/releases/latest |
    Select-Object -ExpandProperty assets | Where-Object content_type -eq 'application/x-gzip'
).browser_download_url

將 tar 檔案名稱和目的地檔案路徑儲存在變數中。

$fileName = Split-Path -Path $tarSourceUrl -Leaf
$downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName

使用 PowerShell 從 GitHub 下載 tar 壓縮檔。

Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath

如果你使用的是 Windows 作業系統，請解除封鎖已下載的檔案。
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
備註

將 tar 保存檔複製到離線系統。在您離線系統上使用下列命令時，請定義變數並指定實際值，而不是使用這些命令中的變數。

提取 tar 檔案的內容。

tar zxf $downloadFilePath -C $downloadFolderPath

在您想要安裝 Az PowerShell 模組的離線系統上，執行其中一個解壓縮的檔案中的腳本。
```
.$downloadFolderPath/InstallModule.ps1
```

儲存和複製安裝

使用具備網際網路和 PowerShell Gallery 存取權的系統，透過 Save-Module 或 Save-PSResource 將 Az PowerShell 模組下載到網路位置。這些命令會將 Az 模組及其相依性儲存至指定的位置。使用已儲存的模組作為安裝來源，並將其複製到離線系統。

從私人存放庫安裝

在本地網絡上創建一個私人存儲庫，並將其用作離線系統的安裝源。若要深入瞭解，請參閱使用私人 PowerShellGet 存放庫。

此方法可讓您在單一伺服器或檔案共用上快取 PowerShell 模組，以使用 PowerShellGet 或 Microsoft.PowerShell.PSResourceGet 部署至任何中斷連線的系統。

Windows

在 Windows 上，如果你使用 Windows PowerShell 5.1 版本，也可以選擇用 MSI 安裝 Az PowerShell 模組。

這很重要

請注意，MSI 安裝程式只支援 Windows PowerShell 5.1。

用 MSI 安裝程式安裝 Windows 上的 Azure PowerShell。

Troubleshooting

如需 Az PowerShell 模組常見安裝問題的解決方案，請參閱針對 Az PowerShell 模組的安裝問題進行疑難排解。

另請參閱

儲存模組
Save-PSResource

後續步驟

想了解如何使用 Az PowerShell 模組管理您的Azure資源，請參閱 Get Start with Azure PowerShell。

Last updated on 2026-04-07