Export-PSSession

Export-PSSession [-Session] <PSSession> [-OutputModule] <string> [[-CommandName] <string[]>] [[-FormatTypeName] <string[]>] [-AllowClobber] [-ArgumentList <Object[]>] [-CommandType {<Alias> | <Function> | <Filter> | <Cmdlet> | <ExternalScript> | <Application> | <Script> | <All>}] [-Encoding <string>] [-Force] [-Module <string[]>] [<CommonParameters>]

C:\PS>$s = new-pssession -computerName Server01

C:\PS> export-pssession -session $s -outputModule Server01

설명
-----------
이 예의 명령은 현재 세션에 있는 명령과 이름이 같은 명령을 제외하고 Server01 컴퓨터의 PSSession에 있는 모든 명령을 로컬 컴퓨터의 Sever01 모듈로 내보냅니다. 또한 명령에 대한 형식 지정 데이터도 내보냅니다.   

첫 번째 명령은 Server01 컴퓨터에 PSSession을 만듭니다. 두 번째 명령은 세션의 명령과 형식 지정 데이터를 Server01 모듈로 내보냅니다.

C:\PS>$s = new-pssession -ConnectionUri http://exchange.microsoft.com/mailbox -credential exchangeadmin01@hotmail.com -authentication negotiate

C:\PS> export-pssession -session $r -module exch* -commandname get-*, set-* -formattypename * -outputModule $pshome\Modules\Exchange -encoding ASCII

설명
-----------
이들 명령은 원격 컴퓨터의 Microsoft Exchange Server 스냅인에서 Get 및 Set 명령을 로컬 컴퓨터의 $pshome\Modules 디렉터리에 있는 Exchange 모듈로 내보냅니다.

모듈을 $pshome\Module 디렉터리에 배치하면 컴퓨터의 모든 사용자가 액세스할 수 있게 됩니다.

C:\PS>$s = new-pssession -computerName Server01 -credential Server01\User01

C:\PS> export-pssession -session $s -outputModule TestCmdlets -type cmdlet -commandname *test* -formattypename *

C:\PS> remove-pssession $s

C:\PS> import-module TestCmdlets

C:\PS> get-help test*

C:\PS> test-files

설명
-----------
이들 명령은 원격 컴퓨터의 PSSession에서 cmdlet을 내보내서 로컬 컴퓨터의 모듈에 저장합니다. 그런 다음 해당 cmdlet을 모듈에서 현재 세션으로 추가하여 사용할 수 있도록 합니다.

첫 번째 명령은 Server01 컴퓨터에 PSSession을 만든 다음 $s 변수에 저장합니다.

두 번째 명령은 $s의 PSSession에서 이름이 "Test"로 시작하는 cmdlet을 로컬 컴퓨터의 TestCmdlets 모듈로 내보냅니다.

세 번째 명령은 Remove-PSSession cmdlet을 사용하여 $s에 있는 PSSession을 현재 세션에서 삭제합니다. 이 명령은 PSSession이 활성화되지 않아도 해당 PSSession에서 가져온 명령을 사용할 수 있음을 보여 줍니다.

언제 어떤 세션에서도 실행할 수 있는 네 번째 명령은 Import-Module cmdlet을 사용하여 TestCmdlets 모듈에 있는 cmdlet을 현재 세션에 추가합니다.

다섯 번째 명령은 Get-Help cmdlet을 사용하여 이름이 "Test"로 시작하는 cmdlet에 대한 도움말을 가져옵니다. 모듈의 명령이 현재 세션에 추가되면 세션의 다른 명령에 대해 사용하는 것과 마찬가지로 Get-Help 및 Get-Command cmdlet을 사용하여 가져온 명령에 대해 자세하게 알아볼 수 있습니다.

여섯 번째 명령은 Server01 컴퓨터에서 내보내서 세션에 추가된 Test-Files cmdlet을 사용합니다. 

명확히 구분되지는 않지만 Test-Files 명령은 실제로는 명령을 가져온 컴퓨터의 원격 세션에서 실행됩니다. Windows PowerShell은 모듈에 저장된 정보에서 세션을 만듭니다.

C:\PS>export-pssession -session $s -AllowClobber -outputModule AllCommands

설명
-----------
이 명령은 $s 변수의 PSSession에서 모든 명령과 모든 형식 지정 데이터를 현재 세션으로 내보냅니다. 이 명령은 AllowClobber 매개 변수를 사용하여 현재 세션의 명령과 동일한 이름의 명령을 포함합니다.

C:\PS>$options = New-PSSessionOption -NoMachineProfile

C:\PS> $s = new-pssession -computername Server01 -sessionoption $options

C:\PS> export-pssession -session $s -outputModule Server01

C:\PS> remove-pssession $s

C:\PS> new-pssession -computername Server01 -sessionoption $options

C:\PS> import-module Server01

설명
-----------
이 예에서는 명령을 내보낸 PSSession이 닫혀 있는 경우 특정 옵션을 사용하여 세션에서 내보낸 명령을 실행하는 방법을 보여 줍니다.

Export-PSSession을 사용하면 원래 PSSession에 대한 정보가 이 cmdlet이 만드는 모듈에 저장됩니다. 원래 원격 세션이 닫혀 있는 경우 모듈을 가져오면 해당 모듈은 원래 컴퓨터에 연결된 열려 있는 임의의 원격 세션을 사용합니다. 

현재 세션에 원래 컴퓨터에 대한 원격 세션이 포함되어 있지 않으면 모듈의 명령은 해당 컴퓨터에 대한 세션을 다시 설정합니다. 그러나 Export-PSSession은 New-PSSession의 SessionOption 매개 변수를 사용하여 설정한 옵션과 같이 특수한 옵션을 모듈에 저장하지 않습니다. 

따라서 특정 옵션을 사용하여 원격 세션에서 내보낸 명령을 실행하려면 모듈을 가져오기 전에 원하는 옵션을 사용하여 원격 세션을 만들어야 합니다.

첫 번째 명령은 New-PSSessionOption cmdlet을 사용하여 PSSessionOption 개체를 만들고 이 개체를 $options 변수에 저장합니다.

두 번째 명령은 지정한 옵션을 포함하는 PSSession을 만듭니다. 이 명령은 New-PSSession cmdlet을 사용하여 Server01 컴퓨터에서 PSSession을 만들고 SessionOption 매개 변수를 사용하여 $options의 옵션 개체를 전송합니다. 

세 번째 명령은 Export-PSSession cmdlet을 사용하여 $s의 PSSession에서 명령을 Server01 모듈로 내보냅니다.

네 번째 명령은 Remove-PSSession cmdlet을 사용하여 $s 변수에서 PSSession을 삭제합니다.

다섯 번째 명령은 New-PSSession cmdlet을 사용하여 Server01 컴퓨터에 연결된 새 PSSession을 만듭니다. 또한 이 PSSession은 $options 변수의 세션 옵션을 사용합니다.

여섯 번째 명령은 Import-Module cmdlet을 사용하여 Server01 모듈에서 명령을 가져옵니다. 이 모듈의 명령은 Server01 컴퓨터의 PSSession에서 실행됩니다.