Installieren von Azure Powershell

In diesem Artikel wird erläutert, wie Sie die Azure PowerShell-Module mit PowerShellGet installieren. Diese Anweisungen funktionieren auf Windows-, Linux- und macOS-Plattformen.

Azure PowerShell ist auch in Azure Cloud Shell verfügbar.

Anforderungen

Azure PowerShell funktioniert mit PowerShell 5.1 oder höher unter Windows oder PowerShell Core 6.x und höher auf allen Plattformen. Sie sollten die neueste Version von PowerShell installieren, die für Ihr Betriebssystem verfügbar ist. Azure PowerShell hat keine zusätzlichen Anforderungen, wenn sie auf PowerShell 6.2.4 und höher ausgeführt werden.

Um Ihre PowerShell-Version zu überprüfen, führen Sie den Befehl aus:

$PSVersionTable.PSVersion

So verwenden Sie Azure PowerShell in PowerShell 5.1 unter Windows:

  1. Aktualisieren Sie auf Windows PowerShell 5.1. Wenn Sie Windows 10 Version 1607 oder höher verwenden, ist PowerShell 5.1 bereits installiert.
  2. Installieren Sie .NET Framework 4.7.2 oder höher.
  3. Stellen Sie sicher, dass Sie über die neueste Version von PowerShellGet verfügen. Führen Sie Install-Module -Name PowerShellGet -Force aus.

Installieren des Azure PowerShell-Moduls

Warnung

Es wird nicht unterstützt, dass sowohl die AzureRM- als auch die Az-Module für PowerShell 5.1 unter Windows gleichzeitig installiert sind. Wenn Sie AzureRM auf Ihrem System verfügbar halten müssen, installieren Sie das Az-Modul für PowerShell 6.2.4 oder höher.

Die Verwendung der PowerShellGet-Cmdlets ist die bevorzugte Installationsmethode. Installieren Sie das Az-Modul nur für den aktuellen Benutzer. Dies ist der empfohlene Installationsbereich. Diese Methode funktioniert auf Windows-, Linux- und macOS-Plattformen identisch. Führen Sie den folgenden Befehl aus einer PowerShell-Sitzung aus:

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope CurrentUser
}

Standardmäßig ist der PowerShell-Katalog nicht als vertrauenswürdiges Repository für PowerShellGet konfiguriert. Wenn Sie die PSGallery zum ersten Mal verwenden, wird die folgende Eingabeaufforderung angezeigt:

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

Antworten Sie Yes oder Yes to All, um mit der Installation fortzufahren.

Für die Installation des Moduls für alle Benutzer auf einem System sind erhöhte Rechte erforderlich. Starten Sie die PowerShell-Sitzung mit "Als Administrator ausführen" in Windows, oder verwenden Sie den sudo Befehl unter macOS oder Linux:

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Scope AllUsers
}

Das Az-Modul ist ein Rollupmodul für die Azure PowerShell-Cmdlets. Durch die Installation werden alle allgemein verfügbaren Az PowerShell-Module heruntergeladen und ihre Cmdlets zur Verwendung zur Verfügung gestellt.

Offline installieren

In einigen Umgebungen ist es nicht möglich, eine Verbindung mit der PowerShell Gallery aufzubauen. In diesen Situationen können Sie offline mit einer der folgenden Methoden installieren:

  • Laden Sie die Module an einen anderen Speicherort in Ihrem Netzwerk herunter, und verwenden Sie dies als Installationsquelle. Dieses Verfahren ermöglicht die Zwischenspeicherung von PowerShell-Modulen, die mithilfe von PowerShellGet auf Systemen ohne Verbindung bereitgestellt werden sollen, auf einem einzelnen Server oder in einer einzelnen Dateifreigabe. Erfahren Sie, wie Sie ein lokales Repository einrichten und auf getrennten Systemen installieren, indem Sie mit lokalen PowerShellGet-Repositorys arbeiten.

  • Laden Sie die Azure PowerShell-MSI auf einen Computer herunter, der mit dem Netzwerk verbunden ist, und kopieren Sie dann das Installationsprogramm auf Systeme, die keinen Zugriff auf die PowerShell Gallery haben. Beachten Sie, dass das MSI-Installationsprogramm nur für PowerShell 5.1 unter Windows verwendet werden kann.

  • Speichern Sie das Modul mit Save-Module auf einer Dateifreigabe oder einer anderen Quelle, und kopieren Sie es manuell auf andere Computer:

    Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
    

Problembehandlung

Im Folgenden finden Sie einige häufige Probleme beim Installieren des Azure PowerShell-Moduls. Wenn ein Problem auftritt, das hier nicht aufgeführt ist, geben Sie ein Problem auf GitHub an.

Der Proxy blockiert die Verbindung.

Wenn Sie von Install-Module Fehler erhalten, die darauf hindeuten, dass die PowerShell Gallery nicht erreichbar ist, befinden Sie sich möglicherweise hinter einem Proxy. Verschiedene Betriebssysteme und Netzwerkumgebung haben unterschiedliche Anforderungen für die Konfiguration eines systemweiten Proxys. Wenden Sie sich an Ihren Systemadministrator, um Ihre Proxyeinstellungen zu konfigurieren und wie Sie sie für Ihre Umgebung konfigurieren.

PowerShell selbst ist möglicherweise nicht für die automatische Verwendung dieses Proxys konfiguriert. Konfigurieren Sie mit PowerShell 5.1 und höher die PowerShell-Sitzung für die Verwendung eines Proxys mithilfe der folgenden Befehle:

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

Wenn Ihre Betriebssystemanmeldeinformationen ordnungsgemäß konfiguriert sind, leitet diese Konfiguration PowerShell-Anforderungen über den Proxy weiter. Wenn diese Einstellung zwischen Sitzungen beibehalten werden soll, fügen Sie die Befehle zu Ihrem PowerShell-Profilhinzu.

Um das Paket zu installieren, muss Ihr Proxy HTTPS-Verbindungen mit der folgenden Adresse zulassen:

  • https://www.powershellgallery.com

Anmelden

Melden Sie sich mit Ihren Azure-Anmeldeinformationen an, um Azure PowerShell zu verwenden.

# Connect to Azure with a browser sign in token
Connect-AzAccount

Hinweis

Wenn Sie das automatische Laden des Moduls deaktiviert haben, importieren Sie das Modul manuell mit Import-Module -Name Az. Aufgrund der Struktur des Moduls kann dies einige Sekunden dauern.

Sie müssen diese Schritte für jede neue PowerShell-Sitzung wiederholen, die Sie starten. Informationen zum Beibehalten Ihrer Azure-Anmeldung in PowerShell-Sitzungen finden Sie unter "Beibehalten von Benutzeranmeldeinformationen in PowerShell-Sitzungen".

Aktualisieren des Azure PowerShell-Moduls

Zum Aktualisieren eines PowerShell-Moduls sollten Sie dieselbe Methode verwenden, die zum Installieren des Moduls verwendet wird. Wenn Sie beispielsweise ursprünglich verwendet Install-Modulehaben, sollten Sie update-Module verwenden, um die neueste Version abzurufen. Wenn Sie das MSI-Paket ursprünglich verwendet haben, sollten Sie das neue MSI-Paket herunterladen und installieren.

Die PowerShellGet-Cmdlets können keine Module aktualisieren, die aus einem MSI-Paket installiert wurden. MSI-Pakete aktualisieren keine Module, die mit PowerShellGet installiert wurden. Wenn Sie Probleme beim Aktualisieren mithilfe von PowershellGet haben, sollten Sie es neu installieren und nicht aktualisieren. Das erneute Installieren erfolgt auf die gleiche Weise wie die Installation, aber Sie müssen den -Force Parameter hinzufügen:

if (Get-Module -Name AzureRM -ListAvailable) {
    Write-Warning -Message ('Az module not installed. Having both the AzureRM and ' +
      'Az modules installed at the same time is not supported.')
} else {
    Install-Module -Name Az -AllowClobber -Force
}

Im Gegensatz zu MSI-basierten Installationen entfernt das Installieren oder Aktualisieren mit PowerShellGet keine älteren Versionen, die möglicherweise auf Ihrem System vorhanden sind. Informationen zum Entfernen alter Versionen von Azure PowerShell aus Ihrem System finden Sie unter Deinstallieren des Azure PowerShell-Moduls. Weitere Informationen zu MSI-basierten Installationen finden Sie unter Installieren von Azure PowerShell mit einem MSI.For more information about MSI-based installations, see Install Azure PowerShell with an MSI.

Verwenden mehrerer Versionen von Azure PowerShell

Es ist möglich, mehr als eine Version von Azure PowerShell zu installieren. Verwenden Sie den folgenden Befehl, um zu überprüfen, ob mehrere Versionen von Azure PowerShell installiert sind:

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

Informationen zum Entfernen einer Version von Azure PowerShell finden Sie unter Deinstallieren des Azure PowerShell-Moduls.

Sind mehrere Versionen des Moduls installiert, wird mit der Funktion zum automatischen Laden von Modulen und mit Import-Module standardmäßig die neueste Version geladen.

Sie können eine bestimmte Version des Moduls mithilfe des Parameters Az-RequiredVersion installieren oder laden.

# Install Az version 3.6.1
Install-Module -Name Az -RequiredVersion 3.6.1
# Load Az version 3.6.1
Import-Module -Name Az -RequiredVersion 3.6.1

Feedback geben

Wenn Sie einen Fehler in Azure PowerShell finden, erstellen Sie ein Issue auf GitHub. Um Feedback von der Befehlszeile aus zu geben, verwenden Sie das Cmdlet Send-Feedback.

Nächste Schritte

Weitere Informationen zu Azure PowerShell-Modulen und den zugehörigen Features finden Sie unter Erste Schritte mit Azure PowerShell. Wenn Sie mit Azure PowerShell vertraut sind und von AzureRM migrieren müssen, siehe Migrate from AzureRM to Az.