De Azure Az PowerShell-module installeren

In dit artikel wordt uitgelegd hoe u de Azure Az PowerShell-module installeert vanuit de PowerShell Gallery. Deze instructies werken op Windows-, Linux- en macOS-platforms.

De Azure Az PowerShell-module is vooraf geïnstalleerd in Azure Cloud Shell en in Docker-installatiekopieën.

De Azure Az PowerShell-module is een samengetelde module. Als u deze installeert, worden de algemeen beschikbare Az PowerShell-modules gedownload en worden hun cmdlets beschikbaar voor gebruik.

Vereisten

Notitie

PowerShell 7.0.6 LTS, PowerShell 7.1.3 of hoger is de aanbevolen versie van PowerShell voor gebruik met de Azure Az PowerShell-module op alle platforms.

Azure PowerShell geen aanvullende vereisten heeft wanneer deze worden uitgevoerd op PowerShell 7.0.6 LTS en PowerShell 7.1.3 of hoger.

Voer de volgende opdracht uit vanuit een PowerShell-sessie om uw PowerShell-versie te controleren:

$PSVersionTable.PSVersion

PowerShell-scriptuitvoeringsbeleid moet zijn ingesteld op extern ondertekend of minder beperkend. Get-ExecutionPolicy -List kan worden gebruikt om het huidige uitvoeringsbeleid te bepalen. Zie about_Execution_Policies voor meer informatie.

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Installatie

Het gebruik van de cmdlet Install-Module is de voorkeursmethode voor de Az PowerShell-module. Installeer de Az-module alleen voor de huidige gebruiker. Dit is het aanbevolen installatiebereik. Deze methode werkt hetzelfde op Windows-, Linux- en macOS-platforms. Voer de volgende opdracht uit vanuit een PowerShell-sessie:

Install-Module -Name Az -Scope CurrentUser -Repository PSGallery -Force

Andere installatieopties

Hoewel PowerShell 7.0.6 LTS, PowerShell 7.1.3 of hoger de aanbevolen versie van PowerShell is en Install-Module de aanbevolen installatieoptie is, zijn er indien nodig extra installatieopties.

Installatie op Windows PowerShell

Belangrijk

Als u de AzureRM PowerShell-module hebt geïnstalleerd, raadpleegt u Az en AzureRM co-existentie voordat u doorgaat.

De Azure Az PowerShell-module wordt ook ondersteund voor gebruik met PowerShell 5.1 in Windows. De Azure Az PowerShell-module gebruiken in PowerShell 5.1 in Windows:

  1. Voer een update uit naar Windows PowerShell 5.1. Als u Windows 10 versie 1607 of hoger hebt, is PowerShell 5.1 al geïnstalleerd.
  2. Installeer .NET framework 4.7.2 of hoger.
  3. Zorg ervoor dat u beschikt over de nieuwste versie van PowerShellGet. Voer Install-Module -Name PowerShellGet -Force uit.

Offline-installatie

In sommige omgevingen is het niet mogelijk om verbinding te maken met de PowerShell Gallery. In dergelijke situaties kunt u de Az PowerShell-module offline installeren met behulp van een van deze methoden:

  • Download de Azure PowerShell MSI. Onthoud dat het MSI-installatieprogramma alleen werkt voor PowerShell 5.1 in Windows.
  • Download de modules in een andere locatie in uw netwerk en gebruik die als installatiebron. Met deze methode kunt u PowerShell-modules op één server of bestandsshare cachen om ze met PowerShellGet te implementeren op niet-verbonden systemen. Meer informatie over hoe u een lokale opslagplaats instelt en installeert in niet-verbonden systemen met Werken met lokale PowerShellGet-opslagplaatsen.
  • Sla de module met Save-Module op in een bestandsshare of sla deze op in een andere bron en kopieer deze handmatig naar andere computers.

Aanmelden

Meldt u aan met uw Azure-referenties, om aan de slag te gaan met Azure PowerShell.

Connect-AzAccount

Nadat u deze opdracht hebt uitgevoerd, wordt er een nieuw browservenster weergegeven en kunt u zich aanmelden bij uw Azure-account.

De Azure PowerShell-module bijwerken

Als u een PowerShell-module bijwerkt, gebruikt u dezelfde methode die is gebruikt om de module te installeren. Als u bijvoorbeeld oorspronkelijk Install-Module hebt gebruikt, moet u Update-Module gebruiken voor de nieuwste versie. Als u het MSI-pakket oorspronkelijk hebt gebruikt, moet u het nieuwe MSI-pakket downloaden en installeren.

De PowerShellGet-cmdlets kunnen modules niet bijwerken die zijn geïnstalleerd van een MSI-pakket. MSI-pakketten werken modules niet bij die zijn geïnstalleerd met PowerShellGet. Als u problemen ondervindt met het bijwerken met Behulp van PowerShellGet, moet u het opnieuw installeren in plaats van bijwerken. Opnieuw installeren gebeurt op dezelfde manier als de installatie. Zorg ervoor dat u de Force parameter gebruikt bij Install-Module het opnieuw installeren.

In tegenstelling tot installaties op basis van MSI worden oudere versies die mogelijk in uw systeem bestaan niet verwijdert als u installeert of bijwerkt met PowerShellGet.

Notitie

Verwijderen kan ingewikkeld zijn als u meer dan één versie van de Az PowerShell-module hebt geïnstalleerd. Vanwege deze complexiteit ondersteunen we alleen het verwijderen van alle versies van de Az PowerShell-module die momenteel zijn geïnstalleerd.

Als u alle versies van de Az PowerShell-module uit uw systeem wilt verwijderen, raadpleegt u De Azure PowerShell-module verwijderen. Raadpleeg Azure PowerShell installeren met een MSI voor meer informatie over installaties op basis van MSI.

Problemen oplossen

Installatieproblemen oplossen met de Azure Az PowerShell-module.

Feedback geven

Als u een fout vindt in de Azure Az PowerShell-module, kunt u een probleem indienen op GitHub. Gebruik de cmdlet Send-Feedback om feedback te geven vanuit een PowerShell-sessie.

Volgende stappen

Zie Aan de slag met Azure PowerShell voor meer informatie over de Azure Az PowerShell-modules en de bijbehorende functies. Zie Migrate from AzureRM to Az (Migreren van AzureRM naar Az) als u bekend bent met Azure PowerShell en van AzureRM wilt migreren.