Publish-Module

Reference

Modul:: PowerShellGet

Publikuje zadaný modul z místního počítače do online galerie.

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

Rutina Publish-Module publikuje modul do online galerie založené na NuGetu pomocí klíče rozhraní API uloženého jako součást profilu uživatele v galerii. Modul, který se má publikovat, můžete zadat buď podle názvu modulu, nebo podle cesty ke složce obsahující modul.

Když zadáte modul podle názvu, Publish-Module publikuje první modul, který by byl nalezen spuštěním Get-Module -ListAvailable <Name>příkazu . Pokud zadáte minimální verzi modulu, který se má publikovat, Publish-Module publikuje první modul s verzí, která je větší než nebo rovna minimální verzi, kterou jste zadali.

Publikování modulu vyžaduje metadata, která se zobrazí na stránce galerie modulu. Požadovaná metadata zahrnují název modulu, verzi, popis a autora. I když většina metadat pochází z manifestu modulu, některá metadata musí být zadána v Publish-Module parametrech, například Tag, ReleaseNote, IconUri, ProjectUri a LicenseUri, protože tyto parametry odpovídají polím v galerii založené na NuGet.

Parametry, které přebírají čísla verzí modulů, očekávají řetězce formátované jako čísla verzí.

Standardní čísla verzí mají formát x.y.z , kde x, y a z jsou čísla.
Předběžné verze mají formát x.y.z-<prerelease_label> , ve kterém <prerelease_label> je k dané verzi přiřazen libovolný řetězec.

Příklady

Příklad 1: Publikování modulu

V tomto příkladu se MyDscModule publikuje do online galerie pomocí klíče rozhraní API k označení online účtu galerie vlastníka modulu. Pokud MyDscModule není platný modul manifestu, který určuje název, verzi, popis a autora, dojde k chybě.

Publish-Module -Name "MyDscModule" -NuGetApiKey "11e4b435-6cb4-4bf7-8611-5162ed75eb73"

Příklad 2: Publikování modulu s metadaty galerie

V tomto příkladu se MyDscModule publikuje do online galerie pomocí klíče rozhraní API k označení účtu galerie vlastníka modulu. Další zadaná metadata se zobrazí na webové stránce modulu v galerii. Vlastník přidá dvě vyhledávací značky pro modul, které se vztahují k Active Directory; přidá se stručná zpráva k vydání verze. Pokud MyDscModule není platný modul manifestu, který určuje název, verzi, popis a autora, dojde k chybě.

$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

Parametry

-AllowPrerelease

Umožňuje publikovat moduly označené jako předběžné verze.

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

-Confirm

Zobrazí výzvu k potvrzení před spuštěním nástroje Publish-Module.

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

-Credential

Určuje uživatelský účet, který má práva publikovat modul pro zadaného poskytovatele balíčků nebo zdroj.

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

-Exclude

Definuje soubory, které se mají vyloučit z publikovaného modulu.

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

-Force

Vynutí spuštění příkazu bez žádosti o potvrzení uživatele.

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

-FormatVersion

Přijímá pouze platné hodnoty určené atributem ValidateSet .

Další informace najdete v tématech Deklarace atributu ValidateSet a ValidateSetAttribute.

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

-IconUri

Určuje adresu URL ikony modulu. Zadaná ikona se zobrazí na webové stránce galerie modulu.

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

-LicenseUri

Určuje adresu URL licenčních podmínek pro modul, který chcete publikovat.

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

-Name

Určuje název modulu, který chcete publikovat. Publish-Module vyhledá zadaný název modulu v $Env:PSModulePathnástroji .

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

-NuGetApiKey

Určuje klíč rozhraní API, který chcete použít k publikování modulu do online galerie. Klíč rozhraní API je součástí vašeho profilu v online galerii a najdete ho na stránce vašeho uživatelského účtu v galerii. Klíč rozhraní API je funkce specifická pro NuGet.

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

-Path

Určuje cestu k modulu, který chcete publikovat. Tento parametr přijímá cestu ke složce, která obsahuje modul. Složka musí mít stejný název jako modul.

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

-ProjectUri

Určuje adresu URL webové stránky o tomto projektu.

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

-ReleaseNotes

Určuje řetězec obsahující poznámky k verzi nebo komentáře, které mají být k dispozici uživatelům této verze modulu.

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

-Repository

Určuje popisný název úložiště zaregistrovaného spuštěním příkazu Register-PSRepository. Úložiště musí mít PublishLocation, což je platný identifikátor URI NuGet. Možnost PublishLocation lze nastavit spuštěním příkazu Set-PSRepository.

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

-RequiredVersion

Určuje přesnou verzi jednoho modulu, který se má publikovat.

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

-SkipAutomaticTags

Odebere příkazy a prostředky, aby byly zahrnuty jako značky. Přeskočí automatické přidávání značek do modulu.

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

-Tags

Přidá jednu nebo více značek do modulu, který publikujete. Mezi ukázkové značky patří DesiredStateConfiguration, DSC, DSCResourceKit nebo PSModule. Více značek oddělte čárkami.

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

-WhatIf

Ukazuje, co by se stalo, když se Publish-Module spustí. Rutina není spuštěna.

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

Vstupy

String

PSCredential

Výstupy

Object

Poznámky

PowerShell obsahuje následující aliasy pro Publish-Module:

Všechny platformy:
- pumo

Publish-Module běží v PowerShellu 3.0 nebo novějších verzích PowerShellu, ve Windows 7 nebo Windows 2008 R2 a novějších verzích Windows.

Důležité

Od dubna 2020 už Galerie prostředí PowerShell nepodporuje protokol TLS (Transport Layer Security) verze 1.0 a 1.1. Pokud nepoužíváte protokol TLS 1.2 nebo vyšší, při pokusu o přístup k Galerie prostředí PowerShell se zobrazí chyba. Pomocí následujícího příkazu se ujistěte, že používáte protokol TLS 1.2:

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

Další informace najdete v oznámení na blogu o PowerShellu.

Publikování modulu vyžaduje metadata, která se zobrazí na stránce galerie modulu. Požadovaná metadata zahrnují název modulu, verzi, popis a autora. Většina metadat pochází z manifestu modulu, ale některá metadata je možné zadat v Publish-Module parametrech, jako jsou Tag, ReleaseNote, IconUri, ProjectUri a LicenseUri. Další informace najdete v tématu Hodnoty manifestu balíčku, které mají vliv na uživatelské rozhraní Galerie prostředí PowerShell.

Sdílet prostřednictvím

Publish-Module

Syntax

Description

Příklady

Příklad 1: Publikování modulu

Příklad 2: Publikování modulu s metadaty galerie

Parametry

-AllowPrerelease

-Confirm

-Credential

-Exclude

-Force

-FormatVersion

-IconUri

-LicenseUri

-Name

-NuGetApiKey

-Path

-ProjectUri

-ReleaseNotes

-Repository

-RequiredVersion

-SkipAutomaticTags

-Tags

-WhatIf

Vstupy

Výstupy

Poznámky

Další materiály

Sdílet prostřednictvím

Publish-Module

Syntax

Description

Příklady

Příklad 1: Publikování modulu

Příklad 2: Publikování modulu s metadaty galerie

Parametry

-AllowPrerelease

-Confirm

-Credential

-Exclude

-Force

-FormatVersion

-IconUri

-LicenseUri

-Name

-NuGetApiKey

-Path

-ProjectUri

-ReleaseNotes

-Repository

-RequiredVersion

-SkipAutomaticTags

-Tags

-WhatIf

Vstupy

Výstupy

Poznámky

Související odkazy

Další materiály