Publish-Module

  • Başvuru
Modül:
PowerShellGet

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

cmdlet'i Publish-Module , galerideki bir kullanıcının profilinin parçası olarak depolanan bir API anahtarı kullanarak çevrimiçi NuGet tabanlı bir galeride bir modül yayımlar. Yayımlanması için modülü modülün adına veya modülü içeren klasörün yoluna göre belirtebilirsiniz.

Bu, Microsoft.PowerShell.PSResourceGet içindeki cmdlet için Publish-PSResource 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ı 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 -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 ilgili 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.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

ç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

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Force

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-FormatVersion

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

Type:Version
Accepted values:2.0
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-IconUri

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

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LicenseUri

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

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Name

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

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.

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

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. Klasörün adı modülle aynı olmalıdır.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ProjectUri

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

Type:Uri
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ReleaseNotes

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

çalıştırılarak Register-PSRepositorykaydedilmiş 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-PSRepositoryayarlanabilir.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RequiredVersion

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipAutomaticTags

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tags

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

Çalıştırıldığında 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

String

PSCredential

Çıkışlar

Object

Notlar

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

  • Tüm platformlar:
    • pumo

Publish-Module , Windows 7 veya Windows 2008 R2 ve sonraki Windows sürümlerinde PowerShell'in PowerShell 3.0 veya sonraki 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

Bir 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 bildirimi değerleri.