다음을 통해 공유


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

입력

String

함수 이름 문자열을 이 cmdlet으로 파이프할 수 있습니다.

출력

None

이 cmdlet은 출력을 반환하지 않습니다.

참고

  • 내보낸 멤버 목록에서 멤버를 제외하려면 다른 모든 멤버를 Export-ModuleMember 나열하지만 제외하려는 멤버를 생략하는 명령을 추가합니다.