This is the built-in help made by Microsoft for the command 'Export-ModuleMember', in PowerShell version 2 - as retrieved from
Windows version 'Microsoft® Windows Vista™ Ultimate ' PowerShell help files on 2016-06-23.
For PowerShell version 3 and up, where you have Update-Help, this command was run just before creating the web pages from the help files.
Specifies the module members that are exported.
Export-ModuleMember [[-Function] <string[]>] [-Alias <string[]>] [-Cmdlet <string[]>] [-Variable <string[]>] [<CommonParameters>]
The Export-ModuleMember cmdlet specifies the module members (such as cmdlets, functions, variables, and aliases) that are exported from a script
module (.psm1) file, or from a dynamic module created by using the New-Module cmdlet. This cmdlet can be used only in a script module file or a d
ynamic module.
If a script module does not include an Export-ModuleMember command, the functions in the script module are exported, but the variables and aliase
s are not. When a script module includes an Export-ModuleMember command, only the members specified in the Export-ModuleMember command are export
ed.
If a script module contains multiple Export-ModuleMember commands, only the members listed in an Export-ModuleMember command are exported.
You can also use Export-ModuleMember to export members that the script module imports from other modules.
<
Online version: http://go.microsoft.com/fwlink/?LinkID=141551
Import-Module
Get-Module
Remove-Module
about_Modules
<
-------------------------- EXAMPLE 1 --------------------------
C:\PS>Export-ModuleMember -function * -alias *
Description
-----------
This command exports the aliases defined in the script module, along with the functions defined in the script module.
To export the aliases, which are not exported by default, you must also explicitly specify the functions. Otherwise, only the aliases will be exp
orted.
-------------------------- EXAMPLE 2 --------------------------
C:\PS>Export-ModuleMember -function Get-Test, New-Test, Start-Test -alias gtt, ntt, stt
Description
-----------
This command exports three aliases and three functions defined in the script module.
You can use this command format to specify the names of module members.
-------------------------- EXAMPLE 3 --------------------------
C:\PS>Export-ModuleMember
Description
-----------
This command specifies that no members defined in the script module are exported.
This command prevents the module members from being exported, but it does not hide the members. Users can read and copy module members or use the
call operator (&) to invoke module members that are not exported.
-------------------------- EXAMPLE 4 --------------------------
C:\PS>Export-ModuleMember -variable increment
Description
-----------
This command exports only the $increment variable from the script module. No other members are exported.
If you want to export a variable, in addition to exporting the functions in a module, the Export-ModuleMember command must include the names of a
ll of the functions and the name of the variable.
-------------------------- EXAMPLE 5 --------------------------
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
Description
-----------
These commands show how multiple Export-ModuleMember commands are interpreted in a script module (.psm1) file.
These commands create three functions and one alias, and then they export two of the functions and the alias.
Without the Export-ModuleMember commands, all three of the functions would be exported, but the alias would not be exported. With the Export-Modu
leMember commands, only the Get-Test and Start-Test functions and the STT alias are exported.
-------------------------- EXAMPLE 6 --------------------------
C:\PS>new-module -script {function SayHello {"Hello!"}; set-alias Hi SayHello; Export-ModuleMember -alias Hi -function SayHello}
Description
-----------
This command shows how to use Export-ModuleMember in a dynamic module that is created by using the New-Module cmdlet.
In this example, Export-ModuleMember is used to export both the "Hi" alias and the "SayHello" function in the dynamic module.
-------------------------- EXAMPLE 7 --------------------------
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
Description
-----------
This example includes a function named Export that declares a function or creates a variable, and then writes an Export-ModuleMember command for
the function or variable. This lets you declare and export a function or variable in a single command.
To use the Export function, include it in your script module. To export a function, type "Export" before the Function keyword.
To export a variable, use the following format to declare the variable and set its value:
export variable <variable-name> <value>
The commands in the example show the correct format. In this example, only the New-Test function and the $Interval variable are exported.