Notitie
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen u aan te melden of de directory te wijzigen.
Voor toegang tot deze pagina is autorisatie vereist. U kunt proberen de mappen te wijzigen.
In dit artikel wordt uitgelegd hoe u de Azure PowerShell-modules installeert met behulp van PowerShellGet. Deze instructies werken op Windows-, Linux- en macOS-platforms.
Azure PowerShell is ook beschikbaar in Azure Cloud Shell.
Behoeften
Azure PowerShell werkt met PowerShell 5.1 of hoger in Windows of PowerShell Core 6.x en hoger op alle platforms. Installeer de nieuwste versie van PowerShell die beschikbaar is voor uw besturingssysteem. Azure PowerShell heeft geen aanvullende vereisten bij uitvoering op PowerShell 6.2.4 en hoger.
Voer de opdracht uit om uw PowerShell-versie te controleren:
$PSVersionTable.PSVersion
Azure PowerShell gebruiken in PowerShell 5.1 in Windows:
- Update naar Windows PowerShell 5.1. Als u Windows 10 versie 1607 of hoger hebt, is PowerShell 5.1 al geïnstalleerd.
- Installeer .NET Framework 4.7.2 of hoger.
- Zorg ervoor dat u de nieuwste versie van PowerShellGet hebt. Voer
Install-Module -Name PowerShellGet -Forceuit.
De Azure PowerShell-module installeren
Waarschuwing
We bieden geen ondersteuning voor zowel de AzureRM- als az-modules die tegelijkertijd zijn geïnstalleerd voor PowerShell 5.1 in Windows. Als u AzureRM beschikbaar wilt houden op uw systeem, installeert u de Az-module voor PowerShell 6.2.4 of hoger.
Het gebruik van de PowerShellGet-cmdlets is de voorkeursmethode voor de installatie. Installeer de Az-module alleen voor de huidige gebruiker. Dit is het aanbevolen installatiebereik. Deze methode werkt hetzelfde op Windows-, Linux- en macOS-platforms. Voer de volgende opdracht uit vanuit een PowerShell-sessie:
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
}
PowerShell Gallery is standaard niet geconfigureerd als een vertrouwde opslagplaats voor PowerShellGet. De eerste keer dat u psGallery gebruikt, ziet u de volgende 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"):
Beantwoord Yes of Yes to All ga door met de installatie.
Voor het installeren van de module voor alle gebruikers op een systeem zijn verhoogde bevoegdheden vereist. Start de PowerShell-sessie met Uitvoeren als administrator in Windows of gebruik de sudo opdracht in macOS of 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
}
De Az-module is een rollup-module voor de Azure PowerShell-cmdlets. Als u deze installeert, worden alle algemeen beschikbare Az PowerShell-modules gedownload en kunnen de bijbehorende cmdlets worden gebruikt.
Offline installeren
In sommige omgevingen is het niet mogelijk om verbinding te maken met de PowerShell Gallery. In dergelijke situaties kunt u nog steeds offline installeren met behulp van een van deze methoden:
Download de modules naar een andere locatie in uw netwerk en gebruik deze als installatiebron. Met deze methode kunt u PowerShell-modules in de cache opslaan op één server of bestandsshare die met PowerShellGet kunnen worden geïmplementeerd op niet-verbonden systemen. Meer informatie over het instellen van een lokale opslagplaats en het installeren op niet-verbonden systemen met werken met lokale PowerShellGet-opslagplaatsen.
Download de Azure PowerShell MSI naar een computer die is verbonden met het netwerk en kopieer het installatieprogramma vervolgens naar systemen zonder toegang tot PowerShell Gallery. Onthoud dat het MSI-installatieprogramma alleen werkt voor PowerShell 5.1 in Windows.
Sla de module met Save-Module op in een bestandsshare of sla deze op in een andere bron en kopieer deze handmatig naar andere computers:
Save-Module -Name Az -Path '\\server\share\PowerShell\modules' -Force
Probleemoplossingsproces
Hier volgen enkele veelvoorkomende problemen bij het installeren van de Azure PowerShell-module. Als u een probleem ondervindt dat hier niet wordt vermeld, kunt u een probleem indienen op GitHub.
Proxy blokkeert verbinding
Als u fouten krijgt die Install-Module aangeven dat de PowerShell Gallery onbereikbaar is, bevindt u zich mogelijk achter een proxy. Verschillende besturingssystemen en netwerkomgevingen hebben verschillende vereisten om een systeembrede proxy te configureren. Neem contact op met uw systeembeheerder voor uw proxy-instellingen en hoe u deze configureert voor uw omgeving.
PowerShell zelf is mogelijk niet geconfigureerd om deze proxy automatisch te gebruiken. Configureer met PowerShell 5.1 en hoger de PowerShell-sessie om een proxy te gebruiken met behulp van de volgende opdrachten:
$webClient = New-Object System.Net.WebClient
$webClient.Proxy.Credentials = [System.Net.CredentialCache]::DefaultNetworkCredentials
Als de referenties van uw besturingssysteem correct zijn geconfigureerd, routeert deze configuratie PowerShell-aanvragen via de proxy. Als u deze instelling tussen verschillende sessies wilt behouden, voegt u de opdracht toe aan een PowerShell-profiel.
Als u het pakket wilt installeren, moet uw proxy HTTPS-verbindingen met het volgende adres toestaan:
https://www.powershellgallery.com
Aanmelden
Meld u aan met uw Azure-referenties om aan de slag te gaan met Azure PowerShell.
# Connect to Azure with a browser sign in token
Connect-AzAccount
Opmerking
Als u het automatisch laden van modules hebt uitgeschakeld, importeert u de module handmatig met Import-Module -Name Az.
Vanwege de manier waarop de module is gestructureerd, kan dit enkele seconden duren.
U moet deze stappen herhalen voor elke nieuwe PowerShell-sessie die u start. Zie Gebruikersreferenties behouden in PowerShell-sessies voor meer informatie over het behouden van uw Azure-aanmelding bij PowerShell-sessies.
De Azure PowerShell-module bijwerken
Als u een PowerShell-module bijwerkt, gebruikt u dezelfde methode die is gebruikt om de module te installeren. Als u bijvoorbeeld oorspronkelijk hebt gebruikt Install-Module, moet u Update-Module gebruiken om de nieuwste versie op te halen. Als u het MSI-pakket oorspronkelijk hebt gebruikt, moet u het nieuwe MSI-pakket downloaden en installeren.
De PowerShellGet-cmdlets kunnen modules die zijn geïnstalleerd vanuit een MSI-pakket, niet bijwerken. MSI-pakketten werken modules die zijn geïnstalleerd met PowerShellGet niet bij. Als u problemen ondervindt met het bijwerken met behulp van PowershellGet, moet u deze opnieuw installeren in plaats van bij te werken. Opnieuw installeren gebeurt op dezelfde manier als de installatie, maar u moet de -Force parameter toevoegen:
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
}
In tegenstelling tot installaties op basis van MSI, verwijdert het installeren of bijwerken met PowerShellGet geen oudere versies die mogelijk aanwezig zijn op uw systeem. Als u oude versies van Azure PowerShell uit uw systeem wilt verwijderen, raadpleegt u De Azure PowerShell-module verwijderen. Zie Azure PowerShell installeren met een MSI voor meer informatie over msi-installaties.
Meerdere versies van Azure PowerShell gebruiken
Het is mogelijk om meer dan één versie van Azure PowerShell te installeren. Gebruik de volgende opdracht om te controleren of er meerdere versies van Azure PowerShell zijn geïnstalleerd:
Get-InstalledModule -Name Az -AllVersions | Select-Object -Property Name, Version
Als u een versie van Azure PowerShell wilt verwijderen, raadpleegt u De Azure PowerShell-module verwijderen.
Als u meer dan één versie van de module hebt geïnstalleerd, laadt u de module automatisch en Import-Module laadt u de nieuwste versie standaard.
U kunt een specifieke versie van de Az module installeren of laden met behulp van de -RequiredVersion parameter:
# 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 geven
Als u een fout in Azure PowerShell vindt, kunt u een probleem indienen op GitHub. Als u feedback wilt geven vanaf de opdrachtregel, gebruikt u de cmdlet Send-Feedback .
Volgende stappen
Zie Aan de slag met Azure PowerShellvoor meer informatie over de Azure PowerShell-modules en hun functies. Als u bekend bent met Azure PowerShell en u wilt migreren van AzureRM, raadpleegt u Migrate van AzureRM naar Az.