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 .zip
automatisch vervangen door . Als u het pakket wilt uitvouwen, wijzigt u indien nodig de naam van het .nupkg
bestand in .zip
en 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:
- Deblokkeer het nuGet-pakketbestand (
.nupkg
) dat via internet is gedownload, bijvoorbeeld met behulp van eenUnblock-File -Path C:\Downloads\module.nupkg
cmdlet. - Pak de inhoud van het NuGet-pakket uit naar een lokale map.
- Verwijder de NuGet-specifieke elementen uit de map.
- 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 bijvoorbeeldazurerm.storage
. - 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:
- Deblokkeer het nuGet-pakketbestand (
.nupkg
) dat via internet is gedownload, bijvoorbeeld met behulp van eenUnblock-File -Path C:\Downloads\package.nupkg
cmdlet. - Pak de inhoud van het NuGet-pakket uit.
- Het
.PS1
bestand in de map kan rechtstreeks vanaf deze locatie worden gebruikt. - 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.
PowerShell Gallery