Installera Azure PowerShell

Den här artikeln beskriver hur du installerar Azure PowerShell-modulerna med Hjälp av PowerShellGet. De här instruktionerna fungerar på Windows-, Linux- och macOS-plattformar.

Azure PowerShell är också tillgängligt i Azure Cloud Shell.

Krav

Azure PowerShell fungerar med PowerShell 5.1 eller senare i Windows eller PowerShell Core 6.x och senare på alla plattformar. Du bör installera den senaste versionen av PowerShell som är tillgänglig för ditt operativsystem. Azure PowerShell har inga ytterligare krav vid körning på PowerShell 6.2.4 och senare.

Kör kommandot för att kontrollera din PowerShell-version:

$PSVersionTable.PSVersion

Så här använder du Azure PowerShell i PowerShell 5.1 i Windows:

  1. Uppdatera till Windows PowerShell 5.1. Om du använder Windows 10 version 1607 eller senare är PowerShell 5.1 redan installerat.
  2. Installera .NET Framework 4.7.2 eller senare.
  3. Kontrollera att du har den senaste versionen av PowerShellGet. Kör Install-Module -Name PowerShellGet -Force.

Installera Azure PowerShell-modulen

Varning

Vi stöder inte att både AzureRM- och Az-modulerna är installerade för PowerShell 5.1 på Windows samtidigt. Om du behöver ha AzureRM tillgängligt i systemet installerar du Az-modulen för PowerShell 6.2.4 eller senare.

Att använda PowerShellGet-cmdletar är den föredragna installationsmetoden. Installera Az-modulen endast för den aktuella användaren. Detta är det rekommenderade installationsomfånget. Den här metoden fungerar på samma sätt på Windows-, Linux- och macOS-plattformar. Kör följande kommando från en PowerShell-session:

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
}

Som standard konfigureras inte PowerShell-galleriet som en betrodd lagringsplats för PowerShellGet. Första gången du använder PSGallery visas följande fråga:

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

Svara Yes eller Yes to All för att fortsätta med installationen.

För att installera modulen för alla användare i ett system krävs utökade privilegier. Starta PowerShell-sessionen med Kör som administratör i Windows eller använd sudo kommandot på macOS eller 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
}

Az-modulen är en samlingsmodul för Azure PowerShell cmdlets. När du installerar den laddas alla allmänt tillgängliga Az PowerShell-moduler ned och deras cmdletar blir tillgängliga för användning.

Installera offline

I vissa miljöer går det inte att ansluta till PowerShell-galleriet. I sådana situationer kan du fortfarande installera offline med någon av följande metoder:

  • Ladda ned modulerna till en annan plats i nätverket och använd dem som installationskälla. Med den här metoden kan du cachelagra PowerShell-moduler på en enskild server eller filresurs som ska distribueras med PowerShellGet till alla frånkopplade system. Lär dig hur du konfigurerar en lokal lagringsplats och installerar på frånkopplade system med Arbeta med lokala PowerShellGet-lagringsplatser.

  • Ladda ned Azure PowerShell MSI till en dator som är ansluten till nätverket och kopiera installationsprogrammet till system utan åtkomst till PowerShell-galleriet. Tänk på att MSI-installationsprogrammet endast fungerar för PowerShell 5.1 på Windows.

  • Spara modulen med Save-Module till en filresurs eller spara den i en annan källa och kopiera den manuellt till andra datorer:

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

Felsökning

Här följer några vanliga problem när du installerar Azure PowerShell-modulen. Om du får ett problem som inte visas här kan du skapa ett problem på GitHub.

Proxy blockerar anslutning

Om du får fel från Install-Module som indikerar att PowerShell-galleriet inte kan nås kan du vara bakom en proxy. Olika operativsystem och nätverksmiljöer har olika krav för att konfigurera en systemomfattande proxy. Kontakta systemadministratören för dina proxyinställningar och hur du konfigurerar dem för din miljö.

PowerShell själv kanske inte konfigureras för att använda den här proxyn automatiskt. Med PowerShell 5.1 och senare konfigurerar du PowerShell-sessionen så att den använder en proxy med hjälp av följande kommandon:

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

Om dina autentiseringsuppgifter för operativsystemet är korrekt konfigurerade dirigerar den här konfigurationen PowerShell-begäranden via proxyn. Om du vill att den här inställningen ska sparas mellan sessioner lägger du till kommandona i din PowerShell-profil.

För att installera paketet måste proxyn tillåta HTTPS-anslutningar till följande adress:

  • https://www.powershellgallery.com

Logga in

Logga in med dina Azure-autentiseringsuppgifter för att börja arbeta med Azure PowerShell.

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

Anmärkning

Om du har inaktiverat automatisk inläsning av modulen importerar du modulen manuellt med Import-Module -Name Az. På grund av hur modulen är strukturerad kan det ta några sekunder.

Du måste upprepa de här stegen för varje ny PowerShell-session som du startar. Information om hur du bevarar din Azure-inloggning mellan PowerShell-sessioner finns i Behåll autentiseringsuppgifter för användare mellan PowerShell-sessioner.

Uppdatera Azure PowerShell-modulen

Om du vill uppdatera en PowerShell-modul ska du använda samma metod som för att installera modulen. Om du till exempel ursprungligen använde Install-Modulebör du använda Update-Module för att hämta den senaste versionen. Om du ursprungligen använde MSI-paketet bör du ladda ned och installera det nya MSI-paketet.

PowerShellGet-cmdletarna kan inte uppdatera moduler som har installerats från ett MSI-paket. MSI-paket uppdaterar inte moduler som har installerats med PowerShellGet. Om du har problem med att uppdatera med PowershellGet bör du installera om i stället för att uppdatera. Ominstallation sker på samma sätt som installation, men du måste lägga till parametern -Force :

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
}

Till skillnad från MSI-baserade installationer tar installationer eller uppdateringar med PowerShellGet inte bort äldre versioner som kan finnas i systemet. Information om hur du tar bort gamla versioner av Azure PowerShell från systemet finns i Avinstallera Azure PowerShell-modulen. Mer information om MSI-baserade installationer finns i Installera Azure PowerShell med en MSI.

Använda flera versioner av Azure PowerShell

Det går att installera mer än en version av Azure PowerShell. Om du vill kontrollera om du har flera versioner av Azure PowerShell installerade använder du följande kommando:

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

Information om hur du tar bort en version av Azure PowerShell finns i Avinstallera Azure PowerShell-modulen.

Om du har fler än en version av modulen installerad läser du in modulen automatiskt och Import-Module läser in den senaste versionen som standard.

Du kan installera eller läsa in en specifik version av modulen Az med hjälp av parametern -RequiredVersion :

# 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

Lämna feedback

Om du hittar en bugg i Azure PowerShell kan du skapa ett problem på GitHub. Om du vill ge feedback från kommandoraden använder du cmdleten Send-Feedback .

Nästa steg

Mer information om Azure PowerShell-modulerna och deras funktioner finns i Komma igång med Azure PowerShell. Om du är bekant med Azure PowerShell och behöver migrera från AzureRM kan du läsa Migrera från AzureRM till Az.