Instalowanie modułu Azure PowerShell

Ukończone

Moduł Azure Az PowerShell jest modułem zbiorczym. Zainstalowanie pobiera dostępne moduły Az PowerShell i udostępnia ich polecenia cmdletów do wykorzystania. Moduł Azure Az programu PowerShell współpracuje z programem PowerShell 7.x i nowszymi wersjami na wszystkich platformach. Program Azure PowerShell nie ma dodatkowych wymagań podczas uruchamiania go w programie PowerShell 7.x i nowszych wersjach.

Aby sprawdzić wersję programu PowerShell, uruchom następujące polecenie z poziomu sesji programu PowerShell:

$PSVersionTable.PSVersion

Przed zainstalowaniem modułu Azure Az programu PowerShell należy ustawić zasady wykonywania skryptu programu PowerShell na RemoteSigned. Możesz to zrobić, uruchamiając następujące polecenie:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Metody instalowania modułu Az programu PowerShell

Moduł Azure Az programu PowerShell można zainstalować przy użyciu jednej z następujących metod:

  • Polecenie Install-Module cmdlet
  • Azure PowerShell MSI
  • Kontener Docker Az PowerShell

Uwaga

Moduł Azure Az dla programu PowerShell jest wstępnie zainstalowany w platformie Azure Cloud Shell. Można go używać bezpośrednio z przeglądarki bez instalowania niczego lokalnie na maszynie. Więcej informacji na temat usługi Azure Cloud Shell znajdziesz w następnej lekcji.

Polecenie cmdlet Install-Module

Użycie polecenia cmdlet Install-Module jest preferowaną metodą instalacji modułu Azure Az programu PowerShell. Należy zainstalować ten moduł tylko dla bieżącego użytkownika. Ten zakres jest zalecanym zakresem instalacji. Ta metoda działa tak samo na platformach Windows, macOS i Linux. Aby zainstalować moduł Az, uruchom następujące polecenie z lokalnej sesji programu PowerShell:

Install-Module -Name Az -Repository PSGallery -Force

Mimo że program PowerShell 7.x jest zalecaną wersją programu PowerShell, a Install-Module jest zalecaną opcją instalacji, możesz również zainstalować moduł Az w środowisku programu PowerShell 5.1 w Windows. Jeśli korzystasz z programu Windows 10 w wersji 1607, Windows 11 lub nowszej, masz już zainstalowany program PowerShell 5.1. Upewnij się również, że masz zainstalowany program .NET Framework 4.7.2 lub nowszy oraz najnowszą wersję modułu PowerShellGet. Aby zainstalować najnowszą wersję modułu PowerShellGet w programie PowerShell 5.1, uruchom następujące polecenie:

Install-Module -Name PowerShellGet -Force

Następnie możesz zainstalować moduł Az przy użyciu tego samego polecenia, którego używasz w programie PowerShell 7.1.

Azure PowerShell MSI

W niektórych środowiskach nie można nawiązać połączenia z Galeria programu PowerShell. W takich sytuacjach można zainstalować moduł Az programu PowerShell w trybie offline, pobierając pakiet MSI programu Azure PowerShell. Pamiętaj, że instalator MSI działa tylko na potrzeby programu PowerShell 5.1 w systemie Windows.

Aby zaktualizować dowolny moduł programu PowerShell, należy użyć tej samej metody, która została użyta do zainstalowania modułu. Jeśli na przykład pierwotnie użyto Install-Module, należy użyć Update-Module, aby pobrać najnowszą wersję. Jeśli pierwotnie użyto pakietu MSI, należy pobrać i zainstalować nowy pakiet MSI.

Kontener Docker Az PowerShell

Istnieje również możliwość uruchomienia programu Azure PowerShell wewnątrz obrazu platformy Docker. Firma Microsoft udostępnia obrazy platformy Docker ze wstępnie zainstalowanym programem Azure PowerShell. Wydane obrazy wymagają platformy Docker 17.05 lub nowszej. Najnowszy obraz kontenera zawiera najnowszą wersję programu PowerShell i najnowsze moduły Azure PowerShell obsługiwane przez moduł Az.

Aby pobrać obraz i uruchomić interaktywną sesję programu PowerShell, należy uruchomić następujące polecenia:

docker pull mcr.microsoft.com/azure-powershell
docker run -it mcr.microsoft.com/azure-powershell pwsh

Rozpoczynanie pracy z programem Azure PowerShell

Aby rozpocząć pracę w środowisku programu Azure PowerShell, najpierw zaloguj się przy użyciu poświadczeń platformy Azure. Ten krok różni się od pracy w czystym programie PowerShell. Poświadczenia platformy Azure są tymi samymi poświadczeniami, których używasz do logowania się do witryny Azure Portal lub innych zasobów opartych na platformie Azure.

Aby zalogować się do platformy Azure z poziomu programu Azure PowerShell, uruchom następujące polecenie:

Connect-AzAccount

Po uruchomieniu tego polecenia zostanie wyświetlony monit o zalogowanie się przy użyciu poświadczeń platformy Azure. Po pomyślnym uwierzytelnieniu na platformie Azure możesz rozpocząć korzystanie z poleceń z modułu Az w celu zarządzania zasobami platformy Azure.