Installieren des Azure PowerShell-ModulsInstall the Azure PowerShell module

In diesem Artikel erfahren Sie, wie Sie mithilfe von „PowerShellGet“ die Azure PowerShell-Module installieren.This article tells you how to install the Azure PowerShell modules using PowerShellGet. Diese Anweisungen können für Windows-, macOS- und Linux-Plattformen verwendet werden.These instructions work on Windows, macOS, and Linux platforms. Für das Az-Modul werden derzeit keine anderen Installationsmethoden unterstützt.For the Az module, currently no other installation methods are supported.

Requirements (Anforderungen)Requirements

Azure PowerShell kann mit PowerShell 5.1 oder höher unter Windows oder mit PowerShell 6 auf einer beliebigen Plattform verwendet werden.Azure PowerShell works with PowerShell 5.1 or higher on Windows, or PowerShell 6 on any platform. Führen Sie den Befehl aus, um Ihre PowerShell-Version zu überprüfen:To check your PowerShell version, run the command:

$PSVersionTable.PSVersion

Falls Sie eine veraltete Version verwenden oder PowerShell installieren müssen, lesen Sie den Artikel Installieren verschiedener Versionen von PowerShell.If you have an outdated version or need to install PowerShell, see Installing various versions of PowerShell. Auf dieser Seite finden Sie einen Link zu den Installationsinformationen für Ihre Plattform.Install information for your platform is linked from that page.

Wenn Sie PowerShell 5 unter Windows verwenden, muss auch .NET Framework 4.7.2 installiert sein.If you are using PowerShell 5 on Windows, you also need .NET Framework 4.7.2 installed. Eine Anleitung zur Aktualisierung oder Installation einer neuen Version von .NET Framework finden Sie im .NET Framework-Installationsleitfaden.For instructions on updating or installing a new version of .NET Framework, see the .NET Framework installation guide.

Installieren des Azure PowerShell-ModulsInstall the Azure PowerShell module

Wichtig

Die Module AzureRM und Az können gleichzeitig installiert sein.You can have both the AzureRM and Az modules installed at the same time. Wenn Sie beide Module installiert haben, aktivieren Sie keine Aliase.If you have both modules installed, don't enable aliases. Die Aktivierung von Aliasen verursacht Konflikte zwischen AzureRM-Cmdlets und Az-Befehlsaliasen und kann zu unerwartetem Verhalten führen.Enabling aliases will cause conflicts between AzureRM cmdlets and Az command aliases, and could cause unexpected behavior. Es wird empfohlen, AzureRM vor der Installation des Az-Moduls zu deinstallieren.It's recommended that before installing the Az module, you uninstall AzureRM. Sie können AzureRM jederzeit deinstallieren bzw. Aliase aktivieren.You can always uninstall AzureRM or enable aliases at any time. Weitere Informationen zu den AzureRM-Befehlsaliasen finden Sie unter Migrieren von AzureRM zum Az-Modul von Azure PowerShell.To learn about the AzureRM command aliases, see Migrate from AzureRM to Az. Eine Anleitung zur Deinstallation finden Sie unter Deinstallieren des AzureRM-Moduls.For uninstall instructions, see Uninstall the AzureRM module.

Für die globale Installation von Modulen benötigen Sie erhöhte Rechte, um Module aus dem PowerShell-Katalog installieren zu können.To install modules at a global scope, you need elevated privileges to install modules from the PowerShell Gallery. Führen Sie zum Installieren von Azure PowerShell den folgenden Befehl in einer Sitzung mit erhöhten Rechten aus („Als Administrator ausführen“ unter Windows oder mit Superuser-Berechtigungen unter macOS/Linux):To install Azure PowerShell, run the following command in an elevated session ("Run as Administrator" on Windows, or with superuser privileges on macOS or Linux):

Install-Module -Name Az -AllowClobber

Sollten Sie über keine Administratorrechte verfügen, können Sie die Installation für den aktuellen Benutzer durch Hinzufügen des Arguments -Scope ausführen.If you don't have access to administrator privileges, you can install for the current user by adding the -Scope argument.

Install-Module -Name Az -AllowClobber -Scope CurrentUser

Standardmäßig ist der PowerShell-Katalog nicht als vertrauenswürdiges Repository für PowerShellGet konfiguriert.By default, the PowerShell gallery isn't configured as a trusted repository for PowerShellGet. Bei der ersten Verwendung des PowerShell-Katalogs wird die folgende Meldung angezeigt:The first time you use the PSGallery you see the following prompt:

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 mit Yes oder Yes to All, um die Installation fortzusetzen.Answer Yes or Yes to All to continue with the installation.

Das Az-Modul ist ein Rollupmodul für die Azure PowerShell-Cmdlets.The Az module is a rollup module for the Azure PowerShell cmdlets. Wenn Sie es installieren, werden alle verfügbaren Azure Resource Manager-Module heruntergeladen und die zugehörigen Cmdlets für die Nutzung zur Verfügung gestellt.Installing it downloads all of the available Azure Resource Manager modules, and makes their cmdlets available for use.

AnmeldenSign in

Melden Sie sich mit Ihren Azure-Anmeldeinformationen an, um Azure PowerShell zu verwenden.To start working with Azure PowerShell, sign in with your Azure credentials.

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

Hinweis

Wenn Sie das automatische Laden von Modulen deaktiviert haben, müssen Sie das Modul manuell mit Import-Module Az importieren.If you've disabled module autoloading, you need to manually import the module with Import-Module Az. Aufgrund der Modulstruktur kann dieser Vorgang einige Sekunden dauern.Because of the way the module is structured, this can take a few seconds.

Sie müssen diese Schritte für jede neue PowerShell-Sitzung wiederholen, die Sie starten.You'll need to repeat these steps for every new PowerShell session you start. Informationen zum sitzungsübergreifenden Speichern der Azure-Anmeldung in PowerShell finden Sie unter Speichern von Benutzeranmeldeinformationen zwischen PowerShell-Sitzungen.To learn how to persist your Azure sign-in across PowerShell sessions, see Persist user credentials across PowerShell sessions.

Aktualisieren des Azure PowerShell-ModulsUpdate the Azure PowerShell module

Sie können Ihre Azure PowerShell-Installation aktualisieren, indem Sie Update-Module ausführen.You can update your Azure PowerShell installation by running Update-Module. Mit diesem Befehl werden keine früheren Versionen deinstalliert.This command does not uninstall older versions.

Update-Module -Name Az

Wenn Sie frühere Versionen von Azure PowerShell von Ihrem System entfernen möchten, helfen Ihnen die Informationen unter Deinstallieren des Azure PowerShell-Moduls weiter.To learn how to remove old versions of Azure PowerShell from your system, see Uninstall the Azure PowerShell module.

Verwenden von mehreren Versionen von Azure PowerShellUse multiple versions of Azure PowerShell

Es ist möglich, mehr als eine Version von Azure PowerShell zu installieren.It's possible to install more than one version of Azure PowerShell. Verwenden Sie den folgenden Befehl zum Überprüfen, ob Sie mehrere Versionen von Azure PowerShell installiert haben:To check if you have multiple versions of Azure PowerShell installed, use the following command:

Get-InstalledModule -Name Az -AllVersions | select Name,Version

Anweisungen zum Entfernen einer Version von Azure PowerShell finden Sie unter Deinstallieren des Azure PowerShell-Moduls.To remove a version of Azure PowerShell, see Uninstall the Azure PowerShell module.

Wenn Sie eine bestimmte Version des Az-Moduls installieren oder laden möchten, können Sie das Argument -RequiredVersion verwenden:You can install or load a specific version of the Az module by using the -RequiredVersion argument:

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

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.If you have more than one version of the module installed, module autoload and Import-Module load the latest version by default.

Feedback gebenProvide feedback

Melden Sie auf GitHub ein Problem, wenn Sie in Azure PowerShell einen Fehler finden.If you find a bug in Azure Powershell, file an issue on GitHub. Verwenden Sie das Send-Feedback-Cmdlet, um über die Befehlszeile Feedback zu senden.To provide feedback from the command line, use the Send-Feedback cmdlet.

Nächste SchritteNext Steps

Weitere Informationen zu Azure PowerShell-Modulen und den zugehörigen Features finden Sie unter Erste Schritte mit Azure PowerShell.To learn more about the Azure PowerShell modules and their features, see Get Started with Azure PowerShell. Falls Sie mit Azure PowerShell vertraut sind und die Migration aus AzureRM durchführen möchten, hilft Ihnen der Artikel Migrieren von AzureRM zum Az-Modul von Azure PowerShell weiter.If you're familiar with Azure PowerShell and need to migrate from AzureRM, see Migrate from AzureRM to Az.