Update-ModuleManifest
모듈 매니페스트 파일을 업데이트합니다.
구문
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 는 내보낸 별칭 목록에서 별칭을 제거할 수 있지만 목록에 별칭을 추가할 수는 없습니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-Author
모듈 작성자를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ClrVersion
모듈에 필요한 Microsoft .NET Framework CLR(공용 언어 런타임)의 최소 버전을 지정합니다.
비고
이 설정은 Windows PowerShell 5.1과 같은 PowerShell Desktop 버전에만 유효하며 4.5보다 낮은 .NET Framework 버전에만 적용됩니다. 이 요구 사항은 최신 버전의 PowerShell 또는 .NET Framework에는 영향을 주지 않습니다.
| 형식: | Version |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CmdletsToExport
모듈에서 내보내는 cmdlet을 지정합니다. 와일드카드가 허용됩니다.
이 매개 변수를 사용하여 모듈에서 내보낸 cmdlet을 제한합니다. CmdletsToExport 는 내보낸 cmdlet 목록에서 cmdlet을 제거할 수 있지만 목록에 cmdlet을 추가할 수는 없습니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-CompanyName
모듈을 만든 회사 또는 공급업체를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-CompatiblePSEditions
모듈의 호환되는 PSEditions 지정합니다. PSEdition 대한 자세한 내용은 호환되는 PowerShell 버전 모듈을 참조하세요.
| 형식: | String[] |
| 허용되는 값: | Desktop, Core |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Confirm
Update-ModuleManifest실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Copyright
모듈에 대한 저작권 문을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DefaultCommandPrefix
기본 명령 접두사를 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Description
모듈에 대한 설명을 지정합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DotNetFrameworkVersion
모듈에 필요한 Microsoft .NET Framework의 최소 버전을 지정합니다.
비고
이 설정은 Windows PowerShell 5.1과 같은 PowerShell Desktop 버전에만 유효하며 4.5보다 낮은 .NET Framework 버전에만 적용됩니다. 이 요구 사항은 최신 버전의 PowerShell 또는 .NET Framework에는 영향을 주지 않습니다.
| 형식: | Version |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-DscResourcesToExport
모듈에서 내보내는 DSC(필요한 상태 구성) 리소스를 지정합니다. 와일드카드가 허용됩니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ExternalModuleDependencies
외부 모듈 종속성의 배열을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FileList
모듈에 포함된 모든 항목을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FormatsToProcess
모듈을 가져올 때 실행되는 서식 파일(.ps1xml)을 지정합니다.
모듈을 가져올 때 PowerShell은 지정된 파일을 사용하여 Update-FormatData cmdlet을 실행합니다.
서식 파일의 범위는 지정되지 않으므로 세션의 모든 세션 상태에 영향을 미칩니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FunctionsToExport
모듈에서 내보내는 함수를 지정합니다. 와일드카드가 허용됩니다.
이 매개 변수를 사용하여 모듈에서 내보낸 함수를 제한합니다. FunctionsToExport 는 내보낸 별칭 목록에서 함수를 제거할 수 있지만 목록에 함수를 추가할 수는 없습니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-Guid
모듈의 고유 식별자를 지정합니다. GUID를 사용하여 이름이 같은 모듈을 구분할 수 있습니다.
| 형식: | Guid |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-HelpInfoUri
모듈의 HelpInfo XML 파일의 인터넷 주소를 지정합니다. http 또는 https시작하는 URI(Uniform Resource Identifier)를 입력합니다.
HelpInfo XML 파일은 PowerShell 버전 3.0에서 도입된 업데이트 가능한 도움말 기능을 지원합니다. 모듈의 다운로드 가능한 도움말 파일의 위치와 지원되는 각 로캘에 대한 최신 도움말 파일의 버전 번호에 대한 정보가 포함되어 있습니다.
업데이트 가능 도움말에 대한 자세한 정보는 about_Updatable_Help참고하십시오. HelpInfo XML 파일에 대한 자세한 내용은 Updatable 도움말 지원을 참조하세요.
| 형식: | Uri |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-IconUri
모듈에 대한 아이콘의 URL을 지정합니다. 지정한 아이콘이 모듈의 갤러리 웹 페이지에 표시됩니다.
| 형식: | Uri |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-LicenseUri
모듈에 대한 라이선스 조건의 URL을 지정합니다.
| 형식: | Uri |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ModuleList
모듈에 포함된 모듈의 배열을 지정합니다.
각 모듈 이름을 문자열 또는 ModuleName 및 ModuleVersion 키를 사용하여 해시 테이블로 입력합니다. 해시 테이블에는 선택적 GUID 키가 있을 수도 있습니다. 매개 변수 값에 문자열과 해시 테이블을 결합할 수 있습니다.
이 키는 모듈 인벤토리 역할을 하도록 설계되었습니다. 이 키의 값에 나열된 모듈은 자동으로 처리되지 않습니다.
| 형식: | Object[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ModuleVersion
모듈의 버전을 지정합니다.
| 형식: | Version |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-NestedModules
모듈의 세션 상태로 가져오는 스크립트 모듈(.psm1) 및 이진 모듈(.dll)을 지정합니다.
NestedModules의 파일은 값에 나열된 순서대로 키를 실행할 있습니다.
각 모듈 이름을 문자열 또는 ModuleName 및 ModuleVersion 키를 사용하여 해시 테이블로 입력합니다. 해시 테이블에는 선택적 GUID 키가 있을 수도 있습니다. 매개 변수 값에 문자열과 해시 테이블을 결합할 수 있습니다.
| 형식: | Object[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PackageManagementProviders
패키지 관리 공급자의 배열을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PassThru
작업 중인 항목을 나타내는 개체를 반환합니다. 기본적으로 Update-ModuleManifest 출력을 생성하지 않습니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
모듈 매니페스트의 경로 및 파일 이름을 지정합니다.
.psd1같은 $PSHOME\Modules\MyModule\MyModule.psd1 파일 이름 확장명을 가진 경로 및 파일 이름을 입력합니다.
기존 파일의 경로를 지정하는 경우 파일에 읽기 전용 특성이 없는 한 Update-ModuleManifest 경고 없이 파일을 바꿉니다.
매니페스트는 모듈의 디렉터리에 있어야 하며 매니페스트 파일 이름은 모듈 디렉터리 이름과 동일하지만 확장명을 사용해야 .psd1 합니다.
경로 매개 변수 값에 대한 프롬프트에 대한 응답으로 변수(예: $PSHOME 또는$HOME)를 사용할 수 없습니다. 변수를 사용하려면 명령에 Path 매개 변수를 포함합니다.
| 형식: | String |
| Position: | 0 |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-PowerShellHostName
모듈에 필요한 PowerShell 호스트 프로그램의 이름을 지정합니다. PowerShell ISE 호스트 또는 ConsoleHost와 같은 호스트 프로그램의 이름을 입력합니다. 와일드카드는 허용되지 않습니다.
호스트 프로그램의 이름을 찾으려면 프로그램에서 $Host.Name입력합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PowerShellHostVersion
모듈에서 작동하는 PowerShell 호스트 프로그램의 최소 버전을 지정합니다. 버전 번호(예: 1.1)를 입력합니다.
| 형식: | Version |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PowerShellVersion
이 모듈에서 작동할 PowerShell의 최소 버전을 지정합니다. 예를 들어 3.0, 4.0 또는 5.0을 이 매개 변수의 값으로 지정할 수 있습니다.
| 형식: | Version |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Prerelease
모듈이 시험판임을 나타냅니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-PrivateData
모듈을 가져올 때 모듈에 전달되는 데이터를 지정합니다.
| 형식: | Hashtable |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProcessorArchitecture
모듈에 필요한 프로세서 아키텍처를 지정합니다.
이 매개 변수에 허용되는 값은 다음과 같습니다.
- Amd64
- 팔
- IA64
- MSIL
- 없음(알 수 없거나 지정되지 않음)
- X86
| 형식: | ProcessorArchitecture |
| 허용되는 값: | None, MSIL, X86, IA64, Amd64, Arm |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ProjectUri
이 프로젝트에 대한 웹 페이지의 URL을 지정합니다.
| 형식: | Uri |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ReleaseNotes
이 버전의 스크립트에 사용할 수 있게 하려는 릴리스 정보 또는 주석이 포함된 문자열 배열을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequiredAssemblies
모듈에 필요한 어셈블리(.dll) 파일을 지정합니다. 어셈블리 파일 이름을 입력합니다.
PowerShell은 형식 또는 형식을 업데이트하거나, 중첩된 모듈을 가져오거나, RootModule 키 값에 지정된 모듈 파일을 가져오기 전에 지정된 어셈블리를 로드합니다.
이 매개 변수를 사용하여 FormatsToProcess 또는 TypesToProcess 키에 나열된 서식 또는 형식 파일을 업데이트하기 위해 로드해야 하는 어셈블리를 포함하여 모듈에 필요한 모든 어셈 블리를 지정할 수 있습니다. 이러한 어셈블리가 NestedModules 키의 이진 모듈로도 나열된 경우에도 해당 어셈블리를 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequiredModules
전역 세션 상태에 있어야 하는 모듈을 지정합니다. 필요한 모듈이 전역 세션 상태가 아닌 경우 PowerShell에서 모듈을 가져옵니다. 필요한 모듈을 사용할 수 없는 경우 Import-Module 명령이 실패합니다.
| 형식: | Object[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequireLicenseAcceptance
모듈에 라이선스 동의가 필요하게 지정합니다.
| 형식: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RootModule
모듈의 기본 또는 루트 파일을 지정합니다. 스크립트의 파일 이름(.ps1), 스크립트 모듈(.psm1), 모듈 매니페스트(.psd1), 어셈블리(.dll), cmdlet 정의 XML 파일(.cdxml) 또는 워크플로(.xaml)를 입력합니다. 모듈을 가져오면 루트 모듈 파일에서 내보낸 멤버를 호출자의 세션 상태로 가져옵니다.
모듈에 매니페스트 파일이 있고 RootModule 키에 루트 파일이 지정되지 않은 경우 매니페스트는 모듈의 기본 파일이 됩니다. 또한 모듈은 매니페스트 모듈(ModuleType = Manifest)이 됩니다.
매니페스트가 있는 모듈의 .psm1 또는 .dll 파일에서 멤버를 내보내려면 해당 파일의 이름을 RootModule 또는 매니페스트의 NestedModules 키 값에 지정해야 합니다. 그렇지 않으면 해당 멤버는 내보내지지 않습니다.
PowerShell 2.0에서 이 키는 ModuleToProcess로 불렸습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ScriptsToProcess
모듈을 가져올 때 호출자의 세션 상태에서 실행되는 스크립트(.ps1) 파일을 지정합니다.
로그인 스크립트를 사용하는 것처럼 이러한 스크립트를 사용하여 환경을 준비할 수 있습니다.
모듈의 세션 상태에서 실행되는 스크립트를 지정하려면 NestedModules 키를 사용합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Tags
태그 배열을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-TypesToProcess
모듈을 가져올 때 실행되는 형식 파일(.ps1xml)을 지정합니다.
모듈을 가져올 때 PowerShell은 지정된 파일을 사용하여 Update-TypeData cmdlet을 실행합니다.
형식 파일의 범위는 지정되지 않으므로 세션의 모든 세션 상태에 영향을 미칩니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-VariablesToExport
모듈에서 내보내는 변수를 지정합니다. 와일드카드가 허용됩니다.
이 매개 변수를 사용하여 모듈에서 내보낸 변수를 제한합니다. VariablesToExport 는 내보낸 변수 목록에서 변수를 제거할 수 있지만 목록에 변수를 추가할 수는 없습니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | True |
-WhatIf
Update-ModuleManifest 실행될 경우 어떤 일이 발생하는지 보여줍니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
