> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/powershell-universal/it/piattaforma/library.md).

# 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 nella PowerShell Gallery. La [PowerShell Universal Gallery](https://powershelluniversal.com/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.

<figure><img src="/files/K3XoTKnAeil4SCk9d3Tj" alt=""><figcaption><p>Moduli nella Gallery</p></figcaption></figure>

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

<figure><img src="/files/3l2TnKrq4jspCjxZjo3j" alt=""><figcaption><p>Risorsa di sola lettura nella Admin Console</p></figcaption></figure>

### 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.

<figure><img src="/files/mj7IObhGj93lTtsrfaUv" alt=""><figcaption><p>Repository Modules</p></figcaption></figure>

## 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.

```powershell
@{
    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

{% hint style="info" %}
I moduli con licenza sono attualmente in anteprima.
{% endhint %}

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.

```powershell
@{
    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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.devolutions.net/powershell-universal/it/piattaforma/library.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
