Export-ModuleMember

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

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

Beschreibung
-----------
Dieser Befehl exportiert die im Skriptmodul definierten Aliase sowie die im Skriptmodul definierten Funktionen. 

Um die Aliase zu exportieren, die standardmäßig nicht exportiert werden, müssen Sie auch die Funktionen explizit angeben. Andernfalls werden nur die Aliase exportiert.

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

Beschreibung
-----------
Mit diesem Befehl werden drei Aliase und drei Funktionen exportiert, die im Skriptmodul definiert sind. 

Dieses Befehlsformat kann verwendet werden, um die Namen der Modulelemente anzugeben.

C:\PS>Export-ModuleMember

Beschreibung
-----------
Dieser Befehl gibt an, dass keine Elemente exportiert werden, die im Skriptmodul definiert sind.

Dieser Befehl verhindert, dass die Modulelemente exportiert werden, er blendet die Elemente jedoch nicht aus. Benutzer können Modulelemente lesen und kopieren oder den Aufrufoperator (&) verwenden, um nicht exportierte Modulelemente aufzurufen.

C:\PS>Export-ModuleMember -variable increment

Beschreibung
-----------
Mit diesem Befehl wird nur die Variable "$increment" aus dem Skriptmodul exportiert. Weitere Elemente werden nicht exportiert. 

Wenn Sie eine Variable zusätzlich zu den Funktionen in einem Modul exportieren möchten, muss der Befehl "Export-ModuleMember" die Namen aller Funktionen und den Namen der Variablen einschließen.

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

Beschreibung
-----------
Diese Befehle zeigen, wie mehrere Export-ModuleMember-Befehle in einer Skriptmoduldatei (".psm1") interpretiert werden.

Mit diesen Befehlen werden drei Funktionen und ein Alias erstellt, und zwei der Funktionen und der Alias werden exportiert.

Ohne die Export-ModuleMember-Befehle würden alle drei Funktionen exportiert, nicht jedoch der Alias. Mit den Export-ModuleMember-Befehlen werden nur die Funktion "Get-Test" und die Funktion "Start-Test" sowie der STT-Alias exportiert.

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

Beschreibung
-----------
Dieser Befehl zeigt, wie "Export-ModuleMember" in einem dynamischen Modul verwendet wird, das mit dem Cmdlet "New-Module" erstellt wird.

In diesem Beispiel werden der Alias "Hi" und die Funktion "SayHello" mit "Export-ModuleMember" im dynamischen Modul exportiert.

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

Beschreibung
-----------
Dieses Beispiel enthält eine Funktion mit dem Namen "Export", die eine Funktion deklariert oder eine Variable erstellt und dann einen Export-ModuleMember-Befehl für die Funktion oder die Variable schreibt. Auf diese Weise können Sie eine Funktion oder Variable in einem einzelnen Befehl deklarieren und exportieren.

Um die Export-Funktion zu verwenden, schließen Sie sie in das Skriptmodul ein. Um eine Funktion zu exportieren, geben Sie "Export" vor dem Function-Schlüsselwort ein. 

Um eine Variable zu exportieren, verwenden Sie das folgende Format zum Deklarieren der Variablen und zum Festlegen ihres Werts:

    export variable <Variablenname> <Wert>

Die Befehle im Beispiel verfügen über das richtige Format. In diesem Beispiel werden nur die Funktion "New-Test" und die Variable "$Interval" exportiert.