Handmatig pakket downloaden

De PowerShell Gallery ondersteunt het rechtstreeks downloaden van een pakket vanaf de website, zonder de PowerShellGet-cmdlets te gebruiken. U kunt elk pakket downloaden als een NuGet-pakketbestand (.nupkg), dat u vervolgens kunt kopiëren naar een interne opslagplaats.

Notitie

Handmatig downloaden van pakketten is niet bedoeld als vervanging voor de Install-Module cmdlet. Als u het pakket downloadt, wordt de module of het script niet geïnstalleerd. Afhankelijkheden zijn niet opgenomen in het NuGet-pakket dat is gedownload. De volgende instructies worden alleen ter referentie verstrekt.

Handmatig downloaden gebruiken om een pakket te verkrijgen

Elke pagina heeft een koppeling voor handmatig downloaden, zoals hier wordt weergegeven:

Als u handmatig wilt downloaden, klikt u op Het onbewerkte nupkg-bestand downloaden. Er wordt een kopie van het pakket gekopieerd naar de downloadmap voor uw browser met de naam <name>.<version>.nupkg.

Een NuGet-pakket is een ZIP-archief met extra bestanden met informatie over de inhoud van het pakket. Sommige browsers, zoals Internet Explorer, vervangen automatisch de .nupkg bestandsextensie door .zip. Als u het pakket wilt uitvouwen, wijzigt u de naam van het .nupkg bestand in .zip, indien nodig, en extraheert u de inhoud vervolgens naar een lokale map met behulp van Expand-Archive of een ander ZIP-bestandsprogramma.

Een NuGet-pakketbestand bevat de volgende NuGet-specifieke elementen die geen deel uitmaken van de oorspronkelijke verpakte code:

• Een map met de naam _rels - bevat een .rels-bestand met de afhankelijkheden
• Een map met de naam package - bevat de NuGet-specifieke gegevens
• Een bestand met de naam [Content_Types].xml - beschrijft hoe extensies zoals PowerShellGet werken met NuGet
• Een bestand met de naam <name>.nuspec: bevat het grootste deel van de metagegevens

PowerShell-modules installeren vanuit een NuGet-pakket

Notitie

Deze instructies NIET hetzelfde resultaat geven als het uitvoeren van Install-Module. Deze instructies voldoen aan de minimale vereisten. Ze zijn niet bedoeld als vervanging voor Install-Module. Sommige stappen die door Install-Module worden uitgevoerd, zijn niet opgenomen.

De eenvoudigste methode is om de NuGet-specifieke elementen uit de map te verwijderen. Als u de elementen verwijdert, blijft de PowerShell-code die is gemaakt door de auteur van het pakket. Zie Handmatig downloaden gebruiken om een pakket te verkrijgenvoor de lijst met NuGet-specifieke elementen.

De stappen zijn als volgt:

1. Deblokker het nuGet-bestand (.nupkg) dat via internet is gedownload, bijvoorbeeld met behulp van Unblock-File -Path C:\Downloads\module.nupkg cmdlet.
2. Pak de inhoud van het NuGet-pakket uit naar een lokale map.
3. Verwijder de NuGet-specifieke elementen uit de map.
4. Wijzig de naam van de map. De standaardmapnaam wordt meestal <name>.<version>. De versie kan -prerelease bevatten als de module is gelabeld als een voorlopige versie. Wijzig de naam van de map in alleen de modulenaam. azurerm.storage.5.0.4-preview wordt bijvoorbeeld azurerm.storage.
5. Kopieer de map naar een van de mappen in de $env:PSModulePath value. $env:PSModulePath is een door puntkomma's gescheiden reeks paden waarin PowerShell moet zoeken naar modules.

Belangrijk

De handmatige download bevat geen afhankelijkheden die vereist zijn voor de module. Als het pakket afhankelijkheden heeft, moeten ze op het systeem worden geïnstalleerd om deze module correct te laten werken. In de PowerShell Gallery worden alle afhankelijkheden weergegeven die vereist zijn voor het pakket.

PowerShell-scripts installeren vanuit een NuGet-pakket

Notitie

Deze instructies NIET hetzelfde resultaat geven als het uitvoeren van Install-Script. Deze instructies voldoen aan de minimale vereisten. Ze zijn niet bedoeld als vervanging voor Install-Script.

De eenvoudigste methode is om het NuGet-pakket te extraheren en vervolgens het script rechtstreeks te gebruiken.

De stappen zijn als volgt:

1. Deblokker het nuGet-bestand (.nupkg) dat via internet is gedownload, bijvoorbeeld met behulp van Unblock-File -Path C:\Downloads\package.nupkg cmdlet.
2. Pak de inhoud van het NuGet-pakket uit.
3. Het .PS1-bestand in de map kan rechtstreeks vanaf deze locatie worden gebruikt.
4. U kunt de NuGet-specifieke elementen in de map verwijderen.

Zie Handmatig downloaden gebruiken om een pakket te verkrijgenvoor de lijst met NuGet-specifieke elementen.

Belangrijk

De handmatige download bevat geen afhankelijkheden die vereist zijn voor de module. Als het pakket afhankelijkheden heeft, moeten ze op het systeem worden geïnstalleerd om deze module correct te laten werken. In de PowerShell Gallery worden alle afhankelijkheden weergegeven die vereist zijn voor het pakket.