다음을 통해 공유


Publish-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-PSResource cmdlet에 대한 프록시 cmdlet입니다. 자세한 내용은 Publish-PSResource를 참조하세요.

예제

예제 1: 모듈 게시

이 예제에서 MyDscModule 은 API 키를 사용하여 모듈 소유자의 온라인 갤러리 계정을 표시하여 온라인 갤러리에 게시됩니다. MyDscModule이 이름, 버전, 설명 및 작성자를 지정하는 유효한 매니페스트 모듈이 아니면 오류가 발생합니다.

Publish-Module -Path c:\projects\MyDscModule\1.0.0 -NuGetApiKey "11e4b435-6cb4-4bf7-8611-5162ed75eb73"

예제 2: 갤러리 메타데이터를 사용하여 모듈 게시

이 예제에서 MyDscModule 은 API 키를 사용하여 모듈 소유자의 갤러리 계정을 표시하여 온라인 갤러리에 게시됩니다. 제공된 추가 메타데이터는 갤러리의 모듈에 대한 웹 페이지에 표시됩니다. 소유자는 Active Directory와 관련된 두 개의 검색 태그를 모듈에 추가합니다. 간단한 릴리스 메모가 추가됩니다. MyDscModule이 이름, 버전, 설명 및 작성자를 지정하는 유효한 매니페스트 모듈이 아니면 오류가 발생합니다.

$parameters = @{
    Path        = 'c:\projects\MyDscModule\1.0.0'
    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.'
}
Publish-Module @parameters

매개 변수

-AllowPrerelease

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식: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

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:

String[]

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

매개 변수 집합

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

-Force

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-FormatVersion

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-IconUri

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-LicenseUri

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-Name

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-NuGetApiKey

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

프록시 cmdlet은 이 매개 변수를 의 ApiKey 매개 변수에 매핑합니다 Publish-PSResource.

매개 변수 속성

형식: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

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-ReleaseNotes

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:

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

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-SkipAutomaticTags

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

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

매개 변수 집합

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

-Tags

프록시 cmdlet은 이 매개 변수가 지원 Publish-PSResource되지 않으므로 무시합니다.

매개 변수 속성

형식:

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

참고

PowerShell에는 Publish-Module에 대한 다음과 같은 별칭들이 포함되어 있습니다.

  • 모든 플랫폼:
    • pumo

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

PowerShell 갤러리는 더 이상 TLS(전송 계층 보안) 버전 1.0 및 1.1을 지원하지 않습니다. TLS 1.2 이상을 사용해야 합니다. 다음 명령을 사용하여 TLS 1.2를 사용하고 있는지 확인합니다.

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

모듈을 게시하려면 모듈의 갤러리 페이지에 표시되는 메타데이터가 필요합니다. 필수 메타데이터에는 모듈 이름, 버전, 설명 및 작성자가 포함됩니다. 메타데이터는 모듈 매니페스트에 정의되어야 합니다. 자세한 내용은 PowerShell 갤러리 UI영향을 주는 패키지 매니페스트 값을 참조하세요.