Publish-Module
로컬 컴퓨터에서 온라인 갤러리로 지정된 모듈을 게시합니다.
구문
Publish-Module
-Name <String>
[-RequiredVersion <Version>]
-NuGetApiKey <String>
[-Repository <String>]
[-FormatVersion <Version>]
[-ReleaseNotes <String[]>]
[-Tags <String[]>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ProjectUri <Uri>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Publish-Module
-Path <String>
-NuGetApiKey <String>
[-Repository <String>]
[-FormatVersion <Version>]
[-ReleaseNotes <String[]>]
[-Tags <String[]>]
[-LicenseUri <Uri>]
[-IconUri <Uri>]
[-ProjectUri <Uri>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]Description
Publish-Module cmdlet은 갤러리에서 사용자 프로필의 일부로 저장된 API 키를 사용하여 온라인 NuGet 기반 갤러리에 모듈을 게시합니다. 모듈의 이름 또는 모듈이 포함된 폴더의 경로로 게시할 모듈을 지정할 수 있습니다.
이름으로 모듈을 지정하면 Publish-ModuleGet-Module -ListAvailable <Name>실행하여 찾을 수 있는 첫 번째 모듈을 게시합니다. 게시할 모듈의 최소 버전을 지정하는 경우 Publish-Module 지정한 최소 버전보다 크거나 같은 버전으로 첫 번째 모듈을 게시합니다.
예제
예제 1: 모듈 게시
이 예제에서 MyDscModule은 API 키를 사용하여 모듈 소유자의 온라인 갤러리 계정을 표시하여 온라인 갤러리에 게시됩니다. MyDscModule이 이름, 버전, 설명 및 작성자를 지정하는 유효한 매니페스트 모듈이 아니면 오류가 발생합니다.
Publish-Module -Name "MyDscModule" -NuGetApiKey "11e4b435-6cb4-4bf7-8611-5162ed75eb73"예제 2: 갤러리 메타데이터를 사용하여 모듈 게시
이 예제에서 MyDscModule은 API 키를 사용하여 모듈 소유자의 갤러리 계정을 표시하여 온라인 갤러리에 게시됩니다. 제공된 추가 메타데이터는 갤러리의 모듈에 대한 웹 페이지에 표시됩니다. 소유자는 Active Directory와 관련된 두 개의 검색 태그를 모듈에 추가합니다. 간단한 릴리스 메모가 추가됩니다. MyDscModule이 이름, 버전, 설명 및 작성자를 지정하는 유효한 매니페스트 모듈이 아니면 오류가 발생합니다.
Publish-Module -Name "MyDscModule" -NuGetApiKey "11e4b435-6cb4-4bf7-8611-5162ed75eb73" -LicenseUri "https://contoso.com/license" -Tag "Active Directory","DSC" -ReleaseNote "Updated the ActiveDirectory DSC Resources to support adding users."매개 변수
-Confirm
Publish-Module실행하기 전에 확인 메시지를 표시합니다.
| 형식: | SwitchParameter |
| 별칭: | cf |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-FormatVersion
ValidateSet 특성에 지정된 유효한 값만 허용합니다.
자세한 내용은 ValidateSet 특성 선언 및 ValidateSetAttribute참조하세요.
| 형식: | Version |
| 허용되는 값: | 2.0 |
| 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 |
-Name
게시할 모듈의 이름을 지정합니다.
Publish-Module
$Env:PSModulePath지정된 모듈 이름을 검색합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-NuGetApiKey
모듈을 온라인 갤러리에 게시하는 데 사용할 API 키를 지정합니다. API 키는 온라인 갤러리에서 프로필의 일부이며 갤러리의 사용자 계정 페이지에서 찾을 수 있습니다. API 키는 NuGet 관련 기능입니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Path
게시할 모듈의 경로를 지정합니다. 이 매개 변수는 모듈이 포함된 폴더의 경로를 허용합니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | True |
| 파이프라인 입력 허용: | True |
| 와일드카드 문자 허용: | False |
-ProjectUri
이 프로젝트에 대한 웹 페이지의 URL을 지정합니다.
| 형식: | Uri |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-ReleaseNotes
이 모듈 버전의 사용자가 사용할 수 있도록 하려는 릴리스 정보 또는 주석이 포함된 문자열을 지정합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Repository
Register-PSRepository실행하여 등록된 리포지토리의 이름을 지정합니다. 리포지토리에는 유효한 NuGet URI인 PublishLocation있어야 합니다.
PublishLocationSet-PSRepository실행하여 설정할 수 있습니다.
| 형식: | String |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-RequiredVersion
게시할 단일 모듈의 정확한 버전을 지정합니다.
| 형식: | Version |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-Tags
게시하는 모듈에 하나 이상의 태그를 추가합니다. 예제 태그에는 DesiredStateConfiguration, DSC, DSCResourceKit 또는 PSModule이 포함됩니다. 여러 태그를 쉼표로 구분합니다.
| 형식: | String[] |
| Position: | Named |
| Default value: | None |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
-WhatIf
Publish-Module 실행될 경우 어떤 일이 발생하는지 표시합니다. cmdlet이 실행되지 않습니다.
| 형식: | SwitchParameter |
| 별칭: | wi |
| Position: | Named |
| Default value: | False |
| 필수: | False |
| 파이프라인 입력 허용: | False |
| 와일드카드 문자 허용: | False |
입력
PSModuleInfo
출력
None
모듈이 성공적으로 게시되면 Publish-Module 출력이 표시되지 않습니다.
참고
Publish-Module PowerShell의 PowerShell 3.0 이상 릴리스, Windows 7 또는 Windows 2008 R2 이상 릴리스에서 실행됩니다.
모듈을 게시하려면 모듈의 갤러리 페이지에 표시되는 메타데이터가 필요합니다. 필수 메타데이터에는 모듈 이름, 버전, 설명 및 작성자가 포함됩니다. 대부분의 메타데이터는 모듈 매니페스트에서 가져온 것이지만 태그, ReleaseNote, IconUri, ProjectUri및 LicenseUri같은 일부 메타데이터를 Publish-Module 매개 변수에 지정할 수 있습니다. 자세한 내용은 PowerShell 갤러리 UI영향을 주는