New-PSScriptFileInfo
cmdlet은 스크립트에 대한 메타데이터를 포함하여 새 스크립트 파일을 만듭니다.
구문
New-PSScriptFileInfo
[-Path] <String>
[-Version <String>]
[-Author <String>]
-Description <String>
[-Guid <Guid>]
[-CompanyName <String>]
[-Copyright <String>]
[-RequiredModules <Hashtable[]>]
[-ExternalModuleDependencies <String[]>]
[-RequiredScripts <String[]>]
[-ExternalScriptDependencies <String[]>]
[-Tags <String[]>]
[-ProjectUri <String>]
[-LicenseUri <String>]
[-IconUri <String>]
[-ReleaseNotes <String>]
[-PrivateData <String>]
[-Force]
[<CommonParameters>] Description
cmdlet은 스크립트 패키지를 게시하는 데 필요한 메타데이터를 포함하는 새 스크립트 파일을 만듭니다.
예제
예제 1: 최소한의 정보로 빈 스크립트 만들기
이 예제에서는 필수 매개 변수만 사용하여 cmdlet을 실행합니다. Path 매개 변수는 스크립트의 nane 및 위치를 지정합니다. Description 매개 변수는 스크립트에 대한 주석 기반 도움말에 사용되는 설명을 제공합니다.
New-PSScriptFileInfo -Path ./test_script.ps1 -Description 'This is a test script.'
Get-Content ./test_script.ps1
<#PSScriptInfo
.VERSION 1.0.0.0
.GUID 6ec3934e-a2e0-495b-9a9c-480e555ad1d1
.AUTHOR johndoe
.COMPANYNAME
.COPYRIGHT
.TAGS
.LICENSEURI
.PROJECTURI
.ICONURI
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
.PRIVATEDATA
#>
<#
.DESCRIPTION
This is a test script.
#>예제 2: 필수 모듈을 사용하여 스크립트 만들기
이 예제에서는 RequiredModules를 비롯한 추가 매개 변수를 사용하여 cmdlet을 실행합니다. RequiredModules 는 모듈 사양의 배열입니다.
$parameters = @{
Path = './test_script2.ps1'
Description = 'This is a test script.'
Version = '2.0.0.0'
Author = 'janedoe'
RequiredModules = @(
@{ModuleName = 'PackageManagement'; ModuleVersion = '1.0.0.0' },
@{ModuleName = 'PSReadLine'}
)
}
New-PSScriptFileInfo @parameters
Get-Content ./test_script2.ps1
<#PSScriptInfo
.VERSION 2.0.0.0
.GUID 7ec4832e-a4e1-562b-8a8c-241e535ad7d7
.AUTHOR janedoe
.COMPANYNAME
.COPYRIGHT
.TAGS
.LICENSEURI
.PROJECTURI
.ICONURI
.EXTERNALMODULEDEPENDENCIES
.REQUIREDSCRIPTS
.EXTERNALSCRIPTDEPENDENCIES
.RELEASENOTES
.PRIVATEDATA
#>
#Requires -Module PSReadLine
#Requires -Module @{ ModuleName = 'PackageManagement'; ModuleVersion = '1.0.0.0' }
<#
.DESCRIPTION
This is a test script.
#>매개 변수
-Author
스크립트 작성자의 이름입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CompanyName
스크립트를 소유하는 회사의 이름입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Copyright
스크립트에 대한 저작권 정보입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
스크립트에 대한 설명입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExternalModuleDependencies
이 스크립트에서 가져온 외부 모듈 종속성 목록입니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExternalScriptDependencies
이 스크립트에서 가져온 외부 스크립트 종속성 목록입니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Force
cmdlet이 기존 파일을 덮어쓰도록 강제합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Guid
GUID 형식의 스크립트에 대한 고유 식별자입니다. GUID를 제공하지 않으면 cmdlet에서 자동으로 새 GUID를 만듭니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | Randomly generated |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IconUri
스크립트와 연결된 아이콘을 가리키는 URI(Uniform Resource Identifier)입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LicenseUri
스크립트와 연결된 사용권 계약 파일을 가리키는 URI입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
스크립트가 만들어지는 파일 이름 및 위치입니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PrivateData
스크립트와 연결된 프라이빗 데이터입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProjectUri
스크립트와 연결된 프로젝트 사이트를 가리키는 URI입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ReleaseNotes
스크립트에 대한 릴리스 정보입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequiredModules
매개 변수는 모듈 사양 해시 테이블의 배열을 사용합니다. 모듈 사양은 다음 키가 있는 해시 테이블입니다.
-
ModuleName- 필수 모듈 이름을 지정합니다. -
GUID- 선택적 모듈의 GUID를 지정합니다. - 또한 아래 세 키 중 하나 이상을 지정 해야 합니다 .
-
ModuleVersion- 모듈의 허용 가능한 최소 버전을 지정합니다. -
MaximumVersion- 모듈의 허용되는 최대 버전을 지정합니다. -
RequiredVersion- 모듈의 정확한 필수 버전을 지정합니다. 다른 버전 키에는 사용할 수 없습니다.
-
| 형식: | Hashtable[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequiredScripts
스크립트에 필요한 스크립트 목록입니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Tags
스크립트와 연결된 태그입니다. 태그 값은 공백을 포함해서는 안 되는 문자열입니다. 자세한 내용은 태그 세부 정보를 참조하세요.
| 형식: | String[] |
| 별칭: | Tag |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Version
스크립트의 버전입니다. 값이 제공되지 않으면 버전 기본값은 입니다 1.0.0.0.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
None
출력
참고
및 cmdlet은 New-PSScriptFileInfo 도움말 파일의 #requires 및 주석 기반 도움말 블록 사이에 <#PSScriptInfo 필요한 모듈에 대한 문을 배치합니다.Update-PSScriptFileInfo
는 Get-PSScriptFileInfo 주석 기반 도움말 블록 앞 어딘가에 문이 배치될 것으로 예상 #requires 합니다. 주석 기반 도움말 블록 다음에 배치된 모든 #requires 문은 및 Publish-PSResource에서 Get-PSScriptFileInfo 무시됩니다.
관련 링크
PSResourceGet