Export-Console

  • 참조
모듈:
Microsoft.PowerShell.Core

현재 세션의 스냅인 이름을 콘솔 파일로 내보냅니다.

Syntax

Export-Console
      [[-Path] <String>]
      [-Force]
      [-NoClobber]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Export-Console 현재 세션의 Windows PowerShell 스냅인 이름을 Windows PowerShell 콘솔 파일(.psc1)로 내보냅니다. 이 cmdlet을 사용하여 이후의 세션에서 사용하기 위해 스냅인을 저장할 수 있습니다.

.psc1 콘솔 파일의 스냅인을 세션에 추가하려면 Cmd.exe 또는 다른 Windows PowerShell 세션을 사용하여 명령줄에서 Windows PowerShell(PowerShell.exe)을 시작한 다음 PowerShell.exe PSConsoleFile 매개 변수를 사용하여 콘솔 파일을 지정합니다.

Windows PowerShell 스냅인에 대한 자세한 내용은 about_PSSnapins 참조하세요.

예제

예제 1: 현재 세션에서 스냅인의 이름 내보내기

PS C:\> Export-Console -Path $pshome\Consoles\ConsoleS1.psc1

이 명령은 현재 세션 ConsoleS1.psc1 의 Windows PowerShell 스냅인 이름을 Windows PowerShell 설치 폴더의 Consoles 폴더에 있는 파일로 내보 $pshome냅니다.

예제 2: 스냅인 이름을 최신 콘솔 파일로 내보내기

Export-Console

이 명령은 현재 세션에서 현재 세션에서 가장 최근에 사용된 Windows PowerShell 콘솔 파일로 Windows PowerShell 스냅인의 이름을 내보냅니다. 또한 이전 파일 내용을 덮어씁니다.

현재 세션 중에 콘솔 파일을 내보내지 않은 경우 계속할 수 있는 권한을 묻는 메시지가 표시되고 파일 이름을 묻는 메시지가 표시됩니다.

예제 3: 스냅인 추가 및 스냅인 이름 내보내기

Add-PSSnapin NewPSSnapin
Export-Console -path NewPSSnapinConsole.psc1
powershell.exe -PsConsoleFile NewPsSnapinConsole.psc1

이러한 명령은 NewPSSnapin Windows PowerShell 스냅인을 현재 세션에 추가하고, 현재 세션의 Windows PowerShell 스냅인 이름을 콘솔 파일로 내보낸 다음, 콘솔 파일로 Windows PowerShell 세션을 시작합니다.

첫 번째 명령은 cmdlet을 Add-PSSnapin 사용하여 현재 세션에 NewPSSnapin 스냅인을 추가합니다. 해당 시스템에 등록된 Windows PowerShell 스냅인만 추가할 수 있습니다.

두 번째 명령은 Windows PowerShell 스냅인 이름을 파일로 내보 NewPSSnapinConsole.psc1 냅니다.

세 번째 명령은 파일로 Windows PowerShell을 시작합니다 NewPSSnapinConsole.psc1 . 콘솔 파일에 Windows PowerShell 스냅인 이름이 포함되어 있으므로 스냅인의 cmdlet 및 공급자는 현재 세션에서 사용할 수 있습니다.

예제 4: 스냅인의 이름을 지정된 위치로 내보내기

PS C:\> export-console -path Console01
PS C:\> 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: 업데이트할 콘솔 파일 확인

powershell.exe -PSConsoleFile Console01.psc1
Add-PSSnapin MySnapin
Export-Console NewConsole.psc1
$ConsoleFileName
Add-PSSnapin SnapIn03
Export-Console

이 예제에서는 자동 변수를 $ConsoleFileName 사용하여 Path 매개 변수 값 없이 사용하는 Export-Console 경우 업데이트될 콘솔 파일을 확인하는 방법을 보여 있습니다.

첫 번째 명령은 PowerShell.exe PSConsoleFile 매개 변수를 사용하여 파일과 함께 Windows PowerShell을 Console01.psc1 엽니다.

두 번째 명령은 cmdlet을 Add-PSSnapin 사용하여 MySnapin Windows PowerShell 스냅인을 현재 세션에 추가합니다.

세 번째 명령은 cmdlet을 Export-Console 사용하여 세션에 있는 모든 Windows PowerShell 스냅인의 이름을 파일로 NewConsole.psc1 내보냅니다.

네 번째 명령은 변수를 $ConsoleFileName 표시합니다. 가장 최근에 사용한 콘솔 파일이 포함되어 있습니다. 샘플 출력은 NewConsole.ps1이 가장 최근에 사용된 파일임을 보여 줍니다.

다섯 번째 명령은 SnapIn03을 현재 콘솔에 추가합니다.

여섯 번째 명령은 Path 매개 변수 없이 cmdlet을 사용합니다Export-Console. 이 명령은 현재 세션의 모든 Windows PowerShell 스냅인 이름을 가장 최근에 사용한 파일로 NewConsole.psc1내보냅니다.

매개 변수

-Confirm

cmdlet을 실행하기 전에 확인 메시지가 표시됩니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

이 cmdlet은 파일에 읽기 전용 특성이 있더라도 경고 없이 콘솔 파일의 데이터를 덮어씁니다. 읽기 전용 특성이 변경되고 명령이 완료되면 다시 설정되지 않습니다.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NoClobber

이 cmdlet이 기존 콘솔 파일을 덮어쓰지 않음을 나타냅니다. 기본적으로 지정된 경로 Export-Console 에서 파일이 발생하면 경고 없이 파일을 덮어씁니다.

Type:SwitchParameter
Aliases:NoOverwrite
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Path

콘솔 파일(*.psc1)의 경로 및 파일 이름을 지정합니다. 선택적 경로 및 이름을 입력합니다. 와일드카드 문자는 허용되지 않습니다.

파일 이름 Export-Console 만 지정하는 경우 현재 디렉터리에 해당 이름과 .psc1 파일 이름 확장명을 가진 파일을 만듭니다.

이 매개 변수는 PSConsoleFile 매개 변수를 사용하여 Windows PowerShell을 열거나 현재 세션 중에 콘솔 파일을 내보내지 않는 한 필요합니다. 현재 콘솔 파일을 덮어쓰지 않도록 NoClobber 매개 변수를 사용하는 경우에도 필요합니다.

이 매개 변수 Export-Console 를 생략하면 이 세션에서 가장 최근에 사용된 콘솔 파일을 덮어씁니다. 가장 최근에 사용한 콘솔 파일의 경로는 $ConsoleFileName 자동 변수의 값에 저장됩니다. 자세한 내용은 about_Automatic_Variables를 참조하세요.

Type:String
Aliases:PSPath
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-WhatIf

cmdlet이 실행될 경우 결과 동작을 표시합니다. cmdlet이 실행되지 않습니다.

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

입력

String

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

출력

FileInfo

이 cmdlet은 내보낸 별칭을 포함하는 파일을 만듭니다.

참고

  • 콘솔 파일(.psc1)을 사용하여 세션을 시작하면 콘솔 파일의 이름이 자동 변수에 $ConsoleFileName 자동으로 저장됩니다. $ConsoleFileName 값은 Path 매개 변수 Export-Console 를 사용하여 새 콘솔 파일을 지정할 때 업데이트됩니다. 콘솔 파일이 사용되지 않으면 $ConsoleFileName 값($null)이 없습니다.

    새 세션에서 Windows PowerShell 콘솔 파일을 사용하려면 다음 구문을 사용하여 Windows PowerShell을 시작합니다.

    powershell.exe -PsConsoleFile \<ConsoleFile\>.psc1

    Windows PowerShell 프로필에 Add-PSSnapin 명령을 추가하여 향후 세션에 대한 Windows PowerShell 스냅인을 저장할 수도 있습니다. 자세한 내용은 about_Profiles를 참조하세요.