Delen via


Azure PowerShell installeren in Windows

De Az PowerShell-module is een rollup-module. Als u de Az PowerShell-module installeert, worden de algemeen beschikbare modules gedownload en kunnen de bijbehorende cmdlets worden gebruikt.

De aanbevolen installatiemethode en PowerShell-versie voor de Az PowerShell-module:

  • Installeren vanuit de PowerShell Gallery
  • Gebruiken met PowerShell versie 7 of hoger

In dit artikel wordt uitgelegd hoe u de Az PowerShell-module in Windows installeert vanuit de PowerShell Gallery.

Vereiste voorwaarden

  • Voer de volgende opdracht uit vanuit PowerShell om uw PowerShell-versie te bepalen:

    $PSVersionTable.PSVersion
    
  • Controleer of de AzureRM PowerShell-module is geïnstalleerd.

    Get-Module -Name AzureRM -ListAvailable
    

    Belangrijk

    Als u de AzureRM PowerShell-module hebt geïnstalleerd, raadpleeg Az en AzureRM naast elkaar gebruiken voordat u doorgaat.

  • Het PowerShell-uitvoeringsbeleid instellen op extern ondertekend of minder beperkend

    • Controleer het PowerShell-uitvoeringsbeleid:

      Get-ExecutionPolicy -List
      
    • Stel het PowerShell-uitvoeringsbeleid in op extern ondertekend:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    Zie about_Execution_Policies voor meer informatie over het uitvoeringsbeleid.

Installatie

Gebruik de cmdlet Install-Module om de Az PowerShell-module te installeren:

Install-Module -Name Az -Repository PSGallery -Force

De Az PowerShell-module bijwerken

Gebruik Update-Module om bij te werken naar de nieuwste versie van de Az PowerShell-module:

Update-Module -Name Az -Force

Als u de Az PowerShell-module bijwerkt met Update-Module worden oude versies van de Az PowerShell-module niet van uw systeem verwijderd.

Deïnstallatie

Om de Az PowerShell-module te verwijderen, zie verwijder de Azure PowerShell-module.

In dit artikel wordt uitgelegd hoe u de Az PowerShell-module in Windows installeert met behulp van een MSI-installatieprogramma. Het MSI-installatieprogramma is beschikbaar voor omgevingen waarin de PowerShell Gallery mogelijk wordt geblokkeerd door een firewall of een offline-installatieprogramma nodig is.

Belangrijk

De MSI-installatieoptie kan alleen worden gebruikt om de Az PowerShell-module te installeren voor gebruik met Windows PowerShell 5.1.

Vereiste voorwaarden

  • Voer de volgende opdracht uit vanuit PowerShell om uw PowerShell-versie te bepalen:

    $PSVersionTable.PSVersion
    
  • Bepalen of de AzureRM PowerShell-module geïnstalleerd is.

    Get-Module -Name AzureRM -ListAvailable
    

    Belangrijk

    Als u de AzureRM PowerShell-module hebt geïnstalleerd, raadpleeg Az en AzureRM naast elkaar gebruiken voordat u doorgaat.

  • Bijwerken naar Windows PowerShell 5.1

  • .NET Framework 4.7.2 of hoger installeren

  • De uitvoering van het PowerShell-script instellen op extern ondertekend of minder beperkend

    • Controleer het PowerShell-uitvoeringsbeleid:

      Get-ExecutionPolicy -List
      
    • Stel het PowerShell-uitvoeringsbeleid in op extern ondertekend:

      Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
      

    Zie [about_Execution_Policies][execution-poliicies] (uitvoeringsbeleid) voor meer informatie over uitvoeringsbeleidsregels.

Installatie en update

Het MSI-pakket voor Azure PowerShell is beschikbaar via [GitHub][azps-github]:

  1. Ga naar github.com/Azure/azure-powershell/releases
  2. Zoek de meest recente Az PowerShell-module. Ze worden chronologisch vermeld zonder naam. Bijvoorbeeld 13.3.0
  3. Scroll naar beneden naar het einde van de patchnotities en selecteer de pijl naast "Assets" om de MSI-opties zichtbaar te maken.
  4. Selecteer de Az-Cmdlets MSI van uw keuze om het downloaden te starten

Het installatieprogramma verwijdert automatisch oudere versies van de Az PowerShell-module die zijn geïnstalleerd met behulp van een MSI. Het MSI-pakket installeert modules in "${env:ProgramFiles}\WindowsPowerShell\Modules"

Aanmelden

Als u uw Azure-resources wilt beheren met de Az PowerShell-module, start u een PowerShell-sessie en voert u Connect-AzAccount uit om u aan te melden bij Azure:

Connect-AzAccount

Gebruik de aanmeldingsreferenties van uw Azure-account om u aan te melden bij het browservenster dat wordt geopend.

U moet deze stap herhalen voor elke nieuwe PowerShell-sessie die u start. Zie Azure PowerShell-contextobjecten voor informatie over het behouden van uw Azure-aanmelding tussen PowerShell-sessies.

Probleemoplossingsproces

Voor oplossingen voor veelvoorkomende installatieproblemen met de Az PowerShell-module, zie Installatieproblemen met de Az PowerShell-module oplossen.

Feedback geven

Als u een probleem wilt indienen over de Az PowerShell-module, raadpleegt u: Een probleem indienen op GitHub

Als u feedback wilt geven vanuit een PowerShell-sessie, gebruikt u de cmdlet Send-Feedback .

Volgende stappen

Zie Aan de slag met Azure PowerShellvoor meer informatie over het beheren van uw Azure-resources met de Az PowerShell-module.