De Azure Az PowerShell-module installeren

In dit artikel wordt uitgelegd hoe u de Azure Az PowerShell-module installeert met behulp van PowerShellGet. Deze instructies zijn van toepassing op Windows-, macOS- en Linux-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.

• Installeer nieuwste versie van PowerShell die voor uw besturingssysteem beschikbaar is.

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-, macOS- en Linux-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 de sectie Az en AzureRM co-existentie van dit artikel 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

Hier volgen enkele veelvoorkomende problemen bij het installeren van de Azure Az PowerShell-module. Als u een probleem ondervindt dat hier niet wordt vermeld, meldt u dat op GitHub.

Az en AzureRM co-existentie

Waarschuwing

We ondersteunen niet dat zowel de AzureRM- als de Az-module tegelijkertijd zijn geïnstalleerd voor PowerShell 5.1 onder Windows.

In een scenario waarin u zowel AzureRM als de Az PowerShell-module op hetzelfde systeem wilt installeren, moet AzureRM alleen worden geïnstalleerd in het gebruikersbereik voor Windows PowerShell. Installeer de Az PowerShell-module voor PowerShell 7.0.6 LTS, PowerShell 7.1.3 of hoger op hetzelfde systeem.

Belangrijk

Omdat Az PowerShell-modules nu alle mogelijkheden van AzureRM PowerShell-modules en meer hebben, wordt AzureRM PowerShell-modules op 29 februari 2024 buiten gebruik gesteld.

Als u serviceonderbrekingen wilt voorkomen, werkt u uw scripts bij die gebruikmaken van AzureRM PowerShell-modules voor het gebruik van Az PowerShell-modules op 29 februari 2024. Volg de snelstartgids om uw scripts automatisch bij te werken.

Visual Studio

Oudere versies van Visual Studio kunnen Azure PowerShell installeren als onderdeel van de Azure-ontwikkelworkload, waarmee de AzureRM-module wordt geïnstalleerd. Azure PowerShell kan worden verwijderd met behulp van het Visual Studio-installatieprogramma of met behulp van 'Verwijderen' in apps-functies&. Als u PowerShell 7.x al hebt geïnstalleerd, moet u mogelijk de Azure Az PowerShell-module handmatig installeren .

Proxy blokkeert verbinding

Als u fouten krijgt van Install-Module die PowerShell Gallery niet bereikbaar is, bevindt u zich mogelijk achter een proxy. Verschillende besturingssystemen en netwerkomgevingen hebben verschillende vereisten om een systeembrede proxy te configureren. Neem contact op met uw systeembeheerder voor uw proxyinstellingen en voor instructies voor het configureren van deze instellingen voor uw omgeving.

PowerShell zelf is mogelijk niet geconfigureerd om deze proxy automatisch te gebruiken. Met PowerShell 5.1 en hoger configureert u de PowerShell-sessie zo dat een proxy wordt gebruikt met de volgende opdrachten:

$webClient = New-Object -TypeName System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials

Als de referenties voor uw besturingssysteem correct zijn geconfigureerd, worden met deze configuratie PowerShell-aanvragen via de proxy gerouteerd. Als u deze instelling tussen verschillende sessies wilt behouden, voegt u de opdracht toe aan een PowerShell-profiel.

Als u het pakket wilt installeren, moet uw proxy HTTPS-verbindingen met www.powershellgallery.com toestaan.

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.