Instalace Azure PowerShell ve Windows pomocí PowerShellGet

  • Článek

Upozorňující

Modul AzureRM PowerShell byl od 29. února 2024 oficiálně zastaralý. Uživatelům se doporučuje migrovat z AzureRM do modulu Az PowerShell, aby se zajistila nepřetržitá podpora a aktualizace.

I když může modul AzureRM stále fungovat, už se neudržuje ani nepodporuje, přičemž jakékoli další použití se bude umisťovat podle vlastního uvážení a rizika uživatele. Pokyny k přechodu na modul Az najdete v našich zdrojích informací o migraci.

Tento článek vysvětluje kroky instalace modulů Azure PowerShellu pro PowerShell 5.x pro Windows s využitím modulu PowerShellGet. PowerShellGet a správa modulů je upřednostňovaný způsob instalace Azure PowerShellu, ale pokud byste k instalaci chtěli raději použít balíček MSI nebo Instalaci webové platformy, projděte si téma věnované jiným metodám instalace.

Tato verze Azure PowerShellu nepodporuje model nasazení Azure Classic. Pokud chcete používat podporu nasazení Classic, postupujte podle pokynů v tématu Instalace modulu správy služeb prostředí Azure PowerShell.

Důležité

Modul AzureRM se nepodporuje pro macOS nebo Linux. Pokud chcete rutiny Azure PowerShellu používat na těchto platformách, nainstalujte modul Az.

Požadavky

Počínaje Azure PowerShellem verze 6.0 vyžaduje PowerShell verze 5.0. Chcete-li zkontrolovat verzi PowerShell běžící na vašem počítači, spusťte následující příkaz:

$PSVersionTable.PSVersion

Pokud máte zastaralou verzi, viz Upgrade stávajícího prostředí Windows PowerShell.

Důležité

Modul popsaný v tomto dokumentu, AzureRM, používá .NET Framework. To ho činí nekompatibilním s PowerShellem 6.0, který používá .NET Core. Pokud používáte PowerShell 6.0, postupujte podle pokynů pro instalaci pro macOS a Linux.

Instalace modulu Azure PowerShellu

K instalaci modulu z Galerie prostředí PowerShell potřebujete zvýšená oprávnění. Pokud chcete nainstalovat Azure PowerShell, spusťte v relaci se zvýšenými oprávněními následující příkaz:

Install-Module -Name AzureRM -AllowClobber

Poznámka:

Pokud máte verzi NuGetu, která je starší než 2.8.5.201, zobrazí se výzva ke stažení a instalaci nejnovější verze NuGetu.

Ve výchozím nastavení není Galerie prostředí PowerShell nakonfigurovaná jako důvěryhodné úložiště pro PowerShellGet. Při prvním použití PSGallery se zobrazí tato výzva:

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"):

Pokračujte v instalaci výběrem Yes nebo Yes to All.

Modul AzureRM je kumulativní modul pro rutiny Azure PowerShellu. Jeho instalace stáhne všechny dostupné moduly Azure Resource Manageru a zpřístupní jejich rutiny k použití.

Přihlásit se

Když chcete začít pracovat s Azure PowerShellem, přihlaste se pomocí přihlašovacích údajů Azure.

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

Poznámka:

Pokud jste zakázali automatické nahrávání modulů, musíte tento modul naimportovat ručně pomocí příkazu Import-Module AzureRM. Kvůli způsobu jeho strukturování může nahrávání tohoto modulu trvat několik sekund.

Tyto kroky bude potřeba zopakovat pro každou nově spuštěnou relaci PowerShellu. Postup pro zachování přihlašovacích údajů Azure mezi relacemi PowerShellu najdete v tématu Zachování přihlašovacích údajů uživatele mezi relacemi PowerShellu.

Aktualizace modulu Azure PowerShellu

Instalaci Azure PowerShellu můžete aktualizovat spuštěním rutiny Update-Module. Tento příkaz neodinstaluje dřívější verze.

Update-Module -Name AzureRM

Pokud chcete ze systému odebrat dřívější verze Azure PowerShellu, přečtěte si téma Odinstalace modulu Azure PowerShellu.

Použití několika verzí Azure PowerShellu

Je možné nainstalovat několik verzí Azure PowerShellu. Ke kontrole, jestli jsou nainstalované různé verze Azure PowerShellu, použijte následující příkaz:

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

Pokyny pro odebrání verze Azure PowerShellu najdete v tématu Odinstalace modulu Azure PowerShellu.

Dostupnost více verzí můžete potřebovat, když pracujete s místními prostředky Azure Stack, provozujete starší verzi Windows nebo používáte model nasazení Azure Classic. Když chcete nainstalovat starší verzi, uveďte při instalaci argument -RequiredVersion.

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

Při načítání modulu Azure PowerShellu se standardně načte nejnovější verze. Pokud chcete načíst jinou verzi, zadejte RequiredVersion parametr.

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

Poskytnutí názorů

Pokud během používání Azure PowerShellu zjistíte chybu, ohlaste ji na GitHubu. Pokud chcete poskytnout zpětnou vazbu z příkazového řádku, použijte rutinu Send-Feedback.

Další kroky

Pokud Azure PowerShell začínáte používat, přečtěte si téma Začínáme s využitím Azure PowerShellu, abyste se dozvěděli víc o modulech a jejich funkcích.