Import-IseSnippet

모듈:

ISE Module

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

구문

FromFolder (기본값)

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

FromModule

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

Description

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

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

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

코드 조각을 가져오려면 Windows PowerShell ISE 코드 조각에 대한 코드 조각 XML의 형식을 올바르게 지정하고 Snippet.ps1xml 파일에 저장해야 합니다. 적합한 코드 조각을 만들려면 New-IseSnippet cmdlet을 사용합니다. 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 모듈에서 코드 조각을 가져오는 예제입니다. 이 명령은 ListAvailable 매개 변수를 사용하여 명령이 실행될 때 SnippetModule 모듈을 사용자 세션으로 가져오지 않은 경우에도 조각을 가져옵니다.

Import-IseSnippet -Module SnippetModule -ListAvailable

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

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

($Env:PSModulePath).Split(";") |
  ForEach-Object {dir $_\*\Snippets\*.Snippets.ps1xml -ErrorAction SilentlyContinue} |
    ForEach-Object {$_.FullName}

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

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

($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 매개 변수로 지정된 모듈을 현재 세션으로 가져오지 않으면 모듈에서 코드 조각을 가져오려는 시도가 실패합니다.

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

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

FromModule

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Module

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

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

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

FromModule

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Path

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

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	True
DontShow:	False

매개 변수 집합

FromFolder

Position:	1
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Recurse

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

매개 변수 속성

형식:	SwitchParameter
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

None

개체를 이 cmdlet에 파이프로 연결할 수 없습니다.

출력

None

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

참고

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

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

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

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

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

관련 링크

• Get-IseSnippet
• New-IseSnippet