Galleria

La Gallery è una raccolta di soluzioni predefinite per PowerShell Universal. Include risorse come script, trigger, app e widget. È open source e i moduli vengono pubblicati sulla PowerShell Gallery. La PowerShell Universal Gallery fornisce un elenco filtrato di risorse specifiche per la piattaforma.

Installazione delle risorse dalla Gallery

Pagina Gallery

La pagina Gallery individua i moduli di PowerShell Universal nella PowerShell Gallery. I risultati vengono memorizzati nella cache per 5 minuti per migliorare le prestazioni.

Per installare le risorse dalla libreria, faccia clic su Platform \ Gallery nella Universal Admin Console. Faccia clic sull'icona di installazione per salvare la risorsa nel suo ambiente. Ogni soluzione è un modulo PowerShell che verrà incluso nella directory dei moduli del suo Repository.

Moduli nella Gallery

Le risorse installate dai moduli, come quelle provenienti dalla Gallery, sono contrassegnate come di sola lettura nella Admin Console.

Risorsa di sola lettura nella Admin Console

Pagina del modulo

Nella pagina del modulo, faccia clic su Galleries, quindi selezioni PSGallery per cercare e scaricare risorse direttamente dal feed della PowerShell Gallery. Dovrà filtrare per il tag PowerShellUniversal per trovare i moduli specifici della piattaforma.

Disinstallazione delle risorse

Una volta installata, una risorsa non può essere rimossa a meno che non venga rimosso il modulo stesso. Può accedere alla pagina Platform \ Modules e fare clic sulla scheda Repository Modules per visualizzare i moduli installati dalla libreria.

Facendo clic sull'icona di eliminazione, verranno rimossi il modulo e tutte le risorse associate.

Repository Modules

Contribuire alla Gallery

Può contribuire con i suoi script alla PowerShell Universal Gallery. La PowerShell Universal Gallery individua automaticamente i moduli all'interno della PowerShell Gallery contrassegnati con il tag PowerShellUniversal. Se desidera che il suo modulo compaia all'interno della PowerShell Universal Gallery e di PowerShell Universal, includa questo tag.

Di seguito è riportato un esempio di manifest dal repository della PowerShell Universal Gallery. Può includere un percorso di repository GitHub come ProjectUri nel manifest. In tal caso, il contenuto del file README.md verrà visualizzato su PowerShellUniversal.com.

@{
    ModuleVersion = '1.0.0'
    GUID          = '59f32838-32bb-46e3-b29d-eb360292a8c9'
    Author        = 'Ironman Software'
    CompanyName   = 'Ironman Software'
    Copyright     = '(c) Ironman Software. All rights reserved.'
    Description   = 'Provides API endpoints from querying, creating, deleting and updating CIM instances.'
    PrivateData   = @{
        PSData = @{
            Tags       = @('CIM', "PowerShellUniversal", "api")
            LicenseUri = 'https://github.com/ironmansoftware/scripts/tree/main/LICENSE'
            ProjectUri = 'https://github.com/ironmansoftware/scripts/tree/main/APIs/PowerShellUniversal.API.CIM'
            IconUri    = 'https://raw.githubusercontent.com/ironmansoftware/scripts/main/images/script.png'
        }
    }
}

Moduli con licenza

I moduli con licenza sono attualmente in anteprima.

A partire da PowerShell Universal 5.2, ora può includere l'opzione PSULicensed nella sezione PSData del manifest del suo modulo. Se il modulo è concesso in licenza, non verrà caricato senza un file di licenza specifico per il modulo da caricare. Attualmente i file di licenza vengono generati manualmente da Ironman Software per gli autori dei moduli. Contatti il supporto di Ironman Software per maggiori informazioni.

@{
    ModuleVersion = '1.0.0'
    GUID          = '59f32838-32bb-46e3-b29d-eb360292a8c9'
    Author        = 'Ironman Software'
    CompanyName   = 'Ironman Software'
    Copyright     = '(c) Ironman Software. All rights reserved.'
    Description   = 'Provides API endpoints from querying, creating, deleting and updating CIM instances.'
    PrivateData   = @{
        PSData = @{
            Tags       = @('CIM', "PowerShellUniversal", "api")
            LicenseUri = 'https://github.com/ironmansoftware/scripts/tree/main/LICENSE'
            ProjectUri = 'https://github.com/ironmansoftware/scripts/tree/main/APIs/PowerShellUniversal.API.CIM'
            IconUri    = 'https://raw.githubusercontent.com/ironmansoftware/scripts/main/images/script.png'
            PSULicensed = $true
        }
    }
}

Se un modulo con licenza è installato ma non viene fornita alcuna licenza, PowerShell Universal non caricherà le risorse dal modulo. Tenga presente che le funzioni, gli alias e le variabili PowerShell generiche esposte dal modulo saranno comunque disponibili. App, script, API o altre funzionalità di PowerShell Universal non verranno caricate.

I moduli con licenza attualmente non forniscono alcun meccanismo per offuscare i suoi script PowerShell o per impedire agli utenti di rimuovere il flag di licenza. Consigliamo di includere un EULA standard per garantire che gli utenti siano legalmente responsabili della manipolazione di questi file per aggirare la licenza.