- 05/14/2020
- 6 minut do odczytu
-
- m
- h
w tym artykule wyjaśniono, jak zainstalować moduły platformy Azure PowerShell przy użyciu PowerShellGet. Instrukcje te działają na platformach Windows,macOS i Linux.
Usługa Azure PowerShell jest również dostępna w usłudze Azure Cloud Shell i jest teraz instalowana w obrazach dokera.
wymagania
Uwaga
PowerShell 7.,x i nowsza jest zalecaną wersją PowerShell do użytku z Azure PowerShell na wszystkich platformach.
Azure PowerShell działa z PowerShell 6.2.4 i nowszymi na wszystkich platformach. Jest również obsługiwany wpowershell 5.1 w systemie Windows. Zainstaluj najnowszą wersję PowerShell dla Twojego systemu operacyjnego. Usługa Azure PowerShell nie ma dodatkowych wymagań, gdy jest uruchamiana w wersji PowerShell 6.2.4 lub nowszej.
aby sprawdzić wersję programu PowerShell, uruchom polecenie:
$PSVersionTable.PSVersion
aby użyć usługi Azure PowerShell w programie PowerShell 5.1 w systemie Windows:
- zaktualizuj program PowerShell 5.1.,Jeśli korzystasz z systemu Windows 10 w wersji 1607 lub wyższej, masz już zainstalowany program PowerShell 5.1.
- zainstaluj. NET Framework 4.7.2 lub nowszy.
- upewnij się, że masz najnowszą wersję PowerShellGet. Uruchom
Install-Module -Name PowerShellGet -Force
.
zainstaluj moduł Azure PowerShell
Ostrzeżenie
nie obsługujemy instalacji modułów AzureRM i Az dla PowerShell 5.1 w systemie Windows w tym samym czasie. Jeśli chcesz, aby usługa AzureRM była dostępna w Twoim systemie, zainstaluj moduł Az forPowerShell w wersji 6.2.4 lub nowszej.,
zainstaluj dla bieżącego użytkownika
przy użyciu cmdletów PowerShellGet jest preferowaną metodą instalacji. Zainstaluj moduł Az tylko dla bieżącego użytkownika. Jest to zalecany zakres instalacji. Ta metoda działa tak samo na platformach Windows, macOS i Linux. Uruchom następujące polecenie z sesji PowerShell:
domyślnie Galeria PowerShell nie jest skonfigurowana jako zaufane repozytorium PowerShellGet., Po pierwszym użyciu PSGallery zobaczysz następujący monit:
Odpowiedz Yes
lub Yes to All
aby kontynuować instalację.
instalacja dla wszystkich użytkowników
instalacja modułu dla wszystkich użytkowników w systemie wymaga podwyższonych uprawnień. Uruchom sesję Powershells używając Run as administrator w systemie Windows lub użyj polecenia sudo
w systemie macOS lub Linux:
moduł Az jest modułem rollup dla cmdletów Azure PowerShell., Instalując program pobiera wszystkie ogólnie dostępne moduły Az PowerShell i udostępnia ich cmdlety do użytku.
Zainstaluj w trybie offline
w niektórych środowiskach nie można połączyć się z Galerią PowerShell. W takich sytuacjach nadal można zainstalować moduły w trybie offline za pomocą jednej z następujących metod:
-
Pobierz moduły do innej lokalizacji w sieci i użyj ich jako źródła instalacji.Ta metoda pozwala na buforowanie modułów PowerShell na jednym serwerze lub udział plików, które mają być wdrożone z PowerShellGet do dowolnych odłączonych systemów., Dowiedz się, jak skonfigurować lokalne repozytorium i zainstalować odłączone systemy współpracujące z lokalnymi repozytoriami PowerShellGet.
-
Pobierz aplikację Azure PowerShell MSI na komputer podłączony do sieci, a następnie skopiuj instalator do systemów bez dostępu do galerii PowerShell. Należy pamiętać, że instalator theMSI działa tylko dla PowerShell 5.1 w systemie Windows.,
-
Zapisz moduł za pomocą Save-Module do udziału w pliku lub zapisz go w innym źródle i ręcznie skopiuj go na inne maszyny:
Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
Rozwiązywanie problemów
oto niektóre typowe problemy widoczne podczas instalacji modułu Azure PowerShell. Jeśli napotkasz problem nie wymieniony tutaj, Zgłoś problem na GitHub.
Proxy blokuje połączenie
Jeśli pojawią się błędy z Install-Module
wskazujące, że Galeria PowerShell jest nieosiągalna, być może za proxy., Różne systemy operacyjne i środowisko sieciowe mają różne wymagania dotyczące konfiguracji serwera proxy dla całego systemu. Skontaktuj się z administratorem systemu, aby uzyskać informacje o ustawieniach serwera proxy i jak skonfigurować je dla swojego środowiska.
Sam PowerShell może nie być skonfigurowany do automatycznego używania tego proxy. W PowerShell 5.1 andlater skonfiguruj sesję PowerShell tak, aby używała proxy za pomocą następujących poleceń:
jeśli poświadczenia systemu operacyjnego są poprawnie skonfigurowane, Ta konfiguracja przekierowuje zapytania PowerShell za pośrednictwem proxy., Aby to ustawienie było utrzymywane między sesjami, Dodaj polecenia do swojego profilu PowerShell.
aby zainstalować pakiet, serwer proxy musi zezwolić na połączenia HTTPS pod następującym adresem:
Sign in
To start working with Azure PowerShell, sign in with your Azure credentials.
Note
If you’ve disabled module autoloading, manually import the module with Import-Module -Name Az
.Ze względu na strukturę modułu może to potrwać kilka sekund.
musisz powtórzyć te kroki dla każdej nowej sesji PowerShell, którą rozpoczniesz. Aby dowiedzieć się, jak logować się na platformie Azure w różnych sesjach PowerShell, zapoznaj się z listą poświadczeń użytkowników w różnych sesjach PowerShell.,
zaktualizuj moduł Azure PowerShell
aby zaktualizować dowolny moduł PowerShell, należy użyć tej samej metody, której użyto do zainstalowania modułu. Na przykład, jeśli pierwotnie użyłeś Install-Module
, powinieneś użyć Update-Module, aby uzyskać najnowszą wersję. Jeśli używasz pakietu MSI to powinieneś pobrać i zainstalować nowy pakiet MSI.
cmdlety PowerShellGet nie mogą aktualizować modułów zainstalowanych z pakietu MSI. MSIpackages nie aktualizuje modułów zainstalowanych przy użyciu PowerShellGet., Jeśli masz jakieś problemy z aktualizacją za pomocą PowershellGet, powinieneś ponownie zainstalować, zamiast aktualizować. Ponowna instalacja jest taka sama jak instalacja, ale musisz dodać -Force
parametr:
w przeciwieństwie do instalacji opartych na MSI, instalacja lub aktualizacja za pomocą PowerShellGet nie usuwa starszych wersji, które mogą istnieć w Twoim systemie. Aby usunąć stare wersje usługi Azure PowerShell z systemu,zobacz Odinstaluj moduł Azure PowerShell. Aby uzyskać więcej informacji na temat instalacji opartych na MSI, zobacz Instalowanie usługi Azure PowerShell za pomocą MSI.,
Użyj wielu wersji usługi Azure PowerShell
możliwe jest zainstalowanie więcej niż jednej wersji usługi Azure PowerShell. Aby sprawdzić, czy zainstalowano wiele wersji usługi Azure PowerShell, użyj następującego polecenia:
Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version
aby usunąć wersję usługi Azure PowerShell, zobacz Odinstaluj moduł Azure PowerShell.
Jeśli masz zainstalowaną więcej niż jedną wersję modułu, Moduł autoload i Import-Module
domyślnie ładuje najnowszą wersję.,
możesz zainstalować lub załadować określoną wersję modułuAz
używając parametru-RequiredVersion
:
Użyj wielu repozytoriów za pomocą PowerShellGet
parametr repozytorium jest wymagany, jeśli dodałeś dodatkowe repozytoria do systemu PowerShellGeton, a moduł Az można znaleźć w więcej niż jednym z nich.
Prześlij opinię
Jeśli znajdziesz błąd w usłudze Azure PowerShell,Zgłoś problem w usłudze GitHub. Aby dostarczyć feedbackz linii poleceń, użyj polecenia Send-Feedback.,
aby dowiedzieć się więcej o modułach Azure PowerShell i ich funkcjach, firma seeGet zaczęła od usługi Azure PowerShell. Jeśli jesteś zaznajomiony z usługą AzurePowerShell i musisz przeprowadzić migrację z usługi AzureRM, wybierz opcję seeMigrate z usługi AzureRM do usługi Az.