Export-ModuleMember

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

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

Descrição
-----------
Esse comando exporta os aliases definidos no módulo de script, juntamente com as funções definidas no módulo de script. 

Para exportar os aliases, que não são exportados por padrão, você precisa especificar também as funções explicitamente. Caso contrário, somente os aliases serão exportados.

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

Descrição
-----------
Esse comando exporta três aliases e três funções definidas no módulo de script. 

Você pode usar esse formato de comando para especificar os nomes de membros do módulo.

C:\PS>Export-ModuleMember

Descrição
-----------
Esse comando especifica que nenhum membro definido no módulo de script é exportado.

Ele impede que os membros do módulo sejam exportados, mas não os oculta. Os usuários podem ler e copiar elementos do módulo, ou usar o operador de chamada (&) para invocar membros do módulo que não são exportados.

C:\PS>Export-ModuleMember -variable increment

Descrição
-----------
Esse comando exporta apenas a variável $increment do módulo de script. Nenhum outro membro é exportado. 

Se você desejar exportar uma variável, além de exportar as funções em um módulo, o comando Export-ModuleMember deverá incluir os nomes de todas as funções e o nome da variável.

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

Descrição
-----------
Esses comandos mostram como vários comandos Export-ModuleMember são interpretados em um arquivo de módulo de script (.psm1).

Esses comandos criam três funções e um alias e, em seguida, exportam duas das funções e o alias.

Sem os comandos Export-ModuleMember, todas as três funções seriam exportadas, mas não o alias. Com os comandos Export-ModuleMember, somente as funções Get-Test e Start-Test e o alias STT são exportados.

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

Descrição
-----------
Esse comando mostra como usar o Export-ModuleMember em um módulo dinâmico criado com o uso do cmdlet New-Module.

Nesse exemplo, Export-ModuleMember é usado para exportar o alias "Hi" e a função "SayHello" no módulo dinâmico.

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

Descrição
-----------
Este exemplo inclui uma função denominada Export que declara uma função ou cria uma variável e, em seguida, escreve um comando Export-ModuleMember para a função ou variável. Isso permite que você declare e exporte uma função ou uma variável em um único comando.

Para usar a função Export, inclua-a no seu módulo de script. Para exportar uma função, digite "Export" antes da palavra-chave Function. 

Para exportar uma variável, use o seguinte formato para declarar a variável e definir seu valor:

    export variable <nome-da-variável> <valor>

Os comandos no exemplo mostram o formato correto. Neste exemplo, somente a função New-Test e a variável Interval são exportadas.