Download manuale dei pacchetti

PowerShell Gallery supporta il download diretto di un pacchetto dal sito Web, senza usare i cmdlet PowerShellGet. È possibile scaricare qualsiasi pacchetto come file NuGet (.nupkg) che è quindi possibile copiare in un repository interno.

Nota

Il download manuale dei pacchetti non è previsto come sostituzione del cmdlet Install-Module. Il download del pacchetto non installa il modulo o lo script. Le dipendenze non sono incluse nel pacchetto NuGet scaricato. Le istruzioni seguenti vengono fornite solo a scopo di riferimento.

Uso del download manuale per acquisire un pacchetto

Ogni pagina include un collegamento per il download manuale, come illustrato di seguito:

pagina di visualizzazione del pacchetto

Per scaricare manualmente, fare clic su Scaricare il file nupkg non elaborato. Una copia del pacchetto viene copiata nella cartella di download del browser con il nome <name>.<version>.nupkg.

Un pacchetto NuGet è un archivio ZIP con file aggiuntivi contenenti informazioni sul contenuto del pacchetto. Alcuni browser, ad esempio Internet Explorer, sostituiscono automaticamente l'estensione di file .nupkg con .zip. Per espandere il pacchetto, rinominare il file .nupkg in .zip, se necessario, quindi estrarre il contenuto in una cartella locale usando Expand-Archive o un altro strumento di file ZIP.

Un file di pacchetto NuGet include i seguenti elementi specifici di NuGet che non fanno parte del codice incluso nel pacchetto originale:

• Una cartella denominata _rels : contiene un file .rels che elenca le dipendenze
• Una cartella denominata package : contiene i dati specifici di NuGet
• Un file denominato [Content_Types].xml : descrive il funzionamento delle estensioni come PowerShellGet con NuGet
• Un file denominato <name>.nuspec : contiene la maggior parte dei metadati

Installazione di moduli di PowerShell da un pacchetto NuGet

Nota

Queste istruzioni NON danno lo stesso risultato dell'esecuzione di Install-Module. Queste istruzioni soddisfano i requisiti minimi. Non sono destinati a sostituire Install-Module. Alcuni passaggi eseguiti da Install-Module non sono inclusi.

L'approccio più semplice consiste nel rimuovere gli elementi specifici di NuGet dalla cartella. La rimozione degli elementi lascia il codice di PowerShell creato dall'autore del pacchetto. Per l'elenco di elementi specifici di NuGet, vedere Uso del download manuale per acquisire un pacchetto.

I passaggi sono i seguenti:

1. Sbloccare il file Del pacchetto NuGet scaricato da Internet (.nupkg) , ad esempio usando Unblock-File -Path C:\Downloads\module.nupkg cmdlet.
2. Estrarre il contenuto del pacchetto NuGet in una cartella locale.
3. Eliminare gli elementi specifici di NuGet dalla cartella.
4. Rinominare la cartella. Il nome predefinito della cartella è in genere <name>.<version>. La versione può includere -prerelease se il modulo è contrassegnato come versione non definitiva. Rinominare la cartella in base al nome del modulo. Ad esempio, azurerm.storage.5.0.4-preview diventa azurerm.storage.
5. Copiare la cartella in una delle cartelle nella $env:PSModulePath value. $env:PSModulePath è un set di percorsi delimitato da punto e virgola in cui PowerShell deve cercare i moduli.

Importante

Il download manuale non include dipendenze richieste dal modulo. Se il pacchetto presenta dipendenze, deve essere installato nel sistema per il corretto funzionamento del modulo. PowerShell Gallery mostra tutte le dipendenze richieste dal pacchetto.

Installazione di script di PowerShell da un pacchetto NuGet

Nota

Queste istruzioni NON danno lo stesso risultato dell'esecuzione di Install-Script. Queste istruzioni soddisfano i requisiti minimi. Non sono destinati a sostituire Install-Script.

L'approccio più semplice consiste nell'estrarre il pacchetto NuGet, quindi usare direttamente lo script.

I passaggi sono i seguenti:

1. Sbloccare il file Del pacchetto NuGet scaricato da Internet (.nupkg) , ad esempio usando Unblock-File -Path C:\Downloads\package.nupkg cmdlet.
2. Estrarre il contenuto del pacchetto NuGet.
3. Il file .PS1 nella cartella può essere usato direttamente da questo percorso.
4. È possibile eliminare gli elementi specifici di NuGet nella cartella.

Per l'elenco di elementi specifici di NuGet, vedere Uso del download manuale per acquisire un pacchetto.

Importante

Il download manuale non include dipendenze richieste dal modulo. Se il pacchetto presenta dipendenze, deve essere installato nel sistema per il corretto funzionamento del modulo. PowerShell Gallery mostra tutte le dipendenze richieste dal pacchetto.