O PowerShell é uma ferramenta poderosa no ambiente Windows, permitindo a automação de diversas tarefas administrativas e de gerenciamento. Um dos conceitos fundamentais ao criar módulos no PowerShell é a definição de quais funções, variáveis e aliases devem ser exportados e tornados disponíveis para os usuários do módulo. Para isso, usamos o cmdlet Export-ModuleMember.

O que é o Export-ModuleMember?

Export-ModuleMember é um cmdlet do PowerShell usado dentro de módulos para especificar quais funções, variáveis e aliases devem ser exportados e disponibilizados para quem utilizar o módulo. Isso é essencial para controlar a interface pública do módulo e esconder detalhes de implementação que não precisam ser expostos.

Como usar o Export-ModuleMember

Vamos criar um exemplo prático para ilustrar como usar o Export-ModuleMember.

Passo 1: Criação do Módulo

Primeiro, criaremos um módulo simples. Um módulo no PowerShell é basicamente um arquivo com extensão .psm1. Vamos criar um arquivo chamado MyModule.psm1.

# MyModule.psm1

function Get-Greeting {
    param (
        [string]$Name
    )
    return "Hello, $Name!"
}

function Get-Farewell {
    param (
        [string]$Name
    )
    return "Goodbye, $Name!"
}

# Exportando apenas a função Get-Greeting
Export-ModuleMember -Function Get-Greeting

Neste exemplo, temos duas funções: Get-Greeting e Get-Farewell. No entanto, estamos exportando apenas a função Get-Greeting usando Export-ModuleMember.

Passo 2: Importando e Usando o Módulo

Agora, vamos importar e usar o módulo que criamos.

# Importando o módulo
Import-Module -Name .\MyModule.psm1

# Usando a função exportada
Get-Greeting -Name "John"

Ao executar o comando acima, você verá a saída Hello, John!. Note que a função Get-Farewell não está disponível, pois não foi exportada.

Exportando Variáveis e Aliases

Além de funções, você também pode exportar variáveis e aliases. Vamos adicionar uma variável e um alias ao nosso módulo.

# MyModule.psm1

function Get-Greeting {
    param (
        [string]$Name
    )
    return "Hello, $Name!"
}

function Get-Farewell {
    param (
        [string]$Name
    )
    return "Goodbye, $Name!"
}

# Variável a ser exportada
$GreetingMessage = "Welcome to PowerShell!"

# Alias a ser exportado
Set-Alias -Name gg -Value Get-Greeting

# Exportando funções, variáveis e aliases
Export-ModuleMember -Function Get-Greeting -Variable GreetingMessage -Alias gg

Agora, ao importar o módulo, você pode acessar a variável $GreetingMessage e usar o alias gg.

# Importando o módulo
Import-Module -Name .\MyModule.psm1

# Usando a função exportada
Get-Greeting -Name "John"

# Acessando a variável exportada
Write-Output $GreetingMessage

# Usando o alias exportado
gg -Name "Jane"

Conclusão

O cmdlet Export-ModuleMember é uma ferramenta essencial para a criação de módulos no PowerShell, permitindo que você controle quais componentes do módulo são expostos e quais permanecem internos. Isso ajuda a manter a modularidade e a segurança do seu código, expondo apenas o necessário para os usuários do módulo.