Export-ModuleMember

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

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

Description
-----------
Cette commande exporte les alias ainsi que les fonctions définis dans le module de script. 

Pour exporter les alias qui ne sont pas exportés par défaut, vous devez également spécifier explicitement les fonctions. Sinon, seuls les alias seront exportés.

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

Description
-----------
Cette commande exporte trois alias et trois fonctions définis dans le module de script. 

Vous pouvez utiliser ce format de commande pour spécifier les noms des modules de membre.

C:\PS>Export-ModuleMember

Description
-----------
Cette commande spécifie qu'aucun membre défini dans le module de script n'est exporté.

Cette commande empêche l'exportation des membres de module, mais ne masque pas les membres. Les utilisateurs peuvent lire et copier des membres de module ou employer l'opérateur d'appel (&) pour appeler des membres de module qui ne sont pas exportés.

C:\PS>Export-ModuleMember -variable increment

Description
-----------
Cette commande exporte uniquement la variable $increment du module de script. Aucun autre membre n'est exporté. 

Si vous souhaitez exporter une variable, en plus des fonctions d'un module, la commande Export-ModuleMember doit inclure les noms de toutes les fonctions et le nom de la variable.

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

Description
-----------
Ces commandes montrent comment plusieurs commandes Export-ModuleMember sont interprétées dans un fichier de module de script (.psm1).

Ces commandes créent trois fonctions et un alias, puis elles exportent deux des fonctions et l'alias.

Sans les commandes Export-ModuleMember, les trois fonctions seraient exportées, mais pas l'alias. Avec les commandes Export-ModuleMember, seules les fonctions Get-Test et Start-Test et l'alias de technologie STT sont exportés.

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

Description
-----------
Cette commande montre comment utiliser Export-ModuleMember dans un module dynamique créé à l'aide de l'applet de commande New-Module.

Dans cet exemple, Export-ModuleMember est utilisé pour exporter à la fois l'alias « Hi » alias et la fonction « SayHello » dans le module dynamique.

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

Description
-----------
Cet exemple inclut une fonction nommée Export qui déclare une fonction ou crée une variable, puis écrit une commande Export-ModuleMember pour la fonction ou la variable. Vous pouvez ainsi déclarer et exporter une fonction ou une variable au moyen d'une seule commande.

Pour utiliser la fonction Export, incluez-la dans votre module de script. Pour exporter une fonction, tapez « Export » avant le mot clé Function. 

Pour exporter une variable, utilisez le format suivant afin de la déclarer et de définir sa valeur :

    export variable <nom-variable> <valeur>

Les commandes utilisées dans l'exemple illustrent le format correct. Dans cet exemple, seules la fonction New-Test et la variable $Interval sont exportées.