De Azure PowerShell-module installeren

Voltooid

De Azure Az PowerShell-module is een samengetelde module. Als u deze installeert, worden de beschikbare Az PowerShell-modules gedownload en kunnen de bijbehorende cmdlets worden gebruikt. De Azure Az PowerShell-module werkt met PowerShell 7.x en nieuwere versies op alle platforms. Azure PowerShell heeft geen aanvullende vereisten wanneer u deze uitvoert op PowerShell 7.x en nieuwere versies.

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

$PSVersionTable.PSVersion

Voordat u de Azure Az PowerShell-module installeert, moet u het uitvoeringsbeleid voor PowerShell-scripts instellen op RemoteSigned. U kunt dit doen door de volgende opdracht uit te voeren:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Methoden voor het installeren van de Az PowerShell-module

U kunt de Azure Az PowerShell-module installeren met behulp van een van de volgende methoden:

  • De cmdlet Install-Module
  • Azure PowerShell MSI
  • Az PowerShell Docker-container

Notitie

De Azure Az PowerShell-module is vooraf geïnstalleerd in Azure Cloud Shell. U kunt deze rechtstreeks vanuit de browser gebruiken zonder iets lokaal op uw computer te installeren. In de volgende les leert u meer over Azure Cloud Shell.

De cmdlet Install-Module

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

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

Hoewel PowerShell 7.x de aanbevolen versie van PowerShell is en Install-Module de aanbevolen installatieoptie is, kunt u ook de Az-module installeren in powerShell 5.1-omgeving in Windows. Als u Windows 10 versie 1607 of hoger hebt, is PowerShell 5.1 al geïnstalleerd. Zorg er ook voor dat .NET Framework 4.7.2 of hoger is geïnstalleerd en de nieuwste versie van PowerShellGet. Voer de volgende opdracht uit om de nieuwste versie van de PowerShellGet-module in PowerShell 5.1 te installeren:

Install-Module -Name PowerShellGet -Force

Vervolgens kunt u de Az-module installeren met dezelfde opdracht die u in PowerShell 7.1 gebruikt.

Azure PowerShell MSI

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 door het MSI-pakket van Azure PowerShell te downloaden. Onthoud dat het MSI-installatieprogramma alleen werkt voor PowerShell 5.1 in Windows.

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

Az PowerShell Docker-container

Het is ook mogelijk om Azure PowerShell uit te voeren in een Docker-installatiekopieën. Microsoft biedt Docker-installatiekopieën waarop Azure PowerShell vooraf is geïnstalleerd. De uitgebrachte installatiekopieën hebben Docker 17.05 of hoger nodig. De nieuwste containerinstallatiekopie bevat de nieuwste versie van PowerShell en de nieuwste Azure PowerShell-modules die worden ondersteund door de Az-module.

Als u de installatiekopieën wilt downloaden en een interactieve PowerShell-sessie wilt starten, moet u de volgende opdrachten uitvoeren:

docker pull mcr.microsoft.com/azure-powershell
docker run -it mcr.microsoft.com/azure-powershell pwsh

Beginnen met werken met Azure PowerShell

Als u wilt gaan werken in de Azure PowerShell-omgeving, moet u zich eerst aanmelden met uw Azure-referenties. Deze stap verschilt van het werken in pure PowerShell. Uw Azure-referenties zijn dezelfde referenties die u gebruikt om u aan te melden bij Azure Portal of andere Azure-resources.

Voer de volgende opdracht uit om u aan te melden bij Azure vanuit Azure PowerShell:

Connect-AzAccount

Nadat u deze opdracht hebt uitgevoerd, wordt u gevraagd u aan te melden met uw Azure-referenties. Nadat u zich bij Azure hebt geverifieerd, kunt u opdrachten uit de Az-module gebruiken om uw Azure-resources te beheren.