Installieren des Azure PowerShell-Moduls

10 Minuten

Beim Azure Az PowerShell-Modul handelt es sich um ein Rollupmodul. Bei der Installation werden die verfügbaren Azure PowerShell-Module heruntergeladen und die zugehörigen Cmdlets verfügbar gemacht. Das Azure Az-PowerShell-Modul funktioniert mit PowerShell 7.x und höheren Versionen auf allen Plattformen. Bei Verwendung von PowerShell 7.x und höheren Versionen gelten keine weiteren Anforderungen für Azure PowerShell.

Führen Sie zum Überprüfen Ihrer PowerShell-Version in einer PowerShell-Sitzung den folgenden Befehl aus:

$PSVersionTable.PSVersion

Vor der Installation des Azure Az PowerShell-Moduls sollten Sie Ihre PowerShell-Skriptausführungsrichtlinie auf RemoteSigned festlegen. Führen Sie dazu den folgenden Befehl aus:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Methoden zum Installieren des Azure Az PowerShell-Moduls

Sie können das Azure Az PowerShell-Modul anhand einer der folgenden Methoden installieren:

Cmdlet Install-Module
Azure PowerShell MSI
Az PowerShell-Docker-Container

Hinweis

Das Azure Az PowerShell-Modul ist in Azure Cloud Shell vorinstalliert. Sie können es ohne jegliche lokale Installation auf Ihrem Computer direkt im Browser verwenden. Mehr über Azure Cloud Shell erfahren Sie in der nächsten Lerneinheit.

Cmdlet „Install-Module“

Das Cmdlet Install-Module ist die bevorzugte Installationsmethode für das Azure Az PowerShell-Modul. Sie sollten dieses Modul nur für den aktuellen Benutzer installieren. Dies ist der empfohlene Installationsbereich. Die Funktionsweise dieser Methode ist auf Windows-, macOS- und Linux-Plattformen gleich. Führen Sie Zum Installieren des Az-Moduls den folgenden Befehl in einer lokalen PowerShell-Sitzung aus:

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

Obwohl PowerShell 7.x die empfohlene Version von PowerShell ist und Install-Module die empfohlene Installationsoption ist, können Sie das Az-Modul auch in der PowerShell 5.1-Umgebung unter Windows installieren. Unter Windows 10, Version 1607 oder höher, ist PowerShell 5.1 bereits installiert. Sie sollten außerdem sicherstellen, dass .NET Framework 4.7.2 oder höher und die neueste Version von PowerShellGet installiert sind. Führen Sie zum Installieren der neuesten Version des PowerShellGet-Moduls in PowerShell 5.1 den folgenden Befehl aus:

Install-Module -Name PowerShellGet -Force

Anschließend können Sie das Az-Modul mit demselben Befehls installieren, der in PowerShell 7.1 verwendet wird.

Azure PowerShell MSI

In einigen Umgebungen ist es nicht möglich, eine Verbindung mit dem PowerShell-Katalog herzustellen. In solchen Situationen können Sie das Az PowerShell-Modul offline installieren, indem Sie das MSI-Paket für Azure PowerShell herunterladen. Beachten Sie, dass das MSI-Installationsprogramm nur für PowerShell 5.1 unter Windows verwendet werden kann.

Zum Aktualisieren eines beliebigen PowerShell-Moduls müssen Sie dieselbe Methode verwenden, die zum Installieren des Moduls verwendet wurde. Wenn Sie beispielsweise ursprünglich Install-Module verwendet haben, müssen Sie Update-Module verwenden, um die neueste Version zu erhalten. Falls Sie ursprünglich das MSI-Paket verwendet haben, sollten Sie das neue MSI-Paket herunterladen und installieren.

Az PowerShell-Docker-Container

Es ist auch möglich, Azure PowerShell in einem Docker-Image auszuführen. Microsoft stellt Docker-Images bereit, in denen Azure PowerShell bereits installiert ist. Für die veröffentlichten Images ist mindestens Docker 17.05 erforderlich. Das neueste Containerimage enthält die aktuelle PowerShell-Version sowie die aktuellen Azure PowerShell-Module, die für das Az-Modul unterstützt werden.

Sie sollten die folgenden Befehle ausführen, um das Image herunterzuladen und eine interaktive PowerShell-Sitzung zu starten:

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

Starten der Arbeit mit Azure PowerShell

Um mit der Arbeit in der Azure PowerShell-Umgebung zu beginnen, müssen Sie sich zuerst mit Ihren Azure-Anmeldeinformationen anmelden. Dieser Schritt unterscheidet sich von der Arbeit in der reinen PowerShell. Ihre Azure-Anmeldeinformationen sind die gleichen Anmeldeinformationen, die Sie zum Anmelden beim Azure-Portal oder anderen Azure-Ressourcen verwenden.

Zum Anmelden bei Azure über Azure PowerShell führen Sie den folgenden Befehl aus:

Connect-AzAccount