Publish-Module

모듈:

PowerShellGet Module

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

구문

ModuleNameParameterSet (기본값)

Publish-Module
    -Name <String>
    [-RequiredVersion <String>]
    [-NuGetApiKey <String>]
    [-Repository <String>]
    [-Credential <PSCredential>]
    [-FormatVersion <Version>]
    [-ReleaseNotes <String[]>]
    [-Tags <String[]>]
    [-LicenseUri <Uri>]
    [-IconUri <Uri>]
    [-ProjectUri <Uri>]
    [-Exclude <String[]>]
    [-Force]
    [-AllowPrerelease]
    [-SkipAutomaticTags]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

ModulePathParameterSet

Publish-Module
    -Path <String>
    [-NuGetApiKey <String>]
    [-Repository <String>]
    [-Credential <PSCredential>]
    [-FormatVersion <Version>]
    [-ReleaseNotes <String[]>]
    [-Tags <String[]>]
    [-LicenseUri <Uri>]
    [-IconUri <Uri>]
    [-ProjectUri <Uri>]
    [-Force]
    [-SkipAutomaticTags]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Publish-Module cmdlet은 갤러리에서 사용자 프로필의 일부로 저장된 API 키를 사용하여 온라인 NuGet 기반 갤러리에 모듈을 게시합니다. 모듈의 이름 또는 모듈이 포함된 폴더의 경로로 게시할 모듈을 지정할 수 있습니다.

이름으로 모듈을 지정하면 Publish-ModuleGet-Module -ListAvailable <Name>실행하여 찾을 수 있는 첫 번째 모듈을 게시합니다. 게시할 모듈의 최소 버전을 지정하는 경우 Publish-Module 지정한 최소 버전보다 크거나 같은 버전으로 첫 번째 모듈을 게시합니다.

모듈을 게시하려면 모듈의 갤러리 페이지에 표시되는 메타데이터가 필요합니다. 필수 메타데이터에는 모듈 이름, 버전, 설명 및 작성자가 포함됩니다. 대부분의 메타데이터는 모듈 매니페스트에서 가져온 것이지만, 이러한 매개 변수는 NuGet 기반 갤러리의 Publish-Module 필드와 일치하기 때문에 태그, ReleaseNote, IconUri, ProjectUri 및 LicenseUri와 같은 매개 변수에 일부 메타데이터를 지정해야 합니다.

예제

예제 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 "http://contoso.com/license" -Tag "Active Directory","DSC" -ReleaseNote "Updated the ActiveDirectory DSC Resources to support adding users."

매개 변수

-AllowPrerelease

시험판으로 표시된 모듈을 게시할 수 있습니다.

매개 변수 속성

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

매개 변수 집합

ModuleNameParameterSet

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

-Confirm

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

매개 변수 속성

형식:	SwitchParameter
Default value:	False
와일드카드 지원:	False
DontShow:	False
별칭:	cf(cf)

매개 변수 집합

(All)

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

-Credential

지정된 패키지 공급자 또는 원본에 대한 모듈을 게시할 권한이 있는 사용자 계정을 지정합니다.

매개 변수 속성

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

매개 변수 집합

(All)

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

-Exclude

게시된 모듈에서 제외할 파일을 정의합니다.

매개 변수 속성

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

매개 변수 집합

ModuleNameParameterSet

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

-Force

사용자 확인을 요청하지 않고 명령을 강제로 실행합니다.

매개 변수 속성

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

매개 변수 집합

(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

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

매개 변수 속성

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

매개 변수 집합

ModuleNameParameterSet

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

-SkipAutomaticTags

명령 및 리소스가 태그로 포함되지 않도록 제거합니다. 모듈에 태그를 자동으로 추가하는 것을 건너뜁니다.

매개 변수 속성

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

매개 변수 집합

(All)

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를 참조하세요.

입력

String

PSCredential

출력

Object

참고

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

중요합니다

2020년 4월부터 PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용하지 않는 경우 PowerShell 갤러리에 액세스하려고 할 때 오류가 발생합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

자세한 내용은 PowerShell 블로그의 공지 참조하세요.

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

관련 링크

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