Pakket handmatig downloaden

De PowerShell Gallery ondersteunt het rechtstreeks downloaden van een pakket van 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 Gedownloade NuGet-pakket. De volgende instructies zijn alleen ter referentie.

Handmatig downloaden gebruiken om een pakket te verkrijgen

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

Als u het bestand handmatig wilt downloaden, klikt u op Het onbewerkte nupkg-bestand downloaden. Een kopie van het pakket wordt 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. In sommige browsers, zoals Internet Explorer, wordt de .nupkg bestandsextensie .zipautomatisch vervangen door . Als u het pakket wilt uitvouwen, wijzigt u indien nodig de naam van het .nupkg bestand in .zipen extraheert u de inhoud naar een lokale map.

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 geven NIET hetzelfde resultaat 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 aanpak is om de NuGet-specifieke elementen uit de map te verwijderen. Als u de elementen verwijdert, blijft de PowerShell-code over die door de auteur van het pakket is gemaakt. Zie Using manual download to acquire a package (Handmatig downloaden gebruiken om een pakket te verkrijgen) voor de lijst met NuGet-specifieke elementen.

De stappen zijn als volgt:

1. Deblokkeer het nuGet-pakketbestand (.nupkg) dat via internet is gedownload, bijvoorbeeld met behulp van een 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 is meestal <name>.<version>. De versie kan bevatten -prerelease als de module is gelabeld als een voorlopige versie. Wijzig de naam van de map in alleen de naam van de module. 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 naar modules moet zoeken.

Belangrijk

De handmatige download bevat geen afhankelijkheden die zijn vereist voor de module. Als het pakket afhankelijkheden heeft, moeten deze 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 geven NIET hetzelfde resultaat als het uitvoeren van Install-Script. Deze instructies voldoen aan de minimale vereisten. Ze zijn niet bedoeld als vervanging voor Install-Script.

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

De stappen zijn als volgt:

1. Deblokkeer het nuGet-pakketbestand (.nupkg) dat via internet is gedownload, bijvoorbeeld met behulp van een 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 Using manual download to acquire a package (Handmatig downloaden gebruiken om een pakket te verkrijgen) voor de lijst met NuGet-specifieke elementen.

Belangrijk

De handmatige download bevat geen afhankelijkheden die zijn vereist voor de module. Als het pakket afhankelijkheden heeft, moeten deze 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.