Condividi tramite

Introduzione a PowerShell Gallery

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

È 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 scelto un pacchetto, potresti voler saperne di più. Consulta la pagina del pacchetto nella Galleria. La pagina del pacchetto include i metadati caricati insieme al pacchetto. I metadati sono forniti dall'autore del pacchetto. Microsoft non verifica queste informazioni. Il proprietario del pacchetto è associato all'account Galleria utilizzato per pubblicare il pacchetto. L'account Proprietario è più autorevole rispetto al campo Autore.

Se scopri un pacchetto che ritieni non sia stato pubblicato in buona fede, seleziona Segnala Abuso nella pagina di quel 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 Galleria per l'ispezione, usa i Save-Module moduli di comando di OR Save-Script presenti nel pacchetto. Questi comandi salvano il pacchetto localmente senza installarlo. Ispeziona il contenuto della confezione. Ricordarsi di eliminare manualmente il pacchetto salvato.

Alcuni pacchetti sono creati da Microsoft, altri dalla comunità PowerShell. Microsoft consiglia di esaminare il contenuto e il codice dei pacchetti in questa raccolta prima dell'installazione.

Se scopri un pacchetto che ritieni non sia stato pubblicato in buona fede, seleziona Segnala Abuso nella pagina di quel pacchetto.

Installare

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

Di default, Install-Module installa il modulo in $env:ProgramFiles\WindowsPowerShell\Modules posizione di default, il che richiede un account amministratore. Se aggiungi il -Scope CurrentUser parametro, il comando installa il modulo in $HOME\Documents\WindowsPowerShell\Modules .

Di default, Install-Script installa lo script in $env:ProgramFiles\WindowsPowerShell\Scripts posizione, il che richiede un account amministratore. Se aggiungi il -Scope CurrentUser parametro, il comando installa lo script in $HOME\Documents\WindowsPowerShell\Scripts.

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 dalla galleria PowerShell ad Azure Automation, seleziona Azure Automation, poi seleziona Deploy to Azure Automation nella pagina dettagli del pacchetto. Vieni reindirizzato al Portale di Gestione Azure dove accedi usando le credenziali del tuo account Azure. Distribuire pacchetti con dipendenze distribuisce tutte le dipendenze su Azure Automation. Il pulsante Deploy to Azure Automation può essere disabilitato aggiungendo il tag AzureAutomationNotSupported ai metadati del tuo 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 altri parametri, 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 eseguito senza altri parametri, 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 hai installato dalla PowerShell Gallery, esegui il Get-InstalledModule cmdlet. Questo comando elenca tutti i moduli presenti nel sistema installati direttamente da PowerShell Gallery.

Allo stesso modo, per scoprire quali script hai installato dalla galleria PowerShell, esegui il Get-InstalledScript cmdlet. Questo comando elenca tutti gli script presenti nel sistema installati direttamente da PowerShell Gallery.

Importante

PowerShell Gallery richiede Transport Layer Security (TLS) 1.2 o versione successiva. 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

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:

  • cdn.oneget.org
  • cdn.powershellgallery.com

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

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

Nota

Gli endpoint precedenti che terminavano con azureedge.net non sono più supportati.

  • Last updated on