Instalacja w trybie offline programu Azure PowerShell

Artykuł
02/19/2025

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.

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ł.

Warunki wstępne

Instalowanie obsługiwanej wersji programu PowerShell w wersji 7 lub nowszej
Program Windows PowerShell 5.1 jest również obsługiwany, jeśli korzystasz z systemu operacyjnego Windows.

Międzyplatformowe

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

Napiwek

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 przeciwnym razie.

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
}
```
Notatka

Skopiuj archiwum tar do systemu offline. Zdefiniuj zmienne $downloadFilePath i $downloadFolderPath lub określ wartości rzeczywiste zamiast używać zmiennych w następujących poleceniach w 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 programu PowerShell z Save-Module lub Save-PSResource do lokalizacji sieciowej przy użyciu systemu z dostępem do Internetu i galerii programu 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 PowerShellGet.

Ta metoda umożliwia buforowanie modułów programu PowerShell na jednym serwerze lub udziale plików, które mają być wdrażane przy użyciu 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żny

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ą za pomocą modułu Az programu PowerShell.

Zobacz też

Następne 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