Export-Console
현재 세션의 스냅인 이름을 콘솔 파일로 내보냅니다.
구문
Export-Console [[-Path] <string>] [-Force] [-NoClobber] [-Confirm] [-WhatIf] [<CommonParameters>]
설명
Export-Console cmdlet은 현재 세션의 Windows PowerShell 스냅인 이름을 Windows PowerShell 콘솔 파일(.psc1)로 내보냅니다. 이 cmdlet을 사용하여 이후의 세션에서 사용하기 위해 스냅인을 저장할 수 있습니다.
.psc1 콘솔 파일의 스냅인을 세션에 추가하려면 Cmd.exe 또는 다른 Windows PowerShell 세션을 사용하여 명령줄에서 Windows PowerShell(Powershell.exe)을 시작하고 Powershell.exe의 PSConsoleFile 매개 변수를 사용하여 콘솔 파일을 지정합니다.
Windows PowerShell 스냅인에 대한 자세한 내용은 about_PSSnapins를 참조하십시오.
매개 변수
-Force
파일 특성이 읽기 전용인 경우에도 경고 없이 콘솔 파일의 데이터를 덮어씁니다. 명령이 완료되면 읽기 전용 특성이 변경되고 다시 설정되지 않습니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-NoClobber
기존 콘솔 파일을 덮어쓰지 않습니다. 즉, 파일 내용을 바꾸지 않습니다. 파일이 지정된 경로에 있는 경우 Export-Console은 기본적으로 경고 없이 파일을 덮어씁니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-Path <string>
콘솔 파일(*.psc1)의 경로 및 파일 이름을 지정합니다. 경로(선택 사항)와 이름을 입력하십시오. 와일드카드는 사용할 수 없습니다.
파일 이름만 입력한 경우 Export-Console은 파일 이름 확장명이 ".psc1"이고 사용자가 입력한 이름을 가진 파일을 현재 디렉터리에 만듭니다.
PSConsoleFile 매개 변수를 사용하여 Windows PowerShell을 열었거나 현재 세션 중에 콘솔 파일을 내보내지 않았으면 이 매개 변수가 필요합니다. 또한 NoClobber 매개 변수를 사용하여 현재 콘솔 파일의 덮어쓰기를 방지한 경우에도 필수입니다.
이 매개 변수를 생략할 경우 Export-Console은 현재 세션에서 가장 최근에 사용된 콘솔 파일을 덮어씁니다. 즉, 콘솔 파일의 내용을 바꿉니다. 가장 최근에 사용된 콘솔 파일의 경로는 $ConsoleFileName 자동 변수 값에 저장됩니다. 자세한 내용은 about_Automatic_Variables를 참조하십시오.
필수 여부 |
false |
위치 |
1 |
기본값 |
|
파이프라인 입력 적용 여부 |
true (ByValue, ByPropertyName) |
와일드카드 문자 적용 여부 |
false |
-Confirm
명령을 실행하기 전에 확인 메시지를 표시합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
-WhatIf
명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.
필수 여부 |
false |
위치 |
named |
기본값 |
|
파이프라인 입력 적용 여부 |
false |
와일드카드 문자 적용 여부 |
false |
<CommonParameters>
이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_commonparameters.
입력 및 출력
입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.
입력 |
System.String 경로 문자열을 Export-Console로 파이프할 수 있습니다. |
출력 |
System.IO.FileInfo Export-Console은 내보낸 별칭이 포함된 파일을 만듭니다. |
참고
콘솔 파일(.psc1)을 사용하여 세션을 시작하는 경우 콘솔 파일의 이름이 $ConsoleFileName 자동 변수에 자동으로 저장됩니다. $ConsoleFileName의 값은 Export-Console의 Path 매개 변수를 사용하여 새 콘솔 파일을 지정할 때 업데이트됩니다. 콘솔 파일을 사용하지 않으면 $ConsoleFileName에 값이 없습니다($null).
Windows PowerShell 콘솔 파일을 새 세션에서 사용하려면 다음 구문을 사용하여 Windows PowerShell을 시작하십시오.
"powershell.exe -PsConsoleFile <ConsoleFile>.psc1"
Add-PSSnapin 명령을 Windows PowerShell 프로필에 추가하여 이후 세션을 위해 Windows PowerShell 스냅인을 저장할 수도 있습니다. 자세한 내용은 about_Profiles를 참조하십시오.
예 1
C:\PS>export-console -path $pshome\Consoles\ConsoleS1.psc1
설명
-----------
이 명령은 현재 세션의 Windows PowerShell 스냅인 이름을 Windows PowerShell 설치 디렉터리 $pshome의 Consoles 하위 디렉터리에 있는 ConsoleS1.psc1 파일로 내보냅니다.
예 2
C:\PS>export-console
설명
-----------
이 명령은 현재 세션의 Windows PowerShell 스냅인 이름을 현재 세션에서 가장 최근에 사용된 Windows PowerShell 콘솔 파일로 내보냅니다. 또한 이전 파일 내용을 덮어씁니다.
현재 세션 중에 콘솔 파일을 내보내지 않은 경우 작업을 계속할 권한과 파일 이름을 확인하는 메시지가 차례로 표시됩니다.
예 3
C:\PS>add-pssnapin NewPSSnapin
C:\PS> export-console -path NewPSSnapinConsole.psc1
C:\PS> powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1
설명
-----------
이들 명령은 NewPSSnapin Windows PowerShell 스냅인을 현재 세션에 추가하고 현재 세션의 Windows PowerShell 스냅인 이름을 콘솔 파일로 내보낸 다음 이 파일을 사용하여 Windows PowerShell 세션을 시작합니다.
첫 번째 명령은 Add-PSSnapin cmdlet을 사용하여 NewPSSnapin 스냅인을 현재 세션에 추가합니다. 해당 시스템에 등록된 Windows PowerShell 스냅인만 추가할 수 있습니다.
두 번째 명령은 Windows PowerShell 스냅인 이름을 NewPSSnapinConsole.psc1 파일로 내보냅니다.
세 번째 명령은 NewPSSnapinConsole.psc1 파일을 사용하여 Windows PowerShell을 시작합니다. 콘솔 파일에 Windows PowerShell 스냅인 이름이 포함되기 때문에 현재 세션에서 스냅인의 공급자 및 cmdlet을 사용할 수 있습니다.
예 4
C:\PS>export-console -path Console01
C:\PS> notepad console01.psc1
<?xml version="1.0" encoding="utf-8"?>
<PSConsoleFile ConsoleSchemaVersion="1.0">
<PSVersion>2.0</PSVersion>
<PSSnapIns>
<PSSnapIn Name="NewPSSnapin" />
</PSSnapIns>
</PSConsoleFile>
설명
-----------
이 명령은 현재 세션의 Windows PowerShell 스냅인 이름을 현재 디렉터리의 Console01.psc1 파일로 내보냅니다.
두 번째 명령은 Console01.psc1 파일의 내용을 메모장에 표시합니다.
예 5
C:\PS>powershell.exe -PSConsoleFile Console01.psc1
C:\PS> add-pssnapin MySnapin
C:\PS> export-console NewConsole.psc1
C:\PS> $consolefilename
C:\PS> add-pssnapin SnapIn03
C:\PS> export-console
설명
-----------
이 예에서는 $ConsoleFileName 자동 변수를 사용하여 Path 매개 변수 값 없이 Export-Console을 사용하는 경우 업데이트되는 콘솔 파일을 확인하는 방법을 보여 줍니다.
첫 번째 명령은 PowerShell.exe의 PSConsoleFile 매개 변수를 사용하여 Console01.psc1 파일을 통해 Windows PowerShell을 엽니다.
두 번째 명령은 Add-PSSnapin cmdlet을 사용하여 MySnapin Windows PowerShell 스냅인을 현재 세션에 추가합니다.
세 번째 명령은 Export-Console cmdlet을 사용하여 세션의 모든 Windows PowerShell 스냅인 이름을 NewConsole.psc1 파일로 내보냅니다.
네 번째 명령은 $ConsoleFileName 매개 변수를 사용하여 가장 최근에 사용된 콘솔 파일을 표시합니다. 샘플 출력에는 NewConsole.ps1이 가장 최근에 사용된 파일로 표시됩니다.
다섯 번째 명령은 SnapIn03을 현재 콘솔에 추가합니다.
여섯 번째 명령은 Path 매개 변수 없이 ExportConsole cmdlet을 사용합니다. 이 명령은 현재 세션의 모든 Windows PowerShell 스냅인 이름을 가장 최근에 사용된 파일인 NewConsole.psc1로 내보냅니다.