다음을 통해 공유

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 +누릅니다.

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

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

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

$M = @'
param
(
  [Parameter(Mandatory=$true)]
  [string[]]
  $<ParameterName>
)
'@

$snippet = @{
    Text = $M
    Title = 'Mandatory'
    Description = 'Adds a mandatory function parameter.'
    Author = 'Patti Fuller, Fabrikam Corp.'
    Force = $true
}
New-ISESnippet @snippet

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

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

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

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

매개 변수

-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 세션에서 서명되지 않은 사용자가 만든 코드 조각을 만들고 가져오고 가져올 수 있지만 세션에서 사용할 수는 없습니다.

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

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

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