다음을 통해 공유

New-PSScriptFileInfo

  • 참조
모듈:
Microsoft.PowerShell.PSResourceGet

cmdlet은 스크립트에 대한 메타데이터를 포함하여 새 스크립트 파일을 만듭니다.

Syntax

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

스크립트 작성자의 이름입니다.

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

-CompanyName

스크립트를 소유하는 회사의 이름입니다.

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

-Copyright

스크립트에 대한 저작권 정보입니다.

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

-Description

스크립트에 대한 설명입니다.

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

-ExternalModuleDependencies

이 스크립트에서 가져온 외부 모듈 종속성 목록입니다.

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

-ExternalScriptDependencies

이 스크립트에서 가져온 외부 스크립트 종속성 목록입니다.

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

-Force

cmdlet이 기존 파일을 덮어쓰도록 강제합니다.

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

-Guid

GUID 형식의 스크립트에 대한 고유 식별자입니다. GUID를 제공하지 않으면 cmdlet에서 자동으로 새 GUID를 만듭니다.

Type:Guid
Position:Named
Default value:Randomly generated
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IconUri

스크립트와 연결된 아이콘을 가리키는 URI(Uniform Resource Identifier)입니다.

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

-LicenseUri

스크립트와 연결된 사용권 계약 파일을 가리키는 URI입니다.

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

-Path

스크립트가 만들어지는 파일 이름 및 위치입니다.

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

-PrivateData

스크립트와 연결된 프라이빗 데이터입니다.

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

-ProjectUri

스크립트와 연결된 프로젝트 사이트를 가리키는 URI입니다.

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

-ReleaseNotes

스크립트에 대한 릴리스 정보입니다.

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

-RequiredModules

매개 변수는 모듈 사양 해시 테이블의 배열을 사용합니다. 모듈 사양은 다음 키가 있는 해시 테이블입니다.

  • ModuleName - 필수 모듈 이름을 지정합니다.
  • GUID - 선택적 모듈의 GUID를 지정합니다.
  • 또한 아래 세 키 중 하나 이상을 지정 해야 합니다 .
    • ModuleVersion - 모듈의 허용 가능한 최소 버전을 지정합니다.
    • MaximumVersion - 모듈의 허용되는 최대 버전을 지정합니다.
    • RequiredVersion - 모듈의 정확한 필수 버전을 지정합니다. 다른 버전 키에는 사용할 수 없습니다.
Type:Hashtable[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredScripts

스크립트에 필요한 스크립트 목록입니다.

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

-Tags

스크립트와 연결된 태그입니다. 태그 값은 공백을 포함해서는 안 되는 문자열입니다. 자세한 내용은 태그 세부 정보를 참조하세요.

Type:String[]
Aliases:Tag
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

스크립트의 버전입니다. 값이 제공되지 않으면 버전 기본값은 입니다 1.0.0.0.

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

입력

None

출력

Object

참고

및 cmdlet은 New-PSScriptFileInfo 도움말 파일의 #requires 및 주석 기반 도움말 블록 사이에 <#PSScriptInfo 필요한 모듈에 대한 문을 배치합니다.Update-PSScriptFileInfo 는 Get-PSScriptFileInfo 주석 기반 도움말 블록 앞 어딘가에 문이 배치될 것으로 예상 #requires 합니다. 주석 기반 도움말 블록 다음에 배치된 모든 #requires 문은 및 Publish-PSResource에서 Get-PSScriptFileInfo 무시됩니다.