In PowerShell, come posso definire una funzione in un file e chiamarla dalla riga di comando di PowerShell?

Ho un file .ps1 in cui voglio definire funzioni personalizzate.

Immagina che il file si chiami MyFunctions.ps1 e il contenuto sia il seguente:

Write-Host "Installing functions"
function A1
{
    Write-Host "A1 is running!"
}
Write-Host "Done"

Per eseguire questo script e teoricamente registrare la funzione A1, navigo nella cartella in cui risiede il file .ps1 ed eseguo il file:

.\MyFunctions.ps1

Questo produce:

Installing functions
Done

Tuttavia, quando provo a chiamare A1, ottengo semplicemente l'errore che indica che non esiste alcun comando / funzione con quel nome:

The term 'A1' is not recognized as the name of a cmdlet, function, script file, or operable program. Check the spelling
 of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:3
+ A1 <<<<
    + CategoryInfo          : ObjectNotFound: (A1:String) [], CommandNotFoundException
    + FullyQualifiedErrorId : CommandNotFoundException

Devo fraintendere alcuni concetti di PowerShell. Non posso definire le funzioni nei file di script?

Nota che ho già impostato la mia politica di esecuzione su "RemoteSigned". E so di eseguire file .ps1 usando un punto davanti al nome del file:. \ MyFile.ps1

Prova questo dalla riga di comando di PowerShell:

. .\MyFunctions.ps1
A1

L'operatore punto viene utilizzato per includere lo script.

Quello di cui stai parlando si chiama dot sourcing . Ed è malvagio. Ma non preoccuparti, c'è un modo migliore e più semplice per fare ciò che vuoi con i moduli (sembra molto più spaventoso di quello che è). Il vantaggio principale dell'utilizzo dei moduli è che è possibile scaricarli dalla shell, se necessario, e impedisce alle variabili nelle funzioni di insinuarsi nella shell (una volta puntato un file di funzioni, provare a chiamare una delle variabili da un funzione nella shell e vedrai cosa intendo).

Quindi, prima di tutto, rinomina il file .ps1 che contiene tutte le tue funzioni in MyFunctions.psm1 (hai appena creato un modulo!). Ora che un modulo si carichi correttamente, devi fare alcune cose specifiche con il file. Innanzitutto per Import-Module per vedere il modulo (si utilizza questo cmdlet per caricare il modulo nella shell), deve trovarsi in una posizione specifica. Il percorso predefinito per la cartella dei moduli è $ home \ Documents \ WindowsPowerShell \ Modules.

In quella cartella, crea una cartella denominata MyFunctions e inserisci il file MyFunctions.psm1 (il file del modulo deve risiedere in una cartella con esattamente lo stesso nome del file PSM1).

Una volta fatto ciò, apri PowerShell ed esegui questo comando:

Get-Module -listavailable

Se ne vedi uno chiamato MyFunctions, l'hai fatto bene e il tuo modulo è pronto per essere caricato (questo è solo per assicurarti che sia impostato correttamente, devi farlo solo una volta).

Per utilizzare il modulo, digitare quanto segue nella shell (o inserire questa riga nel proprio profilo $ oppure inserirla come prima riga in uno script):

Import-Module MyFunctions

Ora puoi eseguire le tue funzioni. La cosa bella di questo è che una volta che hai 10-15 funzioni lì dentro, dimenticherai il nome di una coppia. Se li hai in un modulo, puoi eseguire il comando seguente per ottenere un elenco di tutte le funzioni nel tuo modulo:

Get-Command -module MyFunctions

È piuttosto dolce, e il piccolo sforzo che ci vuole per allestire sul lato anteriore ne vale la pena.

. "$PSScriptRoot\MyFunctions.ps1" MyA1Func

Availalbe a partire dalla v3, prima che vedi Come posso ottenere il percorso del file system di uno script PowerShell? . È MOLTO comune.

PS Non sottoscrivo la regola "tutto è un modulo". I miei script sono utilizzati da altri sviluppatori di GIT, quindi non mi piace inserire elementi in un luogo specifico o modificare le variabili di ambiente di sistema prima che il mio script venga eseguito. È solo una sceneggiatura (o due o tre).

Puoi certamente definire le funzioni nei file di script (tendo a caricarle sul mio profilo Powershell al caricamento).

Innanzitutto è necessario verificare per assicurarsi che la funzione sia caricata eseguendo:

ls function:\ | where { $_.Name -eq "A1"  }

E controlla che appaia nell'elenco (dovrebbe essere un elenco di 1!), Quindi facci sapere quale output ottieni!

È possibile aggiungere la funzione a:

c:\Users\David\Documents\WindowsPowerShell\profile.ps1

Una funzione sarà disponibile.

Se il tuo file ha solo una funzione principale che desideri chiamare / esporre, puoi anche avviare il file con:

Param($Param1)

È quindi possibile chiamarlo ad esempio come segue:

.\MyFunctions.ps1 -Param1 'value1'

Questo lo rende molto più conveniente se si desidera chiamare facilmente solo quella funzione senza dover importare la funzione.

Supponendo di avere un file di modulo chiamato Dummy-Name.psm1 che ha un metodo chiamato Function-Dumb ()

Import-Module "Dummy-Name.psm1";
Get-Command -Module "Function-Dumb";
#
#
Function-Dumb;