Delen via


Offline-installatie van Azure PowerShell

In sommige omgevingen is het niet mogelijk om verbinding te maken met internet of de PowerShell Gallery. In dergelijke situaties kunt u de Az PowerShell-module offline installeren met behulp van een van deze methoden.

Notitie

Voor de opties voor offline-installatie in dit artikel is ten minste één systeem met internettoegang vereist om de Az PowerShell-module te downloaden. Dit kan afwijken van het systeem waarop u de module wilt installeren.

Voorwaarden

Platformoverschrijdend

De volgende installatieopties voor de Az PowerShell-module zijn beschikbaar op alle platformen, waaronder Windows, Linux en macOS.

Installeren vanuit tar-archief

Tip

Het tar opdrachtregelprogramma is vereist voor het gebruik van deze installatieoptie. De versie is standaard beschikbaar in Windows 10 versie 1803 of hoger, de meeste Linux-distributies en de huidige versies van macOS.

  1. Definieer op een systeem met toegang tot internet het doelpad waar u het tar-archief wilt opslaan.

    $downloadFolderPath = "$home/Downloads"
    
  2. Controleer of de downloadmap bestaat. Maak de map indien anders.

    if (-not (Test-Path -Path $downloadFolderPath -PathType Container)) {
        New-Item -Path $downloadFolderPath -ItemType Directory
    }
    
  3. Bepaal de URL van het tar-archief voor de meest recente versie van de Az PowerShell-module op GitHub.

    $tarSourceUrl = (
        Invoke-RestMethod -Uri https://api.github.com/repos/azure/azure-powershell/releases/latest |
        Select-Object -ExpandProperty assets | Where-Object content_type -eq 'application/x-gzip'
    ).browser_download_url
    
  4. Sla de tar-bestandsnaam en het doelbestandspad op in variabelen.

    $fileName = Split-Path -Path $tarSourceUrl -Leaf
    $downloadFilePath = Join-Path -Path $downloadFolderPath -ChildPath $fileName
    
  5. Download het tar-archief vanuit GitHub met behulp van PowerShell.

    Invoke-WebRequest -Uri $tarSourceUrl -OutFile $downloadFilePath
    
  6. Ontgrendel het gedownloade bestand als u Windows gebruikt.

    if ($PSVersionTable.PSVersion.Major -le 5 -or $IsWindows -eq $true) {
        Unblock-File -Path $downloadFilePath
    }
    

    Notitie

    Kopieer het tar-archief naar uw offlinesysteem. Definieer de $downloadFilePath en $downloadFolderPath variabelen of geef werkelijke waarden op in plaats van de variabelen te gebruiken in de volgende opdrachten op uw offlinesysteem.

  7. Pak de inhoud van het tar-archief uit.

    tar zxf $downloadFilePath -C $downloadFolderPath
    
  8. Voer het InstallModule.ps1 script uit dat een van de uitgepakte bestanden op het offlinesysteem is waar u de Az PowerShell-module wilt installeren.

    .$downloadFolderPath/InstallModule.ps1
    

Installatie opslaan en kopiëren

Download de Az PowerShell-module met Save-Module of Save-PSResource naar een netwerklocatie met behulp van een systeem met toegang tot internet en de PowerShell Gallery. Met deze opdrachten worden de Az-module en de bijbehorende afhankelijkheden op de opgegeven locatie opgeslagen. Gebruik de opgeslagen modules als installatiebron en kopieer ze naar het offlinesysteem.

Installeren vanuit een privéopslagplaats

Maak een privéopslagplaats in uw lokale netwerk en gebruik deze als installatiebron voor uw offlinesysteem. Zie Werken met privé-PowerShellGet-opslagplaatsenvoor meer informatie.

Met deze methode kunt u PowerShell-modules in de cache opslaan op één server of bestandsshare die moeten worden geïmplementeerd met PowerShellGet- of Microsoft.PowerShell.PSResourceGet op niet-verbonden systemen.

Ramen

In Windows hebt u ook de mogelijkheid om de Az PowerShell-module met een MSI te installeren als u Windows PowerShell versie 5.1 gebruikt.

Belangrijk

Houd er rekening mee dat het MSI-installatieprogramma alleen werkt voor Windows PowerShell 5.1.

Probleemoplossing

Zie Installatieproblemen oplossen met de Az PowerShell-modulevoor oplossingen voor veelvoorkomende installatieproblemen met de Az PowerShell-module.

Zie ook

Volgende stappen

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