Update-PSModuleManifest

참조

모듈:: Microsoft.PowerShell.PSResourceGet

모듈 매니페스트 파일을 업데이트합니다.

Syntax

Update-PSModuleManifest
      [-Path] <String>
      [-NestedModules <Object[]>]
      [-Guid <Guid>]
      [-Author <String>]
      [-CompanyName <String>]
      [-Copyright <String>]
      [-RootModule <String>]
      [-ModuleVersion <Version>]
      [-Description <String>]
      [-ProcessorArchitecture <ProcessorArchitecture>]
      [-CompatiblePSEditions <String[]>]
      [-PowerShellVersion <Version>]
      [-ClrVersion <Version>]
      [-DotNetFrameworkVersion <Version>]
      [-PowerShellHostName <String>]
      [-PowerShellHostVersion <Version>]
      [-RequiredModules <Object[]>]
      [-TypesToProcess <String[]>]
      [-FormatsToProcess <String[]>]
      [-ScriptsToProcess <String[]>]
      [-RequiredAssemblies <String[]>]
      [-FileList <String[]>]
      [-ModuleList <Object[]>]
      [-FunctionsToExport <String[]>]
      [-AliasesToExport <String[]>]
      [-VariablesToExport <String[]>]
      [-CmdletsToExport <String[]>]
      [-DscResourcesToExport <String[]>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String>]
      [-Prerelease <String>]
      [-HelpInfoUri <Uri>]
      [-DefaultCommandPrefix <String>]
      [-ExternalModuleDependencies <String[]>]
      [-RequireLicenseAcceptance]
      [-PrivateData <Hashtable>]
      [<CommonParameters>]

Description

이 cmdlet은 모듈 매니페스트 파일에 저장된 데이터를 업데이트합니다. 매개 변수를 사용하면 업데이트할 속성을 지정할 수 있습니다. Update-PSModuleManifest 모듈 매니페스트의 기존 값을 덮어씁니다.

cmdlet은 개체를 반환하지 않습니다.

예제

예 1

다음은 모듈 매니페스트New Author의 Author 속성을 로 변경하는 예제입니다.

Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Author 'New Author'

예제 2

다음은 Prerelease 속성을 beta2로 변경하는 예제입니다.

Update-PSModuleManifest -Path 'C:\MyModules\TestModule' -Prerelease 'beta2'

예제 3

이 예제에서는 여러 속성을 업데이트합니다.

$parameters = @{
    Path = 'C:\MyModules\TestModule'
    Tags = 'Windows', 'Linux'
    Description = 'A module for managing packages.'
}
Update-PSModuleManifest

매개 변수

-AliasesToExport

모듈이 내보내는 별칭을 지정합니다. 와일드카드가 지원됩니다.

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

-Author

모듈 작성자를 지정합니다.

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

-ClrVersion

모듈에 필요한 Microsoft .NET Framework CLR(공용 언어 런타임)의 최소 버전을 지정합니다.

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

-CmdletsToExport

모듈이 내보내는 cmdlet을 지정합니다. 와일드카드가 지원됩니다.

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

-CompanyName

모듈을 만든 회사 또는 공급업체를 지정합니다.

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

-CompatiblePSEditions

모듈의 호환되는 PSEditions를 지정합니다 . PSEdition에 대한 자세한 내용은 호환되는 PowerShell 버전이 있는 모듈을 참조하세요.

Type:	String[]
Accepted values:	Desktop, Core
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

-DefaultCommandPrefix

기본 명령 접두사를 지정합니다.

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:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DotNetFrameworkVersion

모듈에 필요한 Microsoft .NET Framework 최소 버전을 지정합니다.

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

-DscResourcesToExport

모듈에서 내보내는 DSC(Desired State Configuration) 리소스를 지정합니다. 와일드카드가 지원됩니다.

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

-ExternalModuleDependencies

외부 모듈 종속성의 배열을 지정합니다.

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

-FileList

모듈에 포함된 모든 항목을 지정합니다.

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

-FormatsToProcess

모듈을 가져올 때 처리되는 서식 파일(.ps1xml)을 지정합니다.

모듈을 가져올 때 PowerShell은 지정된 파일을 사용하여 Update-FormatData cmdlet을 실행합니다. 서식 파일의 범위는 지정되지 않으므로 세션의 모든 세션 상태에 영향을 미칩니다.

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

-FunctionsToExport

모듈이 내보내는 함수를 지정합니다. 와일드카드가 지원됩니다.

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

-Guid

모듈의 고유 식별자를 지정합니다. GUID는 이름이 같은 모듈을 구분하는 데 사용됩니다.

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

-HelpInfoUri

모듈의 HelpInfo XML 파일의 인터넷 주소를 지정합니다. 또는 https:로 시작하는 URI(Uniform Resource Identifier)를 입력합니다http:.

자세한 내용은 Updatable 도움말을 참조하세요.

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

-IconUri

모듈에 대한 아이콘의 URI를 지정합니다. 지정한 아이콘이 모듈의 갤러리 웹 페이지에 표시됩니다.

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

-LicenseUri

모듈에 대한 라이선스 조건의 URL을 지정합니다.

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

-ModuleList

모듈에 포함된 모듈의 배열을 지정합니다.

각 모듈 이름을 문자열로 입력하거나 ModuleName 및 ModuleVersion 키를 사용하여 해시 테이블로 입력합니다. 해시 테이블은 선택적 GUID 키를 가질 수도 있습니다. 매개 변수 값에 문자열과 해시 테이블을 결합할 수 있습니다.

이 키는 모듈 인벤토리 역할을 합니다.

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

-ModuleVersion

모듈의 버전을 지정합니다.

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

-NestedModules

모듈의 세션 상태로 가져오는 스크립트 모듈(.psm1) 및 이진 모듈(.dll)을 지정합니다. NestedModules 키의 파일은 나열된 순서대로 실행됩니다.

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

-Path

모듈 매니페스트의 경로와 파일 이름을 지정합니다. 파일 확장자를 사용하여 파일 이름을 .psd1 입력합니다.

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

-PowerShellHostName

모듈에 필요한 PowerShell 호스트 프로그램의 이름을 지정합니다. 호스트 프로그램의 이름(예: PowerShell ISE 호스트 또는 ConsoleHost)을 입력합니다. 와일드카드는 허용되지 않습니다.

호스트 프로그램의 이름은 에 $Host.Name저장됩니다.

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

-PowerShellHostVersion

모듈에서 작동하는 PowerShell 호스트 프로그램의 최소 버전을 지정합니다. 버전 번호를 입력하세요(예: 1.1).

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

-PowerShellVersion

이 모듈에서 작동하는 PowerShell의 최소 버전을 지정합니다. 예를 들어 또는 7.2와 같은 5.1 버전을 지정할 수 있습니다.

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

-Prerelease

모듈 버전에 추가되는 시험판 값을 지정합니다. 예를 들어 시험판 이 이 preview 고 ModuleVersion 이 1.0.0인 경우 모듈의 버전은 입니다 1.0.0-preview.

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

-PrivateData

모듈을 가져올 때 모듈에 전달되는 데이터를 지정합니다. 해시 테이블로 저장된 임의의 값일 수 있습니다.

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

-ProcessorArchitecture

모듈에 필요한 프로세서 아키텍처를 지정합니다.

이 매개 변수에 허용되는 값은 다음과 같습니다.

Amd64
Arm
IA64
MSIL
None (알 수 없거나 지정되지 않음)
X86

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

-ProjectUri

이 프로젝트에 대한 웹 페이지의 URI를 지정합니다.

Type:	Uri
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

-RequiredAssemblies

모듈에 필요한 어셈블리(.dll) 파일을 지정합니다. PowerShell은 형식 또는 형식을 업데이트하거나, 중첩된 모듈을 가져오거나, RootModule 키에 지정된 모듈 파일을 가져오기 전에 지정된 어셈블리를 로드합니다.

이러한 어셈블리가 NestedModules 키에도 나열되더라도 FormatsToProcess 또는 TypesToProcess 키에 나열된 서식 또는 형식 파일을 업데이트하려면 로드해야 하는 어셈블리에 RequiredAssemblies를 사용합니다.

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

-RequiredModules

전역 세션 상태여야 하는 모듈을 지정합니다. 필요한 모듈이 전역 세션 상태가 아닌 경우 PowerShell에서 해당 모듈을 가져옵니다. 필요한 모듈을 사용할 수 없는 경우 명령이 Import-Module 실패합니다.

값은 모듈 이름 또는 모듈 사양을 포함하는 배열일 수 있습니다. 모듈 사양은 다음 키가 있는 해시 테이블입니다.

ModuleName - 필수 모듈 이름을 지정합니다.
GUID - 선택적 모듈의 GUID를 지정합니다.
또한 아래 세 키 중 하나 이상을 지정해야 합니다 .
- ModuleVersion - 모듈의 허용 가능한 최소 버전을 지정합니다.
- MaximumVersion - 모듈의 허용되는 최대 버전을 지정합니다.
- RequiredVersion - 모듈의 정확한 필수 버전을 지정합니다. 다른 버전 키와 함께 사용할 수 없습니다.

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

-RequireLicenseAcceptance

모듈에 대한 라이선스 승인이 필요함을 지정합니다.

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

-RootModule

모듈의 기본 또는 루트 파일을 지정합니다. 스크립트의 파일 이름(.ps1), 스크립트 모듈(.psm1), 모듈 매니페스트(.psd1), 어셈블리(.dll) 또는 cmdlet 정의 XML 파일(.cdxml)을 입력합니다. 모듈을 가져오면 루트 모듈에서 내보낸 멤버를 호출자의 세션 상태로 가져옵니다.

모듈에 매니페스트 파일이 있고 RootModule 키에 지정된 파일이 없는 경우 매니페스트는 모듈의 기본 파일이 됩니다. 모듈을 매니페스트 모듈(ModuleType = Manifest)으로 알려져 있습니다.

또는 .dll 파일에서 .psm1 멤버를 내보내려면 해당 파일의 이름을 매니페스트의 RootModule 또는 NestedModules 키 값에 지정해야 합니다.

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

-ScriptsToProcess

모듈을 가져올 때 호출자의 세션 상태에서 실행되는 스크립트(.ps1) 파일을 지정합니다. 로그인 스크립트를 사용하는 것처럼 이러한 스크립트를 사용하여 환경을 준비할 수 있습니다.

모듈의 세션 상태에서 실행되는 스크립트를 지정하려면 NestedModules 키를 사용합니다.

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

-TypesToProcess

모듈을 가져올 때 실행되는 형식 파일(.ps1xml)을 지정합니다.

모듈을 가져올 때 PowerShell은 지정된 파일을 사용하여 Update-TypeData cmdlet을 실행합니다. 형식 파일의 범위는 지정되지 않으므로 세션의 모든 세션 상태에 영향을 미칩니다.

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

-VariablesToExport

모듈이 내보내는 변수를 지정합니다. 와일드카드가 지원됩니다.

이 매개 변수를 사용하여 모듈에서 내보낼 변수를 제한합니다.

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

입력

None

출력

Object

참고

모듈 매니페스트 파일에 대한 전체 설명은 about_Module_Manifests 참조하세요.

New-ModuleManifest

다음을 통해 공유