다음을 통해 공유

Publish-Module

  • 참조
모듈:
PowerShellGet

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

구문

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>]
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

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

Microsoft.PowerShell.PSResourceGet의 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
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Confirm

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

형식:SwitchParameter
별칭:cf
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Credential

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

형식:PSCredential
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-Exclude

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

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Force

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

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-FormatVersion

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

형식:Version
허용되는 값:2.0
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-IconUri

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

형식:Uri
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-LicenseUri

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

형식:Uri
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Name

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-NuGetApiKey

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

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Path

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

형식:String
Position:Named
Default value:None
필수:True
파이프라인 입력 허용:True
와일드카드 문자 허용:False

-ProjectUri

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

형식:Uri
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-ReleaseNotes

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

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Repository

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-RequiredVersion

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

형식:String
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-SkipAutomaticTags

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

형식:SwitchParameter
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-Tags

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

형식:String[]
Position:Named
Default value:None
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

-WhatIf

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

형식:SwitchParameter
별칭:wi
Position:Named
Default value:False
필수:False
파이프라인 입력 허용:False
와일드카드 문자 허용:False

입력

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에 영향을 주는 패키지 매니페스트 값을 참조하세요.