Publish-Module

Modül:

PowerShellGet v3 Module

Belirtilen modülü yerel bilgisayardan çevrimiçi bir galeride yayımlar.

Sözdizimi

ModuleNameParameterSet EnterprisePublishing

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'i, galerideki bir kullanıcı profilinin parçası olarak depolanan bir API anahtarı kullanarak bir modülü çevrimiçi NuGet tabanlı bir galeride yayımlar. Modülün yayımlanması için modülün adını veya modülü içeren klasörün yolunu belirtebilirsiniz.

Bu, Publish-PSResource içindeki cmdlet için bir proxy cmdlet'idir. Daha fazla bilgi için bkz . Publish-PSResource.

Örnekler

Örnek 1: Modül yayımlama

Bu örnekte MyDscModule , modül sahibinin çevrimiçi galeri hesabını belirtmek için API anahtarı kullanılarak çevrimiçi galeride yayımlanır. MyDscModule ad, sürüm, açıklama ve yazar belirten geçerli bir bildirim modülü değilse bir hata oluşur.

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

Örnek 2: Galeri meta verileriyle modül yayımlama

Bu örnekte MyDscModule , modül sahibinin galeri hesabını göstermek için API anahtarı kullanılarak çevrimiçi galeride yayımlanır. Sağlanan ek meta veriler, galerideki modülün web sayfasında görüntülenir. Sahip, modül için Active Directory ile ilişkili iki arama etiketi ekler; kısa bir sürüm notu eklenir. MyDscModule ad, sürüm, açıklama ve yazar belirten geçerli bir bildirim modülü değilse bir hata oluşur.

$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

Parametreler

-AllowPrerelease

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ModuleNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Confirm

Publish-Moduleçalıştırmadan önce sizden onay ister.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Cf

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Credential

Belirtilen paket sağlayıcısı veya kaynağı için modül yayımlama haklarına sahip bir kullanıcı hesabı belirtir.

Parametre özellikleri

Tür:	PSCredential
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Exclude

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ModuleNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Force

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-FormatVersion

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	Version
Default value:	None
Kabul edilen değerler:	2.0
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-IconUri

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-LicenseUri

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Name

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ModuleNameParameterSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-NuGetApiKey

Bir modülü çevrimiçi galeride yayımlamak için kullanmak istediğiniz API anahtarını belirtir. API anahtarı, çevrimiçi galerideki profilinizin bir parçasıdır ve galerideki kullanıcı hesabı sayfanızda bulunabilir. API anahtarı NuGet'e özgü işlevselliktir.

Proxy cmdlet'i bu parametreyi apikey parametresiyle eşler Publish-PSResource.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Path

Yayımlamak istediğiniz modülün yolunu belirtir. Bu parametre, modülü içeren klasörün yolunu kabul eder. Klasörün adı modülle aynı olmalıdır.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ModulePathParameterSet

Position:	Named
Zorunlu:	True
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	True
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ProjectUri

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	Uri
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-ReleaseNotes

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Repository

çalıştırılarak Register-PSRepositorykaydedilmiş bir deponun kolay adını belirtir. Deponun geçerli bir NuGet URI'si olan PublishLocationolması gerekir. PublishLocationSet-PSRepositoryçalıştırılarak ayarlanabilir.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-RequiredVersion

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	String
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

ModuleNameParameterSet

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-SkipAutomaticTags

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-Tags

proxy cmdlet'i tarafından Publish-PSResourcedesteklenmediğinden bu parametreyi yoksayar.

Parametre özellikleri

Tür:	String[]
Default value:	None
Joker karakterleri destekler:	False
DontShow:	False

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

-WhatIf

Publish-Module çalıştırıldığında ne olacağını gösterir. Cmdlet çalıştırılmaz.

Parametre özellikleri

Tür:	SwitchParameter
Default value:	False
Joker karakterleri destekler:	False
DontShow:	False
Diğer adlar:	Wi

Parametre kümeleri

(All)

Position:	Named
Zorunlu:	False
İşlem hattından gelen değer:	False
Özellik adına göre işlem hattından gelen değer:	False
Kalan bağımsız değişkenlerden elde edilen değer:	False

CommonParameters

Bu cmdlet yaygın parametreleri destekler: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction ve -WarningVariable. Daha fazla bilgi için bkz. about_CommonParameters.

Girişler

String

PSCredential

Çıkışlar

Object

Notlar

PowerShell, Publish-Moduleiçin aşağıdaki diğer adları içerir:

• Tüm platformlar:
  • pumo

Publish-Module, PowerShell'in PowerShell 3.0 veya sonraki sürümlerinde, Windows 7 veya Windows 2008 R2 ve sonraki Windows sürümlerinde çalışır.

PowerShell Galerisi artık Aktarım Katmanı Güvenliği (TLS) 1.0 ve 1.1 sürümlerini desteklememektedir. TLS 1.2 veya üzerini kullanmanız gerekir. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

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

Modülü yayımlamak için, modülün galeri sayfasında görüntülenen meta veriler gerekir. Gerekli meta veriler modül adını, sürümünü, açıklamasını ve yazarını içerir. Meta veriler modül bildiriminde tanımlanmalıdır. Daha fazla bilgi için bkz.PowerShell Galerisi kullanıcı arabirimini etkileyen paket bildirim değerlerini .

İlişkili Bağlantılar

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