Export-ModuleMember

  • Referência
Módulo:
Microsoft.PowerShell.Core

Especifica os membros do módulo que são exportados.

Syntax

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

Description

O Export-ModuleMember cmdlet especifica os membros do módulo que são exportados de um arquivo de módulo de script (.psm1) ou de um módulo dinâmico criado usando o New-Module cmdlet. Os membros do módulo incluem cmdlets, funções, variáveis e aliases. Esse cmdlet pode ser usado somente em um arquivo de módulo de script ou um módulo dinâmico.

Se um módulo de script não incluir um Export-ModuleMember comando, as funções e aliases no módulo de script serão exportados, mas as variáveis não. Quando um módulo de script inclui Export-ModuleMember comandos, somente os membros especificados nos Export-ModuleMember comandos são exportados. Você também pode usar Export-ModuleMember para suprimir ou exportar membros que o módulo de script importa de outros módulos.

Um Export-ModuleMember comando é opcional, mas é uma prática recomendada. Mesmo que o comando confirme os valores padrão, ele demonstra a intenção do autor do módulo.

Exemplos

Exemplo 1: Exportar funções e aliases em um módulo de script

Export-ModuleMember -Function * -Alias *

Esse comando exporta todas as funções e aliases definidos no módulo de script.

Exemplo 2: Exportar aliases e funções específicas

Export-ModuleMember -Function Get-Test, New-Test, Start-Test -Alias gtt, ntt, stt

Este 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 dos membros do módulo.

Exemplo 3: Exportar sem membros

Export-ModuleMember

Este comando especifica que nenhum membro definido no módulo de script é exportado.

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

Exemplo 4: Exportar uma variável específica

Export-ModuleMember -Variable increment

Esse comando exporta somente a $increment variável do módulo de script. Nenhum outro membro é exportado.

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

Exemplo 5: Vários comandos de exportação

# From TestModule.psm1
function New-Test
{
    Write-Output 'I am New-Test function'
}
Export-ModuleMember -Function New-Test

function Validate-Test
{
    Write-Output 'I am Validate-Test function'
}
function Start-Test
{
    Write-Output 'I am Start-Test function'
}
Set-Alias stt Start-Test
Export-ModuleMember -Function Start-Test -Alias stt

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

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

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

Exemplo 6: Exportar membros em um módulo dinâmico

New-Module -Script {function SayHello {"Hello!"}; Set-Alias Hi SayHello; Export-ModuleMember -Alias Hi -Function SayHello}

Este comando mostra como usar Export-ModuleMember em um módulo dinâmico que é criado usando o New-Module cmdlet.

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

Parâmetros

-Alias

Especifica os aliases exportados por meio do arquivo do módulo de script. Digite os nomes de alias. Caracteres curinga são permitidos.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Cmdlet

Especifica os cmdlets exportados por meio do arquivo do módulo de script. Digite os nomes de cmdlet. Caracteres curinga são permitidos.

Não é possível criar cmdlets em um arquivo do módulo de script, mas você pode importar cmdlets de um módulo binário em um módulo de script e exportá-los novamente do módulo de script.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Function

Especifica as funções exportadas por meio do arquivo do módulo de script. Digite os nomes de função. Caracteres curinga são permitidos. Você também pode canalizar cadeias de caracteres de nome de função para Export-ModuleMember.

Type:String[]
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

-Variable

Especifica as variáveis exportadas por meio do arquivo do módulo de script. Insira os nomes das variáveis, sem um caractere de cifrão ($). Caracteres curinga são permitidos.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:True

Entradas

String

Você pode canalizar cadeias de caracteres de nome de função para esse cmdlet.

Saídas

None

Esse cmdlet não retorna nenhuma saída.

Observações

  • Para excluir um membro da lista de membros exportados, adicione um Export-ModuleMember comando que liste todos os outros membros, mas omita o membro que você deseja excluir.