다음을 통해 공유

New-IseSnippet

  • 참조
모듈:
ISE

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

구문

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 디렉터리에 <Title>.Snippets.ps1xml 파일을 만듭니다. 작성 중인 모듈에 코드 조각 파일을 포함하려면 모듈 디렉터리의 코드 조각 하위 디렉터리에 코드 조각 파일을 추가합니다.

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

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

예제

예제 1: Comment-Based 도움말 코드 조각 만들기

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\SnippetsComment-BasedHelp.snippets.ps1xml 파일을 만듭니다.

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

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

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: 폴더에서 대상 폴더로 필수 코드 조각 복사

Copy-Item "$HOME\Documents\WindowsPowerShell\Snippets\Mandatory.Snippets.ps1xml" -Destination "\\Server\Share"

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

매개 변수

-Author

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-CaretOffset

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

형식:Int32
Position:Named
Default value:0
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Description

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

형식:String
Position:2
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

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

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Text

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

형식:String
Position:3
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Title

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

형식:String
Position:1
Default value:None
필수:True
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

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의 코드 조각 메뉴에 표시됩니다.