Publish-Module

모듈:

PowerShellGet Module

로컬 컴퓨터에서 온라인 갤러리로 지정된 모듈을 게시합니다.

구문

ModuleNameParameterSet (기본값)

Publish-Module
    -Name <String>
    -NuGetApiKey <String>
    [-RequiredVersion <Version>]
    [-Repository <String>]
    [-FormatVersion <Version>]
    [-ReleaseNotes <String[]>]
    [-Tags <String[]>]
    [-LicenseUri <Uri>]
    [-IconUri <Uri>]
    [-ProjectUri <Uri>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ModulePathParameterSet

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
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-FormatVersion

ValidateSet 특성에 지정된 유효한 값만 허용합니다.

자세한 내용은 ValidateSet 특성 선언 및 ValidateSetAttribute참조하세요.

매개 변수 속성

형식:	Version
Default value:	None
허용되는 값:	2.0
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-IconUri

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

매개 변수 속성

형식:	Uri
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-LicenseUri

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

매개 변수 속성

형식:	Uri
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Name

게시할 모듈의 이름을 지정합니다. Publish-Module $Env:PSModulePath지정된 모듈 이름을 검색합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ModuleNameParameterSet

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-NuGetApiKey

모듈을 온라인 갤러리에 게시하는 데 사용할 API 키를 지정합니다. API 키는 온라인 갤러리에서 프로필의 일부이며 갤러리의 사용자 계정 페이지에서 찾을 수 있습니다. API 키는 NuGet 관련 기능입니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Path

게시할 모듈의 경로를 지정합니다. 이 매개 변수는 모듈이 포함된 폴더의 경로를 허용합니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ModulePathParameterSet

Position:	Named
필수:	True
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	True
나머지 인수의 값:	False

-ProjectUri

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

매개 변수 속성

형식:	Uri
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-ReleaseNotes

이 모듈 버전의 사용자가 사용할 수 있도록 하려는 릴리스 정보 또는 주석이 포함된 문자열을 지정합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Repository

실행 Register-PSRepository하여 등록된 리포지토리의 이름을 지정합니다. 리포지토리에는 유효한 NuGet URI인 PublishLocation있어야 합니다. PublishLocationSet-PSRepository실행하여 설정할 수 있습니다.

매개 변수 속성

형식:	String
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-RequiredVersion

게시할 단일 모듈의 정확한 버전을 지정합니다.

매개 변수 속성

형식:	Version
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

ModuleNameParameterSet

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-Tags

게시하는 모듈에 하나 이상의 태그를 추가합니다. 예제 태그에는 DesiredStateConfiguration, DSC, DSCResourceKit 또는 PSModule이 포함됩니다. 여러 태그를 쉼표로 구분합니다.

매개 변수 속성

형식:	String[]
Default value:	None
와일드카드 지원:	False
DontShow:	False

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

-WhatIf

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	위스콘신

매개 변수 집합

(All)

Position:	Named
필수:	False
파이프라인의 값:	False
속성 이름별 파이프라인의 값:	False
나머지 인수의 값:	False

CommonParameters

이 cmdlet은 일반적인 매개 변수인 -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction 및 -WarningVariable 매개 변수를 지원합니다. 자세한 내용은 about_CommonParameters를 참조하세요.

입력

PSModuleInfo

출력

None

모듈이 성공적으로 게시되면 Publish-Module 출력이 표시되지 않습니다.

참고

Publish-Module PowerShell의 PowerShell 3.0 이상 릴리스, Windows 7 또는 Windows 2008 R2 이상 릴리스에서 실행됩니다.

모듈을 게시하려면 모듈의 갤러리 페이지에 표시되는 메타데이터가 필요합니다. 필수 메타데이터에는 모듈 이름, 버전, 설명 및 작성자가 포함됩니다. 대부분의 메타데이터는 모듈 매니페스트에서 가져온 것이지만 Publish-Module, ReleaseNote, IconUri, ProjectUri및 LicenseUri같은 일부 메타데이터를 매개 변수에 지정할 수 있습니다. 자세한 내용은 PowerShell 갤러리 UI영향을 주는 패키지 매니페스트 값을 참조하세요.

관련 링크

• Find-Module
• Install-Module
• Register-PSRepository
• Set-PSRepository
• Uninstall-Module
• Update-Module