• 6 minuten te lezen
• m
• h

Dit artikel legt uit hoe de Azure PowerShell-modules te installeren met PowerShellGet. Deze instructies werken op Windows -, macOS-en Linux-platforms.

Azure PowerShell is ook beschikbaar in Azure Cloud Shell en is nu geïnstalleerd in Docker-images.

vereisten

Azure PowerShell werkt met PowerShell 6.2.4 en later op alle platforms. Het wordt ook ondersteund metpowershell 5.1 op Windows. Installeer de nieuwste versie van PowerShell die beschikbaar is voor uw besturingssysteem. Azure PowerShell heeft geen extra vereisten wanneer deze wordt uitgevoerd op PowerShell 6.2.4 en hoger.

om uw PowerShell-versie te controleren, voert u het commando:

$PSVersionTable.PSVersion

om Azure PowerShell in PowerShell 5.1 te gebruiken op Windows:

1. Update toWindows PowerShell 5.1.,Als u Windows 10 versie 1607 of hoger gebruikt, hebt u al PowerShell 5.1 geà nstalleerd.
2. Install.NET Framework 4.7.2 of hoger.
3. zorg ervoor dat u de nieuwste versie van PowerShellGet hebt. Voer Install-Module -Name PowerShellGet -Forceuit.

installeer de Azure PowerShell-module

Install voor de huidige gebruiker

met behulp van de PowerShellGet cmdlets is de voorkeur installatie methode. Installeer de AZ module alleen voor de huidige gebruiker. Dit is de aanbevolen installatie scope. Deze methode werkt op dezelfde Windows -, macOS-en Linux-platforms. Voer het volgende commando uit vanuit een PowerShell-sessie:

standaard is de PowerShell-galerij niet geconfigureerd als een vertrouwde repository voor PowerShellGet., De eerste keer dat u de PSGallery gebruikt, ziet u de volgende prompt:

antwoord Yes of Yes to All om door te gaan met de installatie.

installeren voor alle gebruikers

het installeren van de module voor alle gebruikers op een systeem vereist verhoogde rechten. Start de PowerShellsession met het uitvoeren Als administrator in Windows of gebruik de opdracht sudo op macOS of Linux:

De AZ-module is een rollup-module voor de Azure PowerShell-cmdlets., Het installeren downloadt alle algemeen beschikbare AZ PowerShell modules, en maakt hun cmdlets beschikbaar voor gebruik.

installeer offline

in sommige omgevingen is het niet mogelijk om verbinding te maken met de PowerShell-galerij. In die 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 dat als een installatie bron.Met deze methode kunt u PowerShell-modules cachen op een enkele server of bestandsdeling die moet worden geà mplementeerd met PowerShellGet naar niet-verbonden systemen., Leer hoe je een lokale repository instelt en installeert op losgekoppelde systemen metworking with local PowerShellGet repositories.

• Download de Azure PowerShell MSI naar een machine die is aangesloten op het netwerk,en kopieer het installatieprogramma naar systemen zonder toegang tot de PowerShell-galerij. Houd in gedachten dat theMSI installer werkt alleen voor PowerShell 5.1 op Windows.,

• sla de module met Save-Module op in een bestandshare,of sla het op in een andere bron en kopieer het handmatig naar andere machines:

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

problemen oplossen

Hier zijn enkele veel voorkomende problemen bij het installeren van de Azure PowerShell module. Als je een probleem ervaart dat hier niet vermeld staat, dien dan een probleem in op GitHub.

Proxy blokkeert verbinding

Als u fouten krijgt van Install-Module die aangeven dat de PowerShell-galerij onbereikbaar is, kunt u misschien achter een proxy zitten., Verschillende besturingssystemen en netwerkomgevingen hebben verschillende vereisten voor het configureren van een systeembrede proxy. Neem Contact op met uw systeembeheerder voor uw proxy-instellingen en hoe u deze kunt configureren voor uw omgeving.

PowerShell zelf kan niet worden geconfigureerd om deze proxy automatisch te gebruiken. Met PowerShell 5.1 enlater, configureert u de PowerShell-sessie om een proxy te gebruiken met behulp van de volgende commando ‘ s:

als uw besturingssysteem referenties correct zijn geconfigureerd, stuurt deze configuratie PowerShell-verzoeken via de proxy., Om deze instelling tussen sessies te laten voortduren, voeg je de commando ‘ s toe aan je PowerShell profiel.

om het pakket te installeren, moet uw proxy HTTPS-verbindingen toestaan naar het volgende adres:

Sign in

To start working with Azure PowerShell, sign in with your Azure credentials.

u moet deze stappen herhalen voor elke nieuwe PowerShell-sessie die u start. Om te leren hoe je Azure inlogt op topersist voor PowerShell-sessies, ziepersist gebruikersreferenties voor PowerShell-sessies.,

Update de Azure PowerShell-module

om een PowerShell-module bij te werken, moet u dezelfde methode gebruiken om de module te installeren. Bijvoorbeeld, als je oorspronkelijk Install-Module gebruikt, dan moet je de update-Module gebruiken om de laatste versie te krijgen. Als u oorspronkelijk het MSI-pakket hebt gebruikt, moet u het nieuwe MSI-pakket downloaden en installeren.

De PowerShellGet-cmdlets kunnen geen modules bijwerken die zijn geïnstalleerd vanuit een MSI-pakket. MSIpackages werken geen modules bij die zijn geïnstalleerd met PowerShellGet., Als u een issuesupdating met behulp van PowershellGet, dan moet u opnieuw installeren, in plaats van bij te werken. Isdone opnieuw installeren op dezelfde manier als installeren, maar u moet de parameter -Force toevoegen:

In tegenstelling tot op MSI gebaseerde installaties verwijdert installatie of update met PowerShellGet geen oudere versies die op uw systeem kunnen bestaan. Zie de Azure PowerShell-module verwijderen om oude versies van Azure PowerShell van uw systeem te verwijderen. Zie Azure PowerShell installeren met een MSI voor meer informatie over op MSI gebaseerde installaties.,

gebruik meerdere versies van Azure PowerShell

Het is mogelijk om meer dan één versie van Azure PowerShell te installeren. Om te controleren of er meerdere versies van Azure PowerShell zijn geïnstalleerd, gebruik je het volgende commando:

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

om een versie van Azure PowerShell te verwijderen, zie de Azure PowerShell-module verwijderen.

Als u meer dan één versie van de module hebt geïnstalleerd, laden module autoload en Import-Module standaard de nieuwste versie.,

u kunt een specifieke versie van de Az module installeren of laden met behulp van de -RequiredVersionparameter:

gebruik meerdere repositories met PowerShellGet

de Repository parameter is vereist als u extra repositories aan PowerShellGeton uw systeem hebt toegevoegd en de AZ-module kan in meer dan een ervan worden gevonden.

Geef feedback

Als u een bug in Azure PowerShell vindt,dien dan een probleem op GitHub in. Om feedbackvan de opdrachtregel te voorzien, gebruikt u de cmdlet Send-Feedback.,

voor meer informatie over de Azure PowerShell-modules en hun functies, is seeGet gestart met Azure PowerShell. Als u bekend bent met AzurePowerShell en moet migreren van AzureRM, seeMigrate from AzureRM to Az.