Publish-Module
Belirtilen modülü yerel bilgisayardan çevrimiçi bir galeriye yayımlar.
Syntax
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
Publish-Module
Cmdlet, galerideki kullanıcı profilinin parçası olarak depolanan bir API anahtarı kullanarak çevrimiçi NuGet tabanlı bir galeride bir modül yayımlar. Yayımlamak için modülü modülün adına veya modülü içeren klasörün yoluna göre belirtebilirsiniz.
Ada göre bir modül belirttiğinizde, Publish-Module
çalıştırılarak Get-Module -ListAvailable <Name>
bulunacak 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ı içerir. Meta verilerin çoğu modül bildiriminden alınsa da, bu parametreler NuGet tabanlı bir galerideki Publish-Module
alanlarla eşleşdiğinden Tag, ReleaseNote, IconUri, ProjectUri ve LicenseUri gibi parametrelerde bazı meta veriler belirtilmelidir.
Örnekler
Örnek 1: Modül yayımlama
Bu örnekte MyDscModule, modül sahibinin çevrimiçi galeri hesabını göstermek 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.
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."
Parametreler
-AllowPrerelease
Yayın öncesi olarak işaretlenmiş modüllerin yayımlanmasına izin verir.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
komutunu çalıştırmadan Publish-Module
önce sizden onay ister.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Credential
Belirtilen paket sağlayıcısı veya kaynağı için modül yayımlama haklarına sahip bir kullanıcı hesabı belirtir.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Exclude
Yayımlanan modülün dışında tutulacak dosyaları tanımlar.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Force
Komutu, kullanıcı onayı istemeden çalışmaya zorlar.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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.
Type: | Version |
Accepted values: | 2.0 |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-IconUri
Modül için bir simgenin URL'sini belirtir. Belirtilen simge, modülün galeri web sayfasında görüntülenir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-LicenseUri
Yayımlamak istediğiniz modülün lisans koşullarının URL'sini belirtir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Yayımlamak istediğiniz modülün adını belirtir. Publish-Module
içinde $Env:PSModulePath
belirtilen modül adını arar.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | 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.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Path
Yayımlamak istediğiniz modülün yolunu belirtir. Bu parametre, modülü içeren klasörün yolunu kabul eder.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-ProjectUri
Bu projeyle ilgili bir web sayfasının URL'sini belirtir.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ReleaseNotes
Modülün bu sürümünü kullananlar için kullanılabilir olmasını istediğiniz sürüm notlarını veya açıklamalarını içeren bir dizeyi belirtir.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Repository
çalıştırılarak Register-PSRepository
kaydedilmiş bir deponun kolay adını belirtir. Deponun geçerli bir NuGet URI'sine sahip bir PublishLocation değeri olmalıdır.
PublishLocation, çalıştırılarak Set-PSRepository
ayarlanabilir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-RequiredVersion
Yayımlayacak tek bir modülün tam sürümünü belirtir.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SkipAutomaticTags
Komutları ve kaynakları etiket olarak dahil edilmekten kaldırır. Bir modüle otomatik olarak etiket eklemeyi atlar.
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tags
Yayımladığınız modüle bir veya daha fazla etiket ekler. Örnek etiketler şunlardır: DesiredStateConfiguration, DSC, DSCResourceKit veya PSModule. Birden çok etiketi virgülle ayırın.
Type: | String[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Çalıştırılırsa Publish-Module
ne olacağını gösterir. Cmdlet çalıştırılmaz.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Girişler
Çıkışlar
Notlar
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 erişmeye çalışırken bir 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 blogundaki duyuruya 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ı içerir. Meta verilerin çoğu modül bildiriminden alınır, ancak Tag, ReleaseNote, IconUri, ProjectUri ve LicenseUri gibi parametrelerde Publish-Module
bazı meta veriler belirtilebilir. Daha fazla bilgi için bkz. PowerShell Galerisi kullanıcı arabirimini etkileyen paket bildirim değerleri.