Import-IseSnippet

모듈:

ISE

ISE 코드 조각을 현재 세션으로 가져옵니다.

Syntax

Import-IseSnippet
      [-Path] <String>
      [-Recurse]
      [<CommonParameters>]

Import-IseSnippet
      [-Recurse]
      -Module <String>
      [-ListAvailable]
      [<CommonParameters>]

Description

cmdlet은 Import-IseSnippet 다시 사용할 수 있는 텍스트 "코드 조각"을 모듈 또는 디렉터리에서 현재 세션으로 가져옵니다. 이 코드 조각은 Windows PowerShell ISE에서 즉시 사용할 수 있습니다. 이 cmdlet은 Windows PowerShell ISE(통합 스크립팅 환경)에서만 작동합니다.

가져온 조각을 보고 사용하려면 Windows PowerShell ISE 편집 메뉴에서 코드 조각 시작을 클릭하거나 Ctrl+J를 누릅니다.

가져온 조각은 현재 세션에서만 사용할 수 있습니다. 모든 Windows PowerShell ISE 세션으로 코드 조각을 가져오려면 Windows PowerShell 프로필에 명령을 추가 Import-IseSnippet 하거나 코드 조각 파일을 로컬 코드 조각 디렉터리에 복사합니다 $HOME\Documents\WindowsPowershell\Snippets.

코드 조각을 가져오려면 Windows PowerShell ISE 코드 조각에 대한 코드 조각 XML의 형식을 올바르게 지정하고 Snippet.ps1xml 파일에 저장해야 합니다. 적격 코드 조각을 만들려면 cmdlet을 New-IseSnippet 사용합니다. New-IseSnippet 는 <SnippetTitle>.Snippets.ps1xml 디렉터리에 파일을 $HOME\Documents\WindowsPowerShell\Snippets 만듭니다. 코드 조각을 Windows PowerShell 모듈의 코드 조각 디렉터리 또는 다른 디렉터리로 이동하거나 복사할 수 있습니다.

Get-IseSnippet 로컬 코드 조각 디렉터리에서 사용자가 만든 코드 조각을 가져오는 cmdlet은 가져온 코드 조각을 가져오지 않습니다.

이 cmdlet은 Windows PowerShell 3.0에서 도입되었습니다.

예제

예제 1: 디렉터리에서 코드 조각 가져오기

다음은 디렉터리에서 \\Server01\Public\Snippets 현재 세션으로 코드 조각을 가져오는 예제입니다. Recurse 매개 변수를 사용하여 코드 조각 디렉터리의 모든 하위 디렉터리에서 코드 조각을 가져옵니다.

Import-IseSnippet -Path \\Server01\Public\Snippets -Recurse

예제 2: 모듈에서 코드 조각 가져오기

다음은 SnippetModule 모듈에서 코드 조각을 가져오는 예제입니다. 명령이 실행될 때 SnippetModule 모듈을 사용자 세션으로 가져오지 않은 경우에도 이 명령은 ListAvailable 매개 변수를 사용하여 코드 조각을 가져옵니다.

Import-IseSnippet -Module SnippetModule -ListAvailable

예제 3: 모듈에서 코드 조각 찾기

이 예제에서는 PSModulePath 환경 변수에 설치된 모든 모듈의 코드 조각을 가져옵니다.

($env:PSModulePath).split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    ForEach-Object {$_.fullname}

예제 4: 모든 모듈 코드 조각 가져오기

이 예제에서는 설치된 모든 모듈의 모든 조각을 현재 세션으로 가져옵니다. 일반적으로 코드 조각이 있는 모듈은 모듈을 가져올 때 cmdlet을 사용하여 Import-IseSnippet 가져오기 때문에 이와 같은 명령을 실행할 필요가 없습니다.

($env:PSModulePath).split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    ForEach-Object {$psise.CurrentPowerShellTab.Snippets.Load($_)}

예제 5: 모든 모듈 코드 조각 복사

다음은 설치된 모든 모듈 Snippets 의 코드 조각을 현재 사용자의 디렉터리에 복사하는 예제입니다. 현재 세션에만 영향을 미치는 가져온 코드 조각과 달리 복사한 코드 조각은 모든 Windows PowerShell ISE 세션에서 사용할 수 있습니다.

($env:PSModulePath).split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    Copy-Item -Destination $HOME\Documents\WindowsPowerShell\Snippets

매개 변수

-ListAvailable

이 cmdlet은 모듈을 현재 세션으로 가져오지 않더라도 컴퓨터에 설치된 모듈에서 코드 조각을 가져옵니다. 이 매개 변수를 생략하고 Module 매개 변수로 지정된 모듈 을 현재 세션으로 가져오지 않으면 모듈에서 코드 조각을 가져오려는 시도가 실패합니다.

이 매개 변수는 모듈 매개 변수가 명령에 사용되는 경우에만 유효합니다.

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

-Module

지정된 모듈에서 현재 세션으로 코드 조각을 가져옵니다. 와일드카드 문자는 지원되지 않습니다.

이 매개 변수는 모듈 경로의 코드 조각 하위 디렉터리에 있는 파일(예: $HOME\Documents\WindowsPowerShell\Modules\<ModuleName>\Snippets.)에서 Snippet.ps1xml 코드 조각을 가져옵니다.

이 매개 변수는 모듈 매니페스트의 ScriptsToProcess 키에 지정된 스크립트와 같은 시작 스크립트의 모듈 작성자가 사용하도록 설계되었습니다. 모듈의 코드 조각은 모듈과 함께 자동으로 가져오지 않지만 명령을 사용하여 Import-IseSnippet 가져올 수 있습니다.

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

-Path

이 cmdlet이 조각을 가져오는 코드 조각 디렉터리의 경로를 지정합니다.

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	True

-Recurse

이 cmdlet은 Path 매개 변수 값의 모든 하위 디렉터리에서 코드 조각을 가져오고 있음을 나타냅니다.

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

입력

None

개체를 이 cmdlet으로 파이프할 수 없습니다.

출력

None

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

참고

• cmdlet을 Get-IseSnippet 사용하여 가져온 코드 조각을 가져올 수 없습니다. Get-IseSnippet 는 디렉터리의 코드 $HOME\Documents\WindowsPowerShell\Snippets 조각만 가져옵니다.

• Import-IseSnippet는 Microsoft.PowerShell.Host.ISE.ISESnippetCollection 개체의 Load 정적 메서드를 사용합니다. Windows PowerShell ISE 개체 모델에서 코드 조각의 Load 메서드를 사용할 수도 있습니다.$psISE.CurrentPowerShellTab.Snippets.Load()

• cmdlet은 New-IseSnippet 서명되지 않은 .ps1xml 파일에 사용자가 만든 새 코드 조각을 저장합니다. 따라서 Windows PowerShell은 실행 정책이 AllSigned 또는 Restricted인 세션에 로드할 수 없습니다. 제한된 세션 또는 AllSigned 세션에서 서명되지 않은 사용자가 만든 코드 조각을 만들고 가져오고 가져올 수 있지만 세션에서 사용할 수는 없습니다.

  cmdlet이 반환하는 서명되지 않은 사용자 생성 코드 Import-IseSnippet 조각을 사용하려면 실행 정책을 변경한 다음 Windows PowerShell ISE를 다시 시작합니다.

  Windows PowerShell 실행 정책에 대한 자세한 내용은 about_Execution_Policies 참조하세요.

관련 링크

• Get-IseSnippet
• New-IseSnippet