Instalowanie programu Azure PowerShell w systemie Windows za pomocą modułu PowerShellGet

  • Artykuł

Ostrzeżenie

Moduł AzureRM PowerShell został oficjalnie przestarzały od 29 lutego 2024 r. Zaleca się migrowanie użytkowników z modułu AzureRM do modułu Az programu PowerShell w celu zapewnienia ciągłej obsługi i aktualizacji.

Mimo że moduł AzureRM może nadal działać, nie jest już utrzymywany ani obsługiwany, umieszczając wszelkie dalsze zastosowania według uznania i ryzyka użytkownika. Zapoznaj się z naszymi zasobami migracji, aby uzyskać wskazówki dotyczące przejścia do modułu Az.

W tym artykule opisano kroki instalowania modułów programu Azure PowerShell w programie PowerShell 5.x w systemie Windows przy użyciu modułu PowerShellGet. Moduł PowerShellGet i funkcja zarządzania modułami to preferowany sposób instalacji programu Azure PowerShell, ale jeśli wolisz go zainstalować za pomocą Instalatora platformy internetowej lub pakietu MSI, zobacz Inne metody instalacji.

Klasyczny model wdrażania platformy Azure nie jest obsługiwany przez tę wersję programu Azure PowerShell. Aby uzyskać pomoc techniczną w przypadku wdrożeń klasycznych, postępuj zgodnie z instrukcjami na stronie Instalowanie modułu zarządzania usługami programu Azure PowerShell.

Ważne

Moduł AzureRM nie jest obsługiwany w systemach macOS i Linux. Aby używać poleceń cmdlet programu Azure PowerShell na tych platformach, należy zainstalować moduł Az.

Wymagania

Począwszy od programu Azure PowerShell w wersji 6.0, jest wymagany program PowerShell w wersji 5.0. Aby sprawdzić, która wersja programu PowerShell działa na komputerze, uruchom następujące polecenie:

$PSVersionTable.PSVersion

Jeśli masz nieaktualną wersję, zapoznaj się z sekcją Uaktualnianie istniejącego programu Windows PowerShell.

Ważne

Moduł opisany w tym dokumencie (AzureRM) korzysta z programu .NET Framework. Dlatego jest on niezgodny z programem PowerShell 6.0, który korzysta z platformy .NET Core. Jeśli korzystasz z programu PowerShell 6.0, postępuj zgodnie z instrukcjami dotyczącymi instalacji dla systemów macOS i Linux.

Instalowanie modułu Azure PowerShell

Do zainstalowania modułów z galerii programu PowerShell jest wymagany podwyższony poziom uprawnień. Aby zainstalować program Azure PowerShell, uruchom następujące polecenie w sesji z podwyższonym poziomem uprawnień:

Install-Module -Name AzureRM -AllowClobber

Uwaga

Jeśli masz wersję pakietu NuGet starszą niż 2.8.5.201, zostanie wyświetlony monit o pobranie i zainstalowanie najnowszej wersji pakietu NuGet.

Galeria programu PowerShell domyślnie nie jest skonfigurowana jako zaufane repozytorium modułu PowerShellGet. Po pierwszym użyciu Galerii programu PowerShell zostanie wyświetlony następujący komunikat:

Untrusted repository

You are installing the modules from an untrusted repository. If you trust this repository, change
its InstallationPolicy value by running the Set-PSRepository cmdlet.

Are you sure you want to install the modules from 'PSGallery'?
[Y] Yes  [A] Yes to All  [N] No  [L] No to All  [S] Suspend  [?] Help (default is "N"):

Wybierz odpowiedź Yes lub Yes to All, aby kontynuować instalację.

Moduł AzureRM to zbiorczy moduł poleceń cmdlet programu Azure PowerShell. Po jego zainstalowaniu są pobierane wszystkie dostępne moduły usługi Azure Resource Manager i są udostępniane do użycia ich polecenia cmdlet.

Zaloguj

Aby rozpocząć pracę z programem Azure PowerShell, zaloguj się przy użyciu swoich poświadczeń platformy Azure.

# Connect to Azure with an interactive dialog for sign-in
Connect-AzureRmAccount

Uwaga

Jeśli wyłączono automatyczne ładowanie modułów, musisz ręcznie zaimportować moduł za pomocą polecenia Import-Module AzureRM. Ze względu na strukturę modułu może to potrwać kilka sekund.

Musisz powtórzyć te kroki dla każdej nowej sesji programu PowerShell, którą rozpoczniesz. Aby dowiedzieć się, jak można utrwalić logowanie się do swojego konta platformy Azure w wielu sesjach programu PowerShell, zobacz Utrwalanie poświadczeń użytkownika między sesjami programu PowerShell.

Aktualizowanie modułu programu Azure PowerShell

Możesz zaktualizować instalację programu Azure PowerShell przez uruchomienie polecenia Update-Module. To polecenie nie powoduje odinstalowania wcześniejszych wersji.

Update-Module -Name AzureRM

Jeśli chcesz usunąć starsze wersje programu Azure PowerShell z systemu, zobacz Odinstalowywanie modułu programu Azure PowerShell.

Korzystanie z wielu wersji programu Azure PowerShell

Jest możliwe zainstalowanie więcej niż jednej wersji programu Azure PowerShell. Aby sprawdzić, czy masz wiele zainstalowanych wersji programu Azure PowerShell, użyj następującego polecenia:

Get-InstalledModule -Name AzureRM -AllVersions |
  Select-Object -Property Name, Version

Aby usunąć wersję programu Azure PowerShell, zobacz Odinstalowywanie modułu programu Azure PowerShell.

Obecność więcej niż jednej wersji może być potrzebna w przypadku pracy z lokalnymi zasobami usługi Azure Stack, korzystania ze starszej wersji systemu Windows lub używania klasycznego modelu wdrażania platformy Azure. Aby zainstalować starszą wersję, podaj argument -RequiredVersion podczas instalacji.

# Install version 2.3.0 of Azure PowerShell
Install-Module -Name AzureRM -RequiredVersion 2.3.0

Podczas ładowania modułu Azure PowerShell jest domyślnie ładowana najnowsza wersja. Aby załadować inną wersję, określ RequiredVersion parametr .

# Load version 2.3.0 of Azure PowerShell
Import-Module -Name AzureRM -RequiredVersion 2.3.0

Przekazywanie opinii

Jeśli znajdziesz błąd podczas korzystania z programu Azure Powershell, zgłoś problem w usłudze GitHub. Aby przekazać opinię z wiersza polecenia, użyj polecenia cmdlet Send-Feedback.

Następne kroki

Aby zacząć korzystać z programu Azure PowerShell i dowiedzieć się więcej o module i jego funkcjach, zobacz Rozpoczęcie korzystania z programu Azure PowerShell.