Condividi tramite

Introduzione a PowerShell Gallery

  • Articolo

PowerShell Gallery è un repository di pacchetti contenente script, moduli e risorse DSC che è possibile scaricare e sfruttare. Usare i cmdlet nel modulo PowerShellGet per installare pacchetti da PowerShell Gallery. Non è necessario accedere per scaricare elementi da PowerShell Gallery.

Nota

È possibile scaricare direttamente un pacchetto da PowerShell Gallery, ma questo non è un approccio consigliato. Per altri dettagli, vedere download manuale dei pacchetti.

È possibile trovare pacchetti in PowerShell Gallery usando il controllo di ricerca nella home page di PowerShell Galleryoppure esplorando la pagina Moduli e script dalla pagina pacchetti . È anche possibile trovare pacchetti da PowerShell Gallery eseguendo i cmdlet Find-Module, Find-DscResourcee Find-Script, a seconda del tipo di pacchetto, con -Repository PSGallery.

È possibile filtrare i risultati dalla raccolta usando i parametri seguenti:

  • Nome
  • AllVersions
  • MinimumVersion
  • RequiredVersion
  • Cartellino
  • Include
  • DscResource
  • RoleCapability
  • Comando
  • Filtro

Se si è interessati solo all'individuazione di risorse DSC specifiche nella raccolta, è possibile eseguire il cmdlet Find-DscResource. Find-DscResource restituisce dati sulle risorse DSC contenute nella raccolta. Poiché le risorse DSC vengono sempre distribuite come parte di un modulo, è comunque necessario eseguire Install-Module per installare tali risorse DSC.

Dopo aver identificato un pacchetto a cui si è interessati, è possibile saperne di più. A tale scopo, esaminare la pagina specifica del pacchetto nella raccolta. In questa pagina sarà possibile visualizzare tutti i metadati caricati con il pacchetto. Questi metadati vengono forniti dall'autore del pacchetto e non vengono verificati da Microsoft. Il proprietario del pacchetto è strettamente associato all'account della raccolta usato per pubblicare il pacchetto ed è più attendibile del campo Autore.

Se si scopre che un pacchetto che si ritiene non sia pubblicato in buona fede, fare clic su Report Abuse nella pagina del pacchetto.

Se si esegue Find-Module o Find-Script, è possibile visualizzare questi dati nell'oggetto PSGetModule Info restituito. Nell'esempio seguente vengono restituiti dati nel modulo PSReadLine nella raccolta.

Find-Module -Name PSReadLine -Repository PSGallery | Get-Member

Quando si scaricano pacchetti da PowerShell Gallery, è consigliabile seguire questa procedura:

Ispezionare

Per scaricare un pacchetto dalla raccolta per l'ispezione, eseguire il cmdlet Save-Module o Save-Script, a seconda del tipo di pacchetto. In questo modo è possibile salvare il pacchetto in locale senza installarlo e controllare il contenuto del pacchetto. Ricordarsi di eliminare manualmente il pacchetto salvato.

Alcuni di questi pacchetti vengono creati da Microsoft e altri vengono creati dalla community di PowerShell. Microsoft consiglia di esaminare il contenuto e il codice dei pacchetti in questa raccolta prima dell'installazione.

Se si scopre che un pacchetto che si ritiene non sia pubblicato in buona fede, fare clic su Report Abuse nella pagina del pacchetto.

Installare

Per installare un pacchetto dalla raccolta da usare, eseguire il cmdlet Install-Module o Install-Script, a seconda del tipo di pacchetto.

Install-Module installa il modulo per $env:ProgramFiles\WindowsPowerShell\Modules per impostazione predefinita. Questo richiede un account amministratore. Se si aggiunge il parametro -Scope CurrentUser, il modulo viene installato in $HOME\Documents\WindowsPowerShell\Modules .

Install-Script installa lo script per $env:ProgramFiles\WindowsPowerShell\Scripts per impostazione predefinita. Questo richiede un account amministratore. Se si aggiunge il parametro -Scope CurrentUser, lo script viene installato in $HOME\Documents\WindowsPowerShell\Scripts .

Per impostazione predefinita, Install-Module e Install-Script installa la versione più recente di un pacchetto. Per installare una versione precedente del pacchetto, aggiungere il parametro -RequiredVersion.

Schierare

Per distribuire un pacchetto da PowerShell Gallery ad Automazione di Azure, fare clic su Automazione di Azure, quindi fare clic su Distribuisci in Automazione di Azure nella pagina dei dettagli del pacchetto. Si viene reindirizzati al portale di gestione di Azure in cui si accede usando le credenziali dell'account Azure. Si noti che la distribuzione di pacchetti con dipendenze distribuisce tutte le dipendenze in Automazione di Azure. Il pulsante "Distribuisci in Automazione di Azure" può essere disabilitato aggiungendo il tag AzureAutomationNotSupported ai metadati del pacchetto.

Per altre informazioni su Automazione di Azure, vedere la documentazione automazione di Azure.

Per aggiornare i pacchetti installati da PowerShell Gallery, eseguire il cmdlet Update-Module o Update-Script. Quando viene eseguito senza parametri aggiuntivi, Update-Module tenta di aggiornare tutti i moduli installati eseguendo Install-Module. Per aggiornare in modo selettivo i moduli, aggiungere il parametro -Name.

Analogamente, quando viene eseguito senza parametri aggiuntivi, Update-Script tenta anche di aggiornare tutti gli script installati eseguendo Install-Script. Per aggiornare in modo selettivo gli script, aggiungere il parametro -Name.

Per scoprire quali moduli sono stati installati da PowerShell Gallery, eseguire il cmdlet Get-InstalledModule. Questo comando elenca tutti i moduli presenti nel sistema installati direttamente da PowerShell Gallery.

Analogamente, per scoprire quali script sono stati installati da PowerShell Gallery, eseguire il cmdlet Get-InstalledScript. Questo comando elenca tutti gli script presenti nel sistema installati direttamente da PowerShell Gallery.

Questi nomi host devono essere aggiunti agli elenchi consenti che controllano l'accesso dalla rete.

Host necessari per l'individuazione e il download dei pacchetti:

  • onegetcdn.azureedge.net
  • powershellgallery.azureedge.net
  • psg-prod-eastus.azureedge.net

Host necessari quando si usa il sito Web di PowerShell Gallery:

  • *.powershellgallery.com - sito Web
  • go.microsoft.com e aka.ms - Servizi di reindirizzamento

Importante

A partire da aprile 2020, PowerShell Gallery non supporta più le versioni 1.0 e 1.1 di Transport Layer Security (TLS). Se non si usa TLS 1.2 o versione successiva, si riceverà un errore quando si prova ad accedere a PowerShell Gallery. Usare il comando seguente per assicurarsi di usare TLS 1.2:

[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12

Per altre informazioni, vedere l'annuncio nel blog di PowerShell.