Publish-Module

Modül:

PowerShellGet Module

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

Syntax

ModuleNameParameterSet (Varsayılan)

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.

Bir modülü ada göre belirttiğinizde, Publish-ModuleGet-Module -ListAvailable <Name>çalıştırılarak bulunabilecek ilk modülü yayımlar. Yayımlamak üzere bir modülün en düşük sürümünü belirtirseniz, Publish-Module ilk modülü belirttiğiniz en düşük sürümden büyük veya buna eşit bir sürümle yayımlar.

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 verilerin çoğu modül bildiriminden alınsa da, bu parametreler NuGet tabanlı bir galerideki Publish-Module alanlarla eşleştiğinden, bazı meta verilerin Tag, ReleaseNote, IconUri, ProjectUri ve LicenseUri gibi parametrelerde belirtilmesi gerekir.

Modül sürüm numaralarını alan parametreler, sürüm numaraları olarak biçimlendirilmiş dizeler bekler.

• Standart sürüm numaralarının x.y.z biçimi x, y ve z sayıdır
• Yayın öncesi sürümler, bu sürüme rastgele dizenin atandığı x.y.z-<prerelease_label> bir biçime <prerelease_label> sahiptir.

Ö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 -Name "MyDscModule" -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 = @{
    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."
}
Publish-Module @parameters

Parametreler

-AllowPrerelease

Yayın öncesi olarak işaretlenmiş modüllerin yayımlanmasına izin verir.

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

Yayımlanan modülün dışında tutulacak dosyaları tanımlar.

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

Komutu, kullanıcı onayı istemeden çalışmaya zorlar.

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

Yalnızca ValidateSet özniteliği tarafından belirtilen geçerli değerleri kabul eder.

Daha fazla bilgi için bkz. ValidateSet Öznitelik Bildirimi ve ValidateSetAttribute.

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

Modül için bir simgenin URL'sini belirtir. Belirtilen simge, modülün galeri web sayfasında görüntülenir.

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

Yayımlamak istediğiniz modülün lisans koşullarının URL'sini belirtir.

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

Yayımlamak istediğiniz modülün adını belirtir. Publish-Module, $Env:PSModulePathiçinde belirtilen modül adını arar.

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.

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

Bu projeyle ilgili bir web sayfasının URL'sini belirtir.

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

Modülün bu sürümünün kullanıcılarına sunulmasını istediğiniz sürüm notlarını veya açıklamaları içeren bir dizeyi belirtir.

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

Yayımlanması gereken tek bir modülün tam sürümünü belirtir.

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

Komutların ve kaynakların etiket olarak eklenmesini kaldırır. Modüle otomatik olarak etiket eklemeyi atlar.

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

Yayımladığınız modüle bir veya daha fazla etiket ekler. Örnek etiketler: DesiredStateConfiguration, DSC, DSCResourceKit veya PSModule. Birden çok etiketi virgülle ayırın.

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.

Önemli

Nisan 2020 itibarıyla 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 kullanmıyorsanız PowerShell Galerisi'ne erişmeye çalışırken hata alırsınız. TLS 1.2 kullandığınızdan emin olmak için aşağıdaki komutu kullanın:

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

Daha fazla bilgi için PowerShell blogunda duyuru bakın.

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 verilerin çoğu modül bildiriminden alınır, ancak Publish-Module, ReleaseNote, IconUri, ProjectUrive LicenseUrigibi bazı meta veriler parametrelerinde belirtilebilir. 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