다음을 통해 공유

New-IseSnippet

모듈:
ISE Module

Windows PowerShell ISE 코드 조각을 만듭니다.

구문

Default (기본값) 

New-IseSnippet
    [-Title] <String>
    [-Description] <String>
    [-Text] <String>
    [-Author <String>]
    [-CaretOffset <Int32>]
    [-Force]
    [<CommonParameters>]

Description

New-ISESnippet cmdlet은 Windows PowerShell ISE에 대해 재사용 가능한 텍스트 "코드 조각"을 만듭니다. 코드 조각을 사용하여 Windows PowerShell ISE의 스크립트 창 또는 명령 창에 텍스트를 추가할 수 있습니다. 이 cmdlet은 Windows PowerShell ISE에서만 사용할 수 있습니다.

Windows PowerShell 3.0부터 Windows PowerShell ISE에는 기본 제공 코드 조각 컬렉션이 포함되어 있습니다. New-ISESnippet cmdlet을 사용하면 기본 제공 컬렉션에 추가할 고유한 코드 조각을 만들 수 있습니다. 코드 조각 파일을 보고 변경, 추가, 삭제 및 공유하고 Windows PowerShell 모듈에 포함할 수 있습니다. Windows PowerShell ISE의 코드 조각을 보려면 편집 메뉴에서 시작 코드 조각을 선택하거나 Ctrl+J를 누릅니다.

New-ISESnippet cmdlet은 <타이틀>만듭니다. 지정한 제목이 있는 $home\Documents\WindowsPowerShell\Snippets 디렉터리의 Snippets.ps1xml 파일입니다. 작성 중인 모듈에 코드 조각 파일을 포함하려면 모듈 디렉터리의 코드 조각 하위 디렉터리에 코드 조각 파일을 추가합니다.

실행 정책이 제한된 또는 AllSigned세션에서 사용자가 만든 코드 조각을 사용할 수 없습니다.

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

예제

예제 1: Comment-BasedHelp 코드 조각 만들기

PS C:\> New-IseSnippet -Title Comment-BasedHelp -Description "A template for comment-based help." -Text "<#
    .SYNOPSIS
    .DESCRIPTION
    .PARAMETER  <Parameter-Name>
    .INPUTS
    .OUTPUTS
    .EXAMPLE
    .LINK
#>"

이 명령은 Windows PowerShell ISE에 대한 Comment-BasedHelp 조각을 만듭니다. 사용자의 코드 조각 디렉터리($home\Documents\WindowsPowerShell\Snippets)에 "Comment-BasedHelp.snippets.ps1xml"이라는 파일을 만듭니다.

예제 2: 필수 코드 조각 만들기

PS C:\> $M = @'
Param
(
  [parameter(Mandatory=$true)]
  [String[]]
  $<ParameterName>
)
'@

PS C:\> New-ISESnippet -Text $M -Title Mandatory -Description "Adds a mandatory function parameter." -Author "Patti Fuller, Fabrikam Corp." -Force

이 예제에서는 Windows PowerShell ISE에 대한 필수 코드 조각을 만듭니다. 첫 번째 명령은 코드 조각 텍스트를 $M 변수에 저장합니다. 두 번째 명령은 New-ISESnippet cmdlet을 사용하여 코드 조각을 만듭니다. 이 명령은 Force 매개 변수를 사용하여 이전 코드 조각을 동일한 이름으로 덮어씁 수 있습니다.

예제 3: 폴더에서 대상 폴더로 필수 코드 조각 복사

PS C:\> Copy-Item "$Home\Documents\WindowsPowerShell\Snippets\Mandatory.Snippets.ps1xml" -Destination "\\Server\Share"

이 명령은 Copy-Item cmdlet을 사용하여 New-ISESnippet 서버\공유 파일 공유에 배치하는 폴더에서 필수 코드 조각을 복사합니다.

New-ISESnippet 만드는 Snippets.ps1xml 파일은 텍스트(XML) 파일이므로 Item cmdlet을 사용하여 cmdlet을 가져와서 변경하고, 이동하고, 이름을 바꾸고, 복사할 수 있습니다.

매개 변수

-Author

코드 조각의 작성자를 지정합니다. 작성자 필드는 코드 조각 파일에 표시되지만 Windows PowerShell ISE에서 코드 조각 이름을 클릭하면 표시되지 않습니다.

매개 변수 속성

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

매개 변수 집합

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

-CaretOffset

이 cmdlet에서 커서를 배치하는 코드 조각 텍스트의 문자를 지정합니다. 텍스트의 첫 번째 문자를 나타내는 "1"을 사용하여 커서 위치를 나타내는 정수를 입력합니다. 기본값인 0은 텍스트의 첫 문자 바로 앞에 커서를 놓습니다. 이 매개 변수는 코드 조각 텍스트를 들여쓰지 않습니다.

매개 변수 속성

형식:Int32
Default value:0
와일드카드 지원:False
DontShow:False

매개 변수 집합

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

-Description

코드 조각에 대한 설명을 지정합니다. Windows PowerShell ISE에서 코드 조각 이름을 클릭하면 설명 값이 나타납니다. 이 매개 변수는 필수입니다.

매개 변수 속성

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

매개 변수 집합

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

-Force

이 cmdlet은 동일한 위치에 동일한 이름의 코드 조각 파일을 덮어씁니다. 기본적으로 New-ISESnippet 파일을 덮어쓰지 않습니다.

매개 변수 속성

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

매개 변수 집합

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

-Text

코드 조각을 선택할 때 추가되는 텍스트 값을 지정합니다. Windows PowerShell ISE에서 코드 조각 이름을 클릭하면 코드 조각 텍스트가 나타납니다. 이 매개 변수는 필수입니다.

매개 변수 속성

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

매개 변수 집합

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

-Title

코드 조각의 제목 또는 이름을 지정합니다. 제목은 코드 조각 파일의 이름도 지정합니다. 이 매개 변수는 필수입니다.

매개 변수 속성

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

매개 변수 집합

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

CommonParameters

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

입력

None

이 cmdlet은 파이프라인에서 입력을 받지 않습니다.

출력

None

이 cmdlet은 어떠한 출력도 생성하지 않습니다.

참고

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

제한된 또는 AllSigned 세션에서 New-IseSnippet cmdlet을 사용하는 경우 코드 조각이 생성되지만 Windows PowerShell에서 새로 만든 코드 조각을 세션에 추가하려고 하면 오류 메시지가 나타납니다. 새 코드 조각(및 기타 서명되지 않은 사용자가 만든 코드 조각)을 사용하려면 실행 정책을 변경한 다음 Windows PowerShell ISE를 다시 시작합니다.

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

  • 코드 조각을 변경하려면 코드 조각 파일을 편집합니다. Windows PowerShell ISE의 스크립트 창에서 코드 조각 파일을 편집할 수 있습니다.

  • 추가한 코드 조각을 삭제하려면 코드 조각 파일을 삭제합니다.

  • 기본 제공 코드 조각을 삭제할 수는 없지만 "$psise 사용하여 모든 기본 제공 코드 조각을 숨길 수 있습니다. Options.ShowDefaultSnippets=$false" 명령입니다.

  • 기본 제공 코드 조각과 이름이 같은 코드 조각을 만들 수 있습니다. 두 코드 조각은 Windows PowerShell ISE의 코드 조각 메뉴에 표시됩니다.