Publish-Module

  • Referencia
Modul:
PowerShellGet

Egy megadott modult tesz közzé a helyi számítógépről egy online katalógusban.

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

A Publish-Module parancsmag egy modult tesz közzé egy online NuGet-alapú katalógusban egy API-kulccsal, amely a felhasználói profil részeként van tárolva a katalógusban. Megadhatja a közzéteendő modult a modul neve vagy a modult tartalmazó mappa elérési útja alapján.

Ez egy proxyparancsmag a Publish-PSResourceMicrosoft.PowerShell.PSResourceGet parancsmaghoz. További információ: Publish-PSResource.

Példák

1. példa: Modul közzététele

Ebben a példában a MyDscModule az API-kulccsal jelenik meg az online katalógusban a modul tulajdonosának online katalógusfiókjának jelzésére. Ha a MyDscModule nem egy érvényes jegyzékmodul, amely megadja a nevet, a verziót, a leírást és a szerzőt, hiba történik.

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

2. példa: Modul közzététele a katalógus metaadataival

Ebben a példában a MyDscModule az API-kulccsal jelenik meg az online katalógusban a modul tulajdonosának katalógusfiókjának jelzésére. A megadott további metaadatok megjelennek a modul katalógusban található weblapján. A tulajdonos két keresési címkét ad hozzá a modulhoz, amelyek az Active Directoryhoz kapcsolódnak; a rendszer hozzáad egy rövid kibocsátási megjegyzést. Ha a MyDscModule nem egy érvényes jegyzékmodul, amely megadja a nevet, a verziót, a leírást és a szerzőt, hiba történik.

$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

Paraméterek

-AllowPrerelease

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-Confirm

Megerősítést kér a parancs futtatása Publish-Moduleelőtt.

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

-Credential

Olyan felhasználói fiókot ad meg, amely jogosult egy adott csomagszolgáltató vagy -forrás moduljának közzétételére.

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

-Exclude

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-Force

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-FormatVersion

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-IconUri

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-LicenseUri

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-Name

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-NuGetApiKey

Megadja azt az API-kulcsot, amellyel modult szeretne közzétenni az online katalógusban. Az API-kulcs a profil része az online katalógusban, és megtalálható a felhasználói fiók oldalán a katalógusban. Az API-kulcs NuGet-specifikus funkció.

A proxy parancsmag ezt a paramétert a () ApiKey paraméterére Publish-PSResourceképezi le.

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

-Path

Megadja a közzétenni kívánt modul elérési útját. Ez a paraméter elfogadja a modult tartalmazó mappa elérési útját. A mappának ugyanazzal a névvel kell rendelkeznie, mint a modulnak.

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

-ProjectUri

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-ReleaseNotes

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-Repository

A futtatással Register-PSRepositoryregisztrált adattár rövid nevét adja meg. Az adattárnak rendelkeznie kell egy PublishLocation paranccsel, amely egy érvényes NuGet URI. A PublishLocation a futtatásával Set-PSRepositoryállítható be.

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

-RequiredVersion

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-SkipAutomaticTags

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-Tags

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Publish-PSResource

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

-WhatIf

Megjeleníti, hogy mi történne, ha a Publish-Module futtatások történnek. A parancsmag nem fut.

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

Bevitelek

String

PSCredential

Kimenetek

Object

Jegyzetek

A PowerShell a következő aliasokat tartalmazza:Publish-Module

  • Összes platform:
    • pumo

Publish-Module a PowerShell 3.0-s vagy újabb verzióiban, a Windows 7-es vagy a Windows 2008 R2-es és újabb verzióiban fut.

A PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2-s vagy újabb verzióját kell használnia. Az alábbi paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

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

A modul közzétételéhez metaadatokra van szükség, amelyek a modul katalógusoldalán jelennek meg. A szükséges metaadatok közé tartozik a modul neve, verziója, leírása és szerzője. A metaadatokat a moduljegyzékben kell definiálni. További információ: Csomagjegyzék-értékek, amelyek hatással vannak a PowerShell-galéria felhasználói felületére.