De Azure PowerShell Service Management-module installeren

Notitie

De cmdlets waarnaar in deze documentatie wordt verwezen, zijn bedoeld voor het beheren van verouderde Azure-resources die gebruikmaken van ASM-API's (Azure Service Manager). Deze verouderde PowerShell-module wordt niet aanbevolen bij het maken van nieuwe resources, omdat ASM is gepland voor buitengebruikstelling. Zie Buitengebruikstelling van Azure Service Manager voor meer informatie.

De Az PowerShell-module is de aanbevolen PowerShell-module voor het beheren van ARM-resources (Azure Resource Manager) met PowerShell.

De Azure PowerShell Service Management-module is een samengetelde module. Als u de Azure PowerShell Service Management-module installeert, worden de algemeen beschikbare modules gedownload voor het beheren van verouderde Azure-resources die gebruikmaken van Service Management-API's en worden hun cmdlets beschikbaar gemaakt voor gebruik.

Vereisten

Belangrijk

De Azure PowerShell Service Management-module werkt alleen met Windows PowerShell. Het is niet compatibel met PowerShell versie 6 of hoger en wordt niet uitgevoerd op Linux of macOS.

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

  $PSVersionTable.PSVersion
  

• Bijwerken naar Windows PowerShell 5.1

• 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.

• PowerShellGet voor Windows PowerShell 5.1 bijwerken

Installatie

Gebruik de cmdlet Install-Module om de Azure PowerShell Service Management-module te installeren:

Install-Module -Name Azure, Azure.Storage -Repository PSGallery -AllowClobber -Force

De Azure PowerShell Service Management-module deelt afhankelijkheden met de Azure PowerShell Resource Manager-modules. Als u de Azure PowerShell Resource Manager-modules hebt geïnstalleerd, is de parameter AllowClobber vereist, zoals wordt weergegeven in de vorige opdracht. Hierdoor kunnen de bestaande gedeelde afhankelijkheden worden bijgewerkt. Zonder deze parameter kan de module niet worden geïnstalleerd.

Nadat u de Azure PowerShell Service Management-module hebt geïnstalleerd, importeert u de module:

Import-Module -Name Azure

Aanmelden

Als u uw verouderde Azure-resources wilt beheren met de Azure PowerShell Service Management-module, start u een PowerShell-sessie en voert u Add-AzureAccount uit om u aan te melden bij Azure:

Add-AzureAccount

Nadat u zich hebt aangemeld bij Azure, maakt de Azure PowerShell Service Management-module een context voor de opgegeven sessie. Deze context bevat de Azure-omgeving, het account, de tenant en het abonnement dat wordt gebruikt voor alle cmdlets in die sessie.

Probleemoplossing

Als u de fout 'De opgegeven module 'Azure.Storage' met versie '4.3.0' niet is geladen omdat er geen geldig modulebestand is gevonden in een modulemap.' moet u de Azure.Storage PowerShell-module installeren:

Install-Module -Name Azure.Storage -Repository PSGallery -AllowClobber -Force

Als u de fout 'De opdracht Install-Module' ziet in de module PowerShellGet, maar de module niet kan worden geladen,' moet u het PowerShell-uitvoeringsbeleid instellen op extern ondertekend of minder beperkend:

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Zie ook

Zie de referentiedocumentatie voor cmdlets voor meer informatie over opdrachten in de Azure PowerShell Service Management-module.