New-IseSnippet

모듈:

ISE

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

Syntax

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

Description

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

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

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

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

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

예제

예제 1: 주석 기반 도움말 코드 조각 만들기

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 코드 조각을 만듭니다. 사용자의 코드 조각 디렉터리에 이름이 지정된 Comment-BasedHelp.snippets.ps1xml 파일을 만듭니다 $HOME\Documents\WindowsPowerShell\Snippets.

예제 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 저장합니다. 두 번째 명령은 cmdlet을 New-ISESnippet 사용하여 코드 조각을 만듭니다. 이 명령은 Force 매개 변수를 사용하여 동일한 이름으로 이전 코드 조각을 덮어씁 수 있습니다.

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

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

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

매개 변수

-Author

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

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

-CaretOffset

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

Type:	Int32
Position:	Named
Default value:	0
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

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

-Force

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

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

-Text

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

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

-Title

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

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

입력

None

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

출력

None

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

참고

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

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

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

• 코드 조각을 변경하려면 코드 조각 파일을 편집합니다. Windows PowerShell ISE의 스크립트 창에서 코드 조각 파일을 편집할 수 있습니다.
• 추가한 코드 조각을 삭제하려면 코드 조각 파일을 삭제합니다.
• 기본 제공 코드 조각을 삭제할 수는 없지만 "$psise 사용하여 모든 기본 제공 코드 조각을 숨길 수 있습니다. Options.ShowDefaultSnippets=$false" 명령입니다.
• 기본 제공 코드 조각과 이름이 같은 코드 조각을 만들 수 있습니다. 두 코드 조각은 Windows PowerShell ISE의 코드 조각 메뉴에 표시됩니다.

관련 링크

• Get-IseSnippet
• Import-IseSnippet