Instalacja w trybie offline programu Azure PowerShell

2025-07-01

W niektórych środowiskach nie można nawiązać połączenia z Internetem ani z galerią programu PowerShell. W takich sytuacjach można zainstalować moduł Az programu PowerShell w trybie offline przy użyciu jednej z tych metod.

Uwaga / Notatka

Opcje instalacji w trybie offline w tym artykule wymagają co najmniej jednego systemu z dostępem do Internetu w celu pobrania modułu Az PowerShell, który może różnić się od systemu, w którym planujesz zainstalować moduł.

Wymagania wstępne

Instalowanie obsługiwanej wersji programu PowerShell w wersji 7 lub nowszej
Program Windows PowerShell 5.1 jest również obsługiwany w przypadku korzystania z systemu operacyjnego Windows.

Wieloplatformowe

Następujące opcje instalacji modułu Az programu PowerShell są dostępne międzyplatformowo na wszystkich platformach, w tym windows, Linux i macOS.

Instalowanie z archiwum tar

Wskazówka

Do korzystania z tej opcji instalacji jest wymagane narzędzie wiersza polecenia tar. Jest on domyślnie dostępny w systemie Windows 10 w wersji 1803 lub nowszej, większości dystrybucji systemu Linux i bieżących wersjach systemu macOS.

W systemie z dostępem do Internetu zdefiniuj ścieżkę docelową, w której chcesz zapisać archiwum tar.
```
$downloadFolderPath = "$home/Downloads"
```

Sprawdź, czy folder pobierania istnieje. Utwórz folder w inny sposób.

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

Określ adres URL archiwum tar dla najnowszej wersji modułu Az programu PowerShell w usłudze GitHub.

$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

Zapisz nazwę pliku tar i docelową ścieżkę pliku w zmiennych.

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

Pobierz archiwum tar z usługi GitHub przy użyciu programu PowerShell.
```
Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath
```
Odblokuj pobrany plik, jeśli korzystasz z systemu operacyjnego Windows.
```
if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
    Unblock-File -Path $downloadFilePath
}
```
Uwaga / Notatka

Skopiuj archiwum tar do systemu offline. Zdefiniuj zmienne $downloadFilePath i $downloadFolderPath lub podaj rzeczywiste wartości zamiast używać zmiennych w poniższych poleceniach na swoim systemie offline.

Wyodrębnij zawartość archiwum tar.

tar zxf $downloadFilePath -C $downloadFolderPath

Uruchom skrypt InstallModule.ps1, który jest jednym z plików, które zostały wyodrębnione w systemie offline, w którym chcesz zainstalować moduł Az PowerShell.
```
.$downloadFolderPath/InstallModule.ps1
```

Zapisywanie i kopiowanie instalacji

Pobierz moduł Az dla PowerShell za pomocą Save-Module lub Save-PSResource do lokalizacji sieciowej, używając systemu z dostępem do internetu i galerii PowerShell. Te polecenia zapisują moduł Az i jego zależności do określonej lokalizacji. Użyj zapisanych modułów jako źródła instalacji i skopiuj je do systemu offline.

Instalowanie z repozytorium prywatnego

Utwórz repozytorium prywatne w sieci lokalnej i użyj go jako źródła instalacji dla systemu offline. Aby dowiedzieć się więcej, zobacz Praca z prywatnymi repozytoriami programu PowerShellGet.

Ta metoda umożliwia buforowanie modułów programu PowerShell na jednym serwerze lub udziale plików, które mają być wdrażane za pomocą modułu PowerShellGet lub Microsoft.PowerShell.PSResourceGet do wszystkich odłączonych systemów.

Windows

W systemie Windows możesz również zainstalować moduł Az PowerShell za pomocą instalatora MSI, jeśli używasz wersji 5.1 programu Windows PowerShell.

Ważne

Należy pamiętać, że instalator MSI działa tylko dla programu Windows PowerShell 5.1.

Zainstaluj program Azure PowerShell w systemie Windows przy użyciu Instalatora MSI.

Rozwiązywanie problemów

Aby uzyskać rozwiązania typowych problemów z instalacją modułu Az programu PowerShell, zobacz Rozwiązywanie problemów z instalacją modułu Az programu PowerShell.

Zobacz także

Dalsze kroki

Aby dowiedzieć się więcej na temat zarządzania zasobami platformy Azure za pomocą modułu Az programu PowerShell, zobacz Rozpoczynanie pracy z programem Azure PowerShell.

Udostępnij za pośrednictwem