Creare moduli negli script di Windows PowerShell
È possibile creare moduli per archiviare le funzioni e condividerle tra gli script. Dopo averle inserite nei moduli, le funzioni sono individuabili allo stesso modo dei cmdlet. Analogamente ai moduli di Windows predefiniti, i moduli vengono caricati automaticamente quando è necessaria una funzione.
Nota
Assegnare un nome alle funzioni nei moduli usando la stessa convenzione di denominazione verbo-sostantivo dei cmdlet. Ad esempio, usare il formato verbo-sostantivo.
Nota
Le funzioni nei moduli possono includere una Guida basata su commenti che Get-Help può individuare. Includere le informazioni della Guida in ogni funzione per abilitare questa funzionalità.
Se si dispone già di funzioni in un file di script di PowerShell Windows, convertirlo in un modulo rinominandolo con l'estensione di file .psm1. La struttura del file non deve essere modificata.
Windows PowerShell usa la variabile di ambiente $PSModulePath per definire i percorsi da cui vengono caricati i moduli. In Windows PowerShell 5.1 sono elencati i percorsi seguenti:
- C:\Users\UserID\Documents\WindowsPowerShell\Modules
- C:\Programmi\WindowsPowerShell\Modules
- C:\Windows\System32\WindowsPowerShell\1.0\Modules
Windows PowerShell 7 include gli altri percorsi elencati sotto:
- C:\Users\UserID\Documents\PowerShell\Modules
- C:\Programmi\PowerShell\Moduli
- C:\Programmi\PowerShell\7\Moduli
Nota
Il percorso dell'ambito utente di PowerShell 7 (Documents\PowerShell\Modules) è diverso dal percorso dell'ambito utente di PowerShell 5.1 Windows (Documents\WindowsPowerShell\Modules). I moduli archiviati nel percorso 5.1 non vengono caricati automaticamente nelle sessioni con ambito utente ps7.
Nota
Se si archiviano moduli in C:\Users\UserID\Documents\WindowsPowerShell\Modules, sono disponibili solo per un singolo utente.
I moduli non vengono inseriti direttamente nella directory Modules . È invece necessario creare una sottocartella con lo stesso nome del file e posizionare il file in tale cartella. Ad esempio, se si ha un modulo denominato AdatumFunctions.psm1, è necessario inserirlo in C:\Programmi\WindowsPowerShell\Modules\AdatumFunctions.