Export-ModuleMember
내보내는 모듈 멤버를 지정합니다.
구문
Export-ModuleMember
[[-Function] <String[]>]
[-Cmdlet <String[]>]
[-Variable <String[]>]
[-Alias <String[]>]
[<CommonParameters>]
Description
cmdlet은 Export-ModuleMember
스크립트 모듈(.psm1
) 파일 또는 cmdlet을 사용하여 만든 동적 모듈에서 내보낸 모듈 멤버를 New-Module
지정합니다. 모듈 멤버에는 cmdlet, 함수, 변수 및 별칭이 포함됩니다. 이 cmdlet은 스크립트 모듈 파일 또는 동적 모듈에서만 사용할 수 있습니다.
스크립트 모듈에 명령이 포함되어 Export-ModuleMember
있지 않으면 스크립트 모듈의 함수와 별칭이 내보내지만 변수는 내보내지지 않습니다. 스크립트 모듈에 명령이 포함된 Export-ModuleMember
경우 명령에 지정된 Export-ModuleMember
멤버만 내보냅니다. 스크립트 모듈이 다른 모듈에서 가져오는 멤버를 표시하지 않거나 내보내는 데 사용할 Export-ModuleMember
수도 있습니다.
Export-ModuleMember
명령은 선택 사항이지만 모범 사례입니다. 명령이 기본값을 확인하더라도 모듈 작성자의 의도를 보여 줍니다.
예제
예제 1: 스크립트 모듈에서 함수 및 별칭 내보내기
Export-ModuleMember -Function * -Alias *
이 명령은 스크립트 모듈에 정의된 모든 함수와 별칭을 내보냅니다.
예제 2: 특정 별칭 및 함수 내보내기
Export-ModuleMember -Function Get-Test, New-Test, Start-Test -Alias gtt, ntt, stt
이 명령은 스크립트 모듈에 정의된 별칭 3개와 함수 3개를 내보냅니다.
이 명령 형식을 사용하여 모듈 멤버의 이름을 지정할 수 있습니다.
예제 3: 멤버 내보내기 없음
Export-ModuleMember
이 명령은 스크립트 모듈에 정의된 멤버를 내보내지 않도록 지정합니다.
모듈 멤버를 내보내지 않도록 하지만 멤버를 숨기지는 않습니다.
사용자는 모듈 멤버를 읽고 복사하거나 호출 연산자(&
)를 사용하여 내보내지 않은 모듈 멤버를 호출할 수 있습니다.
예제 4: 특정 변수 내보내기
Export-ModuleMember -Variable increment
이 명령은 스크립트 모듈에서 $increment
변수만 내보냅니다.
다른 멤버는 내보내지 않습니다.
모듈 Export-ModuleMember
에서 함수를 내보내는 것 외에도 변수를 내보내려면 명령에는 모든 함수의 이름과 변수 이름이 포함되어야 합니다.
예제 5: 여러 내보내기 명령
# 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
이러한 명령은 스크립트 모듈(.psm1
) 파일에서 여러 Export-ModuleMember
명령이 해석되는 방법을 보여 줍니다.
이러한 명령은 세 개의 함수와 하나의 별칭을 만든 다음 두 개의 함수와 별칭을 내보냅니다.
명령이 Export-ModuleMember
없으면 세 가지 함수와 별칭을 모두 내보냅니다. 명령을 사용하면 Export-ModuleMember
함수와 Start-Test
STT
별칭만 New-Test
내보냅니다.
예제 6: 동적 모듈에서 멤버 내보내기
New-Module -Script {function SayHello {"Hello!"}; Set-Alias Hi SayHello; Export-ModuleMember -Alias Hi -Function SayHello}
이 명령은 cmdlet을 Export-ModuleMember
사용하여 만든 동적 모듈에서 New-Module
사용하는 방법을 보여줍니다.
이 예제에서는 Export-ModuleMember
동적 모듈에서 Hi
별칭과 함수를 SayHello
모두 내보내는 데 사용됩니다.
매개 변수
-Alias
스크립트 모듈 파일에서 내보낼 별칭을 지정합니다. 별칭 이름을 입력합니다. 와일드카드 문자를 사용할 수 있습니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-Cmdlet
스크립트 모듈 파일에서 내보내는 cmdlet을 지정합니다. cmdlet 이름을 입력합니다. 와일드카드 문자를 사용할 수 있습니다.
스크립트 모듈 파일에서 cmdlet을 만들 수는 없지만 이진 모듈의 cmdlet을 스크립트 모듈로 가져온 다음 스크립트 모듈에서 다시 내보낼 수 있습니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-Function
스크립트 모듈 파일에서 내보내는 함수를 지정합니다. 함수 이름을 입력합니다.
와일드카드 문자를 사용할 수 있습니다. 함수 이름 문자열을 .에 파이프할 Export-ModuleMember
수도 있습니다.
형식: | String[] |
Position: | 0 |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
-Variable
스크립트 모듈 파일에서 내보내는 변수를 지정합니다. 달러 기호($
)가 없는 변수 이름을 입력합니다. 와일드카드 문자를 사용할 수 있습니다.
형식: | String[] |
Position: | Named |
Default value: | None |
필수: | False |
파이프라인 입력 허용: | True |
와일드카드 문자 허용: | True |
입력
함수 이름 문자열을 이 cmdlet으로 파이프할 수 있습니다.
출력
None
이 cmdlet은 출력을 반환하지 않습니다.
참고
- 내보낸 멤버 목록에서 멤버를 제외하려면 다른 모든 멤버를
Export-ModuleMember
나열하지만 제외하려는 멤버를 생략하는 명령을 추가합니다.
관련 링크
PowerShell