Update-ModuleManifest

  • 참조
모듈:
PowerShellGet

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

Syntax

Update-ModuleManifest
      [-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[]>]
      [-PrivateData <Hashtable>]
      [-Tags <String[]>]
      [-ProjectUri <Uri>]
      [-LicenseUri <Uri>]
      [-IconUri <Uri>]
      [-ReleaseNotes <String[]>]
      [-Prerelease <String>]
      [-HelpInfoUri <Uri>]
      [-PassThru]
      [-DefaultCommandPrefix <String>]
      [-ExternalModuleDependencies <String[]>]
      [-PackageManagementProviders <String[]>]
      [-RequireLicenseAcceptance]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

cmdlet은 Update-ModuleManifest 모듈 매니페스트(.psd1) 파일을 업데이트합니다.

Microsoft.PowerShell.PSResourceGet의 Update-PSModuleManifest cmdlet에 대한 프록시 cmdlet입니다. 자세한 내용은 Update-PSModuleManifest를 참조하세요.

예제

예제 1: 모듈 매니페스트 업데이트

이 예제에서는 기존 모듈 매니페스트 파일을 업데이트합니다. 스플래팅은 매개 변수 값을 Update-ModuleManifest에 전달하는 데 사용됩니다. 자세한 내용은 about_Splatting.

$Params = @{
  Path = "C:\Test\TestManifest.psd1"
  Author = "TestUser1"
  CompanyName = "Contoso Corporation"
  Copyright = "(c) 2019 Contoso Corporation. All rights reserved."
}

Update-ModuleManifest @Params

$Params 는 Path, Author, CompanyName 및 Copyright에 대한 매개 변수 값을 저장하는 splat입니다. Update-ModuleManifest 에서 매개 변수 값을 @Params 가져오고 모듈 매니페스트 TestManifest.psd1을 업데이트합니다.

매개 변수

-AliasesToExport

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

이 매개 변수를 사용하여 모듈에서 내보낸 별칭을 제한합니다. 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(공용 언어 런타임) 최소 버전을 지정합니다.

참고

이 설정은 Windows PowerShell 5.1과 같은 PowerShell Desktop 버전에만 유효하며 4.5보다 낮은 .NET Framework 버전에만 적용됩니다. 이 요구 사항은 최신 버전의 PowerShell 또는 .NET Framework 영향을 주지 않습니다.

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

-CmdletsToExport

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

이 매개 변수를 사용하여 모듈에서 내보낸 cmdlet을 제한합니다. CmdletsToExport 는 내보낸 cmdlet 목록에서 cmdlet을 제거할 수 있지만 목록에 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

-Confirm

를 실행 Update-ModuleManifest하기 전에 확인 메시지를 표시합니다.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
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의 최소 버전을 지정합니다.

참고

이 설정은 Windows PowerShell 5.1과 같은 PowerShell Desktop 버전에만 유효하며 4.5보다 낮은 .NET Framework 버전에만 적용됩니다. 이 요구 사항은 최신 버전의 PowerShell 또는 .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:False

-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

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

이 매개 변수를 사용하여 모듈에서 내보낸 함수를 제한합니다. 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 파일의 인터넷 주소를 지정합니다. http 또는 https로 시작하는 URI(Uniform Resource Identifier)를 입력합니다.

HelpInfo XML 파일은 PowerShell 버전 3.0에서 도입된 업데이트 가능한 도움말 기능을 지원합니다. 모듈의 다운로드 가능한 도움말 파일의 위치와 지원되는 각 로캘에 대한 최신 도움말 파일의 버전 번호에 대한 정보가 포함되어 있습니다.

Updatable 도움말에 대한 자세한 내용은 about_Updatable_Help 참조하세요. HelpInfo XML 파일에 대한 자세한 내용은 Updatable 도움말 지원을 참조하세요.

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

-IconUri

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

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 키의 파일은 값에 나열된 순서대로 실행됩니다.

각 모듈 이름을 문자열이나 ModuleName 및 ModuleVersion 키가 포함된 해시 테이블로 입력합니다. 해시 테이블에 선택적 GUID 키가 포함될 수도 있습니다. 매개 변수 값에서 문자열과 해시 테이블을 결합할 수 있습니다.

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

-PackageManagementProviders

패키지 관리 공급자의 배열을 지정합니다.

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

-PassThru

작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 는 Update-ModuleManifest 출력을 생성하지 않습니다.

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

-Path

모듈 매니페스트의 경로 및 파일 이름을 지정합니다. 파일 이름 확장명을 가진 경로 및 파일 이름(예: $PSHOME\Modules\MyModule\MyModule.psd1)을 .psd1 입력합니다.

기존 파일의 경로를 지정하는 경우 는 파일에 Update-ModuleManifest 읽기 전용 특성이 없는 한 경고 없이 파일을 바꿉니다.

매니페스트는 모듈의 디렉터리에 있어야 하며 매니페스트 파일 이름은 모듈 디렉터리 이름과 동일하지만 확장명은 .psd1 이어야 합니다.

Path 매개 변수 값에 대한 프롬프트에 대한 응답으로 또는 $HOME와 같은 $PSHOME 변수를 사용할 수 없습니다. 변수를 사용하려면 명령에 Path 매개 변수를 포함합니다.

Type:String
Position:0
Default value:None
Required:True
Accept pipeline input:True
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을 지정합니다. 예를 들어 3.0, 4.0 또는 5.0을 이 매개 변수의 값으로 지정할 수 있습니다.

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

-Prerelease

모듈이 시험판임을 나타냅니다.

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
  • 없음(알 수 없거나 지정되지 않음)
  • X86
Type:ProcessorArchitecture
Accepted values:None, MSIL, X86, IA64, Amd64, Arm
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProjectUri

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

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 키 값에 지정된 모듈 파일을 가져오기 전에 지정된 어셈블리를 로드합니다.

이 매개 변수를 사용하여 FormatsToProcess 또는 TypesToProcess 키에 나열된 서식 또는 형식 파일을 업데이트하기 위해 로드해야 하는 어셈블리를 포함하여 모듈에 필요한 모든 어셈 블리를 지정합니다. 이러한 어셈블리가 NestedModules 키에도 이진 모듈로 나열되어 있는 경우에도 해당 어셈블리를 지정합니다.

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

-RequiredModules

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

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

-RequireLicenseAcceptance

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

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

-RootModule

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

모듈에 매니페스트 파일이 있고 RootModule 키에 루트 파일이 지정되지 않은 경우 매니페스트는 모듈의 기본 파일이 됩니다. 또한 모듈은 매니페스트 모듈(ModuleType = Manifest)이 됩니다.

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

PowerShell 2.0에서 이 키를 ModuleToProcess라고 했습니다.

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[]
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

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

이 매개 변수를 사용하여 모듈에서 내보낸 변수를 제한합니다. VariablesToExport 는 내보낸 변수 목록에서 변수를 제거할 수 있지만 목록에 변수를 추가할 수는 없습니다.

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

-WhatIf

실행될 경우 Update-ModuleManifest 어떤 일이 발생하는지 표시합니다. cmdlet이 실행되지 않습니다.

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

입력

String

출력

Object