Export-ModuleMember

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

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

描述
-----------
這個命令會匯出指令碼模組中定義的別名和函數。

若要匯出別名 (預設不會匯出)，您同時也必須明確指定函數，否則只會匯出別名。

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

描述
-----------
這個命令會匯出指令碼模組中定義的三個別名和三個函數。

您可以使用此命令格式指定模組成員的名稱。

C:\PS>Export-ModuleMember

描述
-----------
這個命令會指定不要匯出指令碼模組中定義的成員。

雖然這個命令可防止匯出模組成員，不過無法隱藏這些成員。使用者可以讀取並複製模組成員，或使用呼叫運算子 (&) 來叫用沒有匯出的模組成員。

C:\PS>Export-ModuleMember -variable increment

描述
-----------
這個命令只會從指令碼模組匯出 $increment 變數，而不會匯出其他成員。

除了匯出模組中的函數以外，如果您想要匯出變數，Export-ModuleMember 命令就必須包含所有函數的名稱以及變數的名稱。

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

描述
-----------
這些命令示範如何解譯指令碼模組 (.psm1) 檔案中的多個 Export-ModuleMember 命令。

這些命令會建立三個函數和一個別名，然後匯出其中兩個函數和該別名。

如果不使用 Export-ModuleMember 命令，則會匯出所有三個函數，但不會匯出別名。如果使用 Export-ModuleMember 命令，則只會匯出 Get-Test 和 Start-Test函數，以及 STT 別名。

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

描述
-----------
這個命令示範如何在透過以 New-Module Cmdlet 所建立的動態模組中使用 Export-ModuleMember。

在這個範例中，Export-ModuleMember 是用來匯出動態模組中的 "Hi" 別名和 "SayHello" 函數。

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

描述
-----------
這個範例會包含名為 Export 的函數，以便宣告函數或建立變數，然後寫入該函數或變數的 Export-ModuleMember 命令。這樣做可讓您在單一命令中宣告並匯出函數或變數。

若要使用 Export 函數，請在指令碼模組中加入此函數。若要匯出函數，請在 Function 關鍵字前面輸入 "Export"。

若要匯出變數，請使用下列格式來宣告變數並設定其值：

    export variable <變數名稱> <值>

此範例中的命令示範了正確的格式。在這個範例中，只會匯出 New-Test 函數和 $Interval 變數。