Export-ModuleMember

Export-ModuleMember [[-Function] <string[]>] [-Alias <string[]>] [-Cmdlet <string[]>] [-Variable <string[]>] [<CommonParameters>]

C:\PS>Export-ModuleMember -function * -alias *

Descrizione
-----------
Tramite questo comando vengono esportati gli alias definiti nel modulo di script, insieme alle funzioni definite nello stesso modulo. 

Per esportare gli alias, operazione non eseguita per impostazione predefinita, è anche necessario specificare le funzioni in modo esplicito. In caso contrario, verranno esportati solo gli alias.

C:\PS>Export-ModuleMember -function Get-Test, New-Test, Start-Test -alias gtt, ntt, stt

Descrizione
-----------
Tramite questo comando vengono esportati tre alias e tre funzioni definite nel modulo di script. 

È possibile utilizzare questo formato di comando per specificare i nomi dei membri di modulo.

C:\PS>Export-ModuleMember

Descrizione
-----------
Questo comando specifica che non viene esportato alcun membro definito nel modulo di script.

Questo comando impedisce l'esportazione dei membri di modulo, ma non nasconde i membri. Gli utenti possono leggere e copiare i membri di modulo o utilizzare l'operatore di chiamata (&) per richiamare i membri di modulo che non vengono esportati.

C:\PS>Export-ModuleMember -variable increment

Descrizione
-----------
Tramite questo comando viene esportata solo la variabile $increment dal modulo di script. Non viene esportato nessun altro membro. 

Se si desidera esportare una variabile, oltre all'esportazione delle funzioni in un modulo, il comando Export-ModuleMember deve includere i nomi di tutte le funzioni e il nome della variabile.

C:\PS># From TestModule.psm1

function new-test 
    { <function code> }
export-modulemember -function new-test

function validate-test 
    { <function code> }

function start-test 
    { <function code> }
set-alias stt start-test
export-modulemember -function *-test -alias stt

Descrizione
-----------
Tramite questi comandi viene illustrato come vengono interpretati più comandi Export-ModuleMember in un file modulo di script (.psm1).

Vengono create tre funzioni e un alias, quindi vengono esportate due delle funzioni e l'alias.

Senza i comandi Export-ModuleMember, verrebbero esportate le tre funzioni, ma non l'alias. Con i comandi Export-ModuleMember, vengono esportate solo le funzioni Get-Test e Start-Test e l'alias STT.

C:\PS>new-module -script {function SayHello {"Hello!"}; set-alias Hi SayHello; Export-ModuleMember -alias Hi -function SayHello}

Descrizione
-----------
Tramite questo comando viene illustrato come utilizzare Export-ModuleMember in un modulo dinamico creato tramite il cmdlet New-Module.

In questo esempio, Export-ModuleMember viene utilizzato per esportare l'alias "Ciao" e la funzione "BuonGiorno" nel modulo dinamico.

C:\PS>function export
{
    param (
        [parameter(mandatory=$true)] [validateset("function","variable")] $type,
        [parameter(mandatory=$true)] $name,
        [parameter(mandatory=$true)] $value
    )
    if ($type -eq "function")
    {
        Set-item "function:script:$name" $value
        Export-ModuleMember $name
    }
    else
    {
        Set-Variable -scope Script $name $value
        Export-ModuleMember -variable $name
    }
} 

export function New-Test 
{
  ...
}


function helper
{
  ...
}

export variable interval 0
$interval = 2

Descrizione
-----------
Questo esempio include una funzione denominata Export che dichiara una funzione o crea una variabile e scrive un comando Export-ModuleMember per la funzione o la variabile. Ciò consente di dichiarare ed esportare una funzione o una variabile in un singolo comando.

Per utilizzare la funzione Export, includerla nel modulo di script. Per esportare una funzione, digitare "Export" prima della parola chiave Function. 

Per esportare una variabile, utilizzare il formato seguente per dichiarare la variabile e impostarne il valore:

    export variable <nome-variabile> <valore>

I comandi dell'esempio presentano il formato corretto. In questo esempio, vengono esportate solo la funzione New-Test e la variabile $Interval.