Publish-Module
Egy megadott modult tesz közzé a helyi számítógépről egy online katalógusba.
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, amelyet egy felhasználó profiljának részeként tárol 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-PSResource
Microsoft.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 érvényes jegyzékmodul, amely egy nevet, verziót, leírást és szerzőt határoz meg, 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 weblapján a katalógusban. 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 érvényes jegyzékmodul, amely egy nevet, verziót, leírást és szerzőt határoz meg, 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 proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Confirm
Megerősítést kér, mielőtt futtatja a Publish-Module
.
Típus: | SwitchParameter |
Aliasok: | cf |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | PSCredential |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-Exclude
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Force
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-FormatVersion
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | Version |
Elfogadott értékek: | 2.0 |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-IconUri
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | Uri |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-LicenseUri
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | Uri |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Name
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | 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 következő ApiKey-paraméterhez rendeli Publish-PSResource
le: .
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | 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.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | True |
Folyamatbemenet elfogadása: | True |
Helyettesítő karakterek elfogadása: | False |
-ProjectUri
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | Uri |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-ReleaseNotes
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Repository
A futtatással Register-PSRepository
regisztrált adattár rövid nevét adja meg. Az adattárnak PublishLocation-rel kell rendelkeznie, amely érvényes NuGet URI.
A PublishLocation a futtatással Set-PSRepository
állítható be.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-RequiredVersion
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | String |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-SkipAutomaticTags
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | SwitchParameter |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-Tags
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource
.
Típus: | String[] |
Position: | Named |
Alapértelmezett érték: | None |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
-WhatIf
Megjeleníti, mi történne, ha a Publish-Module
futna. A parancsmag nem fut.
Típus: | SwitchParameter |
Aliasok: | wi |
Position: | Named |
Alapértelmezett érték: | False |
Kötelező: | False |
Folyamatbemenet elfogadása: | False |
Helyettesítő karakterek elfogadása: | False |
Bevitelek
Kimenetek
Jegyzetek
A PowerShell a következő aliasokat tartalmazza Publish-Module
:
- Minden platform:
pumo
Publish-Module
A PowerShell PowerShell 3.0-s vagy újabb kiadásain fut, Windows 7 vagy Windows 2008 R2 rendszeren, valamint a Windows újabb kiadásain.
A PowerShell-katalógus már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. A TLS 1.2 vagy újabb verzióját kell használnia. A következő 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 tartalmazzák a modul nevét, verzióját, leírását és szerzőét. A metaadatokat a moduljegyzékben kell meghatározni. További információ: A PowerShell-katalógus felhasználói felületére hatással lévő csomagjegyzék-értékek.