새 모듈 매니페스트를 만듭니다.

구문

New-ModuleManifest [-Path] <string> -Author <string> -CompanyName <string> -Copyright <string> -Description <string> -FileList <string[]> -FormatsToProcess <string[]> -ModuleToProcess <string> -NestedModules <string[]> -RequiredAssemblies <string[]> -TypesToProcess <string[]> [-AliasesToExport <string[]>] [-ClrVersion <Version>] [-CmdletsToExport <string[]>] [-DotNetFrameworkVersion <Version>] [-FunctionsToExport <string[]>] [-Guid <Guid>] [-ModuleList <Object[]>] [-ModuleVersion <Version>] [-PassThru] [-PowerShellHostName <string>] [-PowerShellHostVersion <Version>] [-PowerShellVersion <Version>] [-PrivateData <Object>] [-ProcessorArchitecture {<None> | <MSIL> | <X86> | <IA64> | <Amd64>}] [-RequiredModules <Object[]>] [-ScriptsToProcess <string[]>] [-VariablesToExport <string[]>] [-Confirm] [-WhatIf] [<CommonParameters>]

설명

New-ModuleManifest cmdlet은 새 모듈 매니페스트(.psd1) 파일을 만들고 이 파일의 값을 채운 다음 이 파일을 지정된 경로에 저장합니다.

모듈 작성자는 이 cmdlet을 사용하여 모듈의 매니페스트를 만들 수 있습니다. 모듈 매니페스트는 해시 테이블이 포함된 .psd1 파일입니다. 해시 테이블의 키와 값은 모듈의 내용 및 특성을 설명하고, 필수 구성 요소를 정의하고, 구성 요소의 처리 방법을 결정합니다. 매니페스트는 모듈에 필요하지 않습니다.

New-ModuleManifest는 일반적으로 사용되는 매니페스트 키를 모두 포함하는 매니페스트를 만들므로 기본 출력을 매니페스트 템플릿으로 사용할 수 있습니다. 값을 추가 또는 변경하거나 이 cmdlet이 추가하지 않는 모듈 키를 추가하려면 결과 파일을 텍스트 편집기에서 엽니다.

이 cmdlet의 각 매개 변수(Path 및 PassThru 제외)는 모듈 매니페스트 키와 해당 값을 만듭니다. 모듈 매니페스트에서는 ModuleVersion 키만 필요합니다. 그러나 이 cmdlet의 몇 가지 다른 매개 변수는 필수 항목입니다. 따라서 매개 변수 없이 "New-ModuleManifest" 명령을 입력할 수 있으며 이 cmdlet은 일반적으로 사용되는 다른 키의 값을 묻습니다. 값을 비워 두려면 Enter 키를 누르십시오.

모듈 매니페스트의 형식, 결과 및 요구 사항에 대한 자세한 내용은 MSDN(Microsoft Developer Network) 라이브러리의 "How to Write a Module Manifest(모듈 매니페스트 작성 방법)"(https://go.microsoft.com/fwlink/?LinkId=143613)를 참조하십시오.

매개 변수

-AliasesToExport <string[]>

모듈이 내보내는 별칭을 지정합니다. 와일드카드를 사용할 수 있습니다.

이 매개 변수를 사용하여 모듈이 내보내는 별칭을 제한할 수 있습니다. 이 매니페스트 키는 내보내는 별칭의 목록에서 별칭을 제거할 수 있지만 목록에 별칭을 추가할 수는 없습니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 *(모두) 값을 사용하여 AliasesToExport 키를 만듭니다. 이 경우 매니페스트는 모듈에서 내보내는 모든 별칭을 내보냅니다.

필수 여부

false

위치

named

기본값

* (all)

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

true

-Author <string>

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

이 매개 변수는 cmdlet에 필요하지만 Author 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 현재 사용자의 이름을 사용하여 Author 키를 만듭니다.

필수 여부

true

위치

named

기본값

Name of the current user

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ClrVersion <Version>

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

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 CLRVersion 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-CmdletsToExport <string[]>

모듈이 내보내는 cmdlet을 지정합니다. 와일드카드를 사용할 수 있습니다.

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

이 매개 변수를 생략하는 경우 New-ModuleManifest는 *(모두) 값을 사용하여 CmdletsToExport 키를 만듭니다. 이 경우 매니페스트는 모듈에서 내보내는 모든 cmdlet을 내보냅니다.

필수 여부

false

위치

named

기본값

* (all)

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

true

-CompanyName <string>

모듈을 만든 회사나 공급업체를 식별합니다.

이 매개 변수는 cmdlet에 필요하지만 CompanyName 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 "Unknown" 값을 사용하여 CompanyName 키를 만듭니다.

필수 여부

true

위치

named

기본값

"Unknown"

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Copyright <string>

모듈의 저작권 정보를 지정합니다.

이 매개 변수는 cmdlet에 필요하지만 Copyright 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 "(c) <year> <username>. All rights reserved." 값을 사용하여 Copyright 키를 만듭니다. 여기서 <year>는 현재 연도이고 <username>은 Author 키의 값(지정된 경우) 또는 현재 사용자의 이름입니다.

필수 여부

true

위치

named

기본값

(c) <year> <username>. All rights reserved.

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Description <string>

모듈의 내용을 설명합니다.

이 매개 변수는 cmdlet에 필요하지만 Description 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 문자열 값을 사용하여 Description 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-DotNetFrameworkVersion <Version>

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

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 DotNetFrameWorkVersion 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-FileList <string[]>

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

이 키는 모듈 인벤토리 역할을 합니다. 이러한 파일은 모듈과 함께 자동으로 내보내지 않습니다.

이 매개 변수는 cmdlet에 필요하지만 FileList 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 배열 값을 사용하여 FileList 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-FormatsToProcess <string[]>

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

모듈을 가져오는 경우 Windows PowerShell은 지정된 파일을 사용하여 Update-FormatData cmdlet을 실행합니다. 형식 지정 파일의 범위가 없는 경우 세션의 모든 세션 상태에 영향을 줍니다.

이 매개 변수는 cmdlet에 필요하지만 FormatsToProcess 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 배열 값을 사용하여 FormatsToProcess 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-FunctionsToExport <string[]>

모듈이 내보내는 함수를 지정합니다. 와일드카드를 사용할 수 있습니다.

이 매개 변수를 사용하여 모듈이 내보내는 함수를 제한할 수 있습니다. 이 매니페스트 키는 내보내는 함수의 목록에서 함수를 제거할 수 있지만 목록에 함수를 추가할 수는 없습니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 *(모두) 값을 사용하여 FunctionsToExport 키를 만듭니다. 이 경우 매니페스트는 모듈에서 내보내는 모든 함수를 내보냅니다.

필수 여부

false

위치

named

기본값

* (all)

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

true

-Guid <Guid>

모듈의 고유 식별자를 지정합니다. GUID를 사용하여 이름이 같은 모듈을 구별할 수 있습니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 매니페스트에서 GUID 키를 만들고 값에 대한 GUID를 생성합니다.

Windows PowerShell에서 새 GUID를 만들려면 "[guid]::NewGuid()"를 입력합니다.

필수 여부

false

위치

named

기본값

A GUID generated for the module

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ModuleList <Object[]>

이 모듈과 함께 패키지된 모든 모듈을 나열합니다.

각 모듈 이름을 문자열로 입력하거나 ModuleName 및 GUID 키를 사용하여 해시 테이블을 입력하십시오. 해시 테이블에 선택적 ModuleVersion 키가 있을 수도 있습니다.

이 키는 모듈 인벤토리 역할을 합니다. 이러한 모듈은 자동으로 처리되지 않습니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 배열 값을 사용하여 매니페스트에 ModuleList 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ModuleToProcess <string>

모듈의 기본 파일 또는 "루트" 파일을 지정합니다. 모듈을 가져오는 경우 루트 모듈 파일에서 내보낸 멤버를 호출자의 세션 상태로 가져옵니다. 스크립트 모듈(.psm1) 또는 이진 모듈(.dll)의 파일 이름을 입력하십시오.

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

매니페스트가 있는 모듈의 .psm1 또는 .dll 파일에서 멤버를 내보내려면 해당 파일의 이름이 매니페스트에서 ModuleToProcess 또는 NestedModules 키의 값에 지정되어야 합니다. 지정되지 않은 경우 해당 멤버를 내보내지 않습니다.

이 매개 변수는 cmdlet에 필요하지만 ModuleToProcess 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 문자열 값을 사용하여 ModuleToProcess 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ModuleVersion <Version>

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

이 매개 변수는 cmdlet에 필요하지 않지만 ModuleVersion 키는 매니페스트에서 필요합니다. 이 매개 변수를 생략하는 경우 New-ModuleManifest는 "1.0" 값으로 ModuleVersion 키를 만듭니다.

필수 여부

false

위치

named

기본값

1.0

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-NestedModules <string[]>

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

일반적으로 중첩 모듈에는 내부 처리를 위해 루트 모듈에 필요한 명령이 들어 있습니다. 기본적으로 중첩 모듈의 명령을 모듈의 세션 상태에서 호출자의 세션 상태로 내보내지만 루트 모듈은 예를 들어 Export-Module 명령을 사용하여 내보내는 명령을 제한할 수 있습니다.

루트 모듈은 모듈 세션 상태의 중첩 모듈을 사용할 수 있지만 호출자 세션 상태의 Get-Module 명령은 중첩 모듈을 반환하지 않습니다.

NestedModules 키에 나열된 스크립트(.ps1)는 호출자의 세션 상태가 아니라 모듈의 세션 상태에서 실행됩니다. 호출자의 세션 상태에서 스크립트를 실행하려면 매니페스트의 ScriptsToProcess 키 값에 스크립트 파일 이름을 나열하십시오.

이 매개 변수는 cmdlet에 필요하지만 NestedModules 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 배열 값을 사용하여 NestedModules 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PassThru

.psd1 파일을 만들 뿐만 아니라 결과 모듈 매니페스트를 콘솔에 씁니다. 기본적으로 이 cmdlet에서는 출력을 생성하지 않습니다.

필수 여부

false

위치

named

기본값

False

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-Path <string>

새 모듈 매니페스트의 경로와 파일 이름을 지정합니다. 경로와 파일 이름 확장명이 .psd1인 파일 이름을 입력하십시오(예: "$pshome\Modules\MyModule\MyModule.psd1"). 이 매개 변수는 필수 사항입니다.

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

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

참고: Path 매개 변수 값을 묻는 경우 $pshome 또는 $home과 같은 변수를 사용할 수 없습니다. 변수를 사용하려면 명령에 Path 매개 변수를 포함합니다.

필수 여부

true

위치

1

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PowerShellHostName <string>

모듈에 필요한 Windows PowerShell 호스트 프로그램의 이름을 지정합니다. 호스트 프로그램의 이름(예: "Windows PowerShell ISE Host" 또는 "ConsoleHost")을 입력하십시오. 와일드카드는 사용할 수 없습니다.

호스트 프로그램의 이름을 확인하려면 프로그램에서 "$host.name"을 입력합니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 PowerShellHostName 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PowerShellHostVersion <Version>

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

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 PowerShellHostName 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PowerShellVersion <Version>

이 모듈과 작동할 Windows PowerShell의 최소 버전을 지정합니다. 1.0 또는 2.0을 입력하십시오. 2.0보다 높은 버전에 대한 요구 사항은 적용되지 않습니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 PowerShellVersion 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-PrivateData <Object>

모듈을 가져올 때 모듈로 전달되는 데이터를 지정합니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 PrivateData 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ProcessorArchitecture <ProcessorArchitecture>

모듈에 필요한 프로세서 아키텍처를 지정합니다. 유효한 값은 x86, AMD64, IA64 및 None(알 수 없음 또는 지정되지 않음)입니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 문자열 값을 사용하여 ProcessorArchitecture 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-RequiredAssemblies <string[]>

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

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

이 매개 변수는 cmdlet에 필요하지만 RequiredAssemblies 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 배열 값을 사용하여 RequiredAssemblies 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-RequiredModules <Object[]>

전역 세션 상태여야 하는 모듈을 지정합니다. 필요한 모듈이 전역 세션 상태가 아닌 경우 이 모듈을 가져오려고 하면 실패합니다.

각 모듈 이름을 문자열로 입력하거나 ModuleName 및 GUID 키를 사용하여 해시 테이블을 입력하십시오. 해시 테이블에 선택적 ModuleVersion 키가 있을 수도 있습니다. 자세한 내용은 예를 참조하십시오.

Windows PowerShell은 필요한 모듈을 자동으로 가져오지 않으며 필요한 모듈이 있는지만 확인합니다. 그러나 필요한 모듈을 전역 세션 상태로 가져오는 스크립트(.ps1)가 모듈에 포함될 수 있습니다.

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 배열 값을 사용하여 RequiredModules 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-ScriptsToProcess <string[]>

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

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

이 매개 변수를 생략하는 경우 New-ModuleManifest는 빈 배열 값을 사용하여 ScriptsToProcess 키를 만듭니다.

필수 여부

false

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-TypesToProcess <string[]>

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

모듈을 가져오는 경우 Windows PowerShell은 지정된 파일을 사용하여 Update-TypeData cmdlet을 실행합니다. 유형 파일의 범위가 없는 경우 세션의 모든 세션 상태에 영향을 줍니다.

이 매개 변수는 cmdlet에 필요하지만 TypesToProcess 키는 매니페스트에서 필요하지 않습니다. 이 매개 변수를 생략하는 경우 값을 입력하라는 메시지가 나타날 때 값을 입력하지 않으면 New-ModuleManifest가 빈 배열 값을 사용하여 TypesToProcess 키를 만듭니다.

필수 여부

true

위치

named

기본값

없음

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-VariablesToExport <string[]>

모듈이 내보내는 변수를 지정합니다. 와일드카드를 사용할 수 있습니다.

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

이 매개 변수를 생략하는 경우 New-ModuleManifest는 *(모두) 값을 사용하여 VariablesToExport 키를 만듭니다. 이 경우 매니페스트는 모듈에서 내보내는 모든 변수를 내보냅니다.

필수 여부

false

위치

named

기본값

* (all)

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

true

-Confirm

명령을 실행하기 전에 확인 메시지를 표시합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

-WhatIf

명령을 실제로 실행하지 않고도 명령이 실행될 경우 발생할 수 있는 현상을 설명합니다.

필수 여부

false

위치

named

기본값

파이프라인 입력 적용 여부

false

와일드카드 문자 적용 여부

false

<CommonParameters>

이 cmdlet은 -Verbose, -Debug, -ErrorAction, -ErrorVariable, -OutBuffer, -OutVariable 등의 일반 매개 변수를 지원합니다. 자세한 내용은 about_Commonparameters.

입력 및 출력

입력 유형은 cmdlet으로 파이프할 수 있는 개체의 유형입니다. 반환 유형은 cmdlet에서 반환되는 개체의 유형입니다.

입력

없음

입력을 이 cmdlet으로 파이프할 수 없습니다.

출력

없음 또는 System.String

기본적으로 New-ModuleManifest는 출력을 생성하지 않습니다. 그러나 PassThru 매개 변수를 사용하는 경우 이 명령은 모듈 매니페스트를 나타내는 System.String 개체를 생성합니다.

참고

모듈 매니페스트는 대개 선택 사항입니다. 그러나 모듈 매니페스트는 전역 어셈블리 캐시에 설치되는 어셈블리를 내보내는 데 필요합니다.

$pshome\Modules 디렉터리(%Windir%\System32\WindowsPowerShell\v1.0\Modules)에 파일을 추가하거나 변경하려면 "관리자 권한으로 실행" 옵션을 사용하여 Windows PowerShell을 시작합니다.

"세션"은 Windows PowerShell 실행 환경 인스턴스입니다. 한 세션에 하나 이상의 세션 상태가 있을 수 있습니다. 기본적으로 세션에는 하나의 전역 세션 상태만 있지만 가져온 각 모듈에 해당 세션 상태가 있습니다. 세션 상태를 사용하면 모듈의 명령이 전역 세션 상태에 영향을 주지 않고 실행될 수 있습니다.

"호출자 세션 상태"는 모듈을 가져오는 세션 상태입니다. 일반적으로 전역 세션 상태를 나타내지만 모듈이 중첩 모듈을 가져오는 경우 "호출자"는 모듈이고 "호출자 세션 상태"는 모듈의 세션 상태입니다.

예 1

C:\PS>New-ModuleManifest

Path: C:\Users\User01\Documents\WindowsPowerShell\Modules\Test-Module\Test-Module.psd1
NestedModules[0]: BackgroundModule.psm1
Author: Jinghao Liu
CompanyName: Fabrikam, Inc.
Copyright: Copyright © 2009 Liu Jinghao. All rights reserved.
ModuleToProcess: TestModule.psm1
Description: Cmdlets to find common errors in scripts.
TypesToProcess[0]: TestTypes.ps1xml
FormatsToProcess[0]: TestFormat.ps1xml
RequiredAssemblies[0]: Test.dll
FileList[0]: Test-Module.psd1
FileList[1]: Test-Module.psm1
FileList[2]: BackgroundModule.psm1
FileList[3]: TestTypes.ps1xml
FileList[4]: TestFormat.ps1xml
FileList[5]: Test.dll
FileList[6]: TestIcon.ico

설명
-----------
이 명령은 새 모듈 매니페스트를 만듭니다. 이 cmdlet은 Path 매개 변수를 비롯하여 필요한 매개 변수를 묻고 지정된 위치에 매니페스트 파일을 만듭니다.

이 명령의 출력에 필요한 매개 변수를 묻는 메시지에 대한 샘플 응답이 나와 있습니다. 기본값을 사용하려면 Enter 키를 누릅니다.

실제 묻는 메시지와 따옴표로 묶은 구절 및 따옴표로 묶지 않은 구절의 처리는 Windows PowerShell이 실행되는 호스트 프로그램에 따라 다릅니다.






예 2

C:\PS>New-ModuleManifest -PowerShellVersion 1.0 -AliasesToExport JKBC, DRC, TAC

설명
-----------
이 명령은 새 모듈 매니페스트를 만듭니다. 이 명령에는 cmdlet이 필요로 하지 않는(또는 묻지 않는) 매개 변수가 포함되어 있습니다. 묻는 메시지에서 다른 매니페스트 키 값을 포함할 수 있습니다.






예 3

C:\PS>New-ModuleManifest -RequiredModules FileTransfer,@{ModuleName="BackgroundModule";GUID="486569a2-2784-48bf-af15-70ba837a64d0";ModuleVersion="3.5"}

설명
-----------
이 예에서는 RequiredModules 매개 변수 값의 문자열 및 해시 테이블 형식을 사용하는 방법을 보여 줍니다. 같은 명령에서 문자열과 해시 테이블을 사용할 수 있습니다. 

이 명령은 FileTransfer 모듈과 "BackgroundModule"이라는 가상의 모듈이 필요한 모듈에 대한 모듈 매니페스트를 만듭니다. 

이 명령은 문자열 형식을 사용하여 FileTransfer 모듈의 이름을 지정하고 해시 테이블 형식을 사용하여 BackgroundModule의 이름, GUID 및 버전을 지정합니다.






참고 항목




목차