Megosztás a következőn keresztül:


Publish-Module

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

Syntax

ModuleNameParameterSet (Alapértelmezett)

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>]

ModulePathParameterSet

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-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 é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.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ModuleNameParameterSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Confirm

Megerősítést kér a Publish-Modulefuttatása előtt.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Cf

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:PSCredential
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-Exclude

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ModuleNameParameterSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Force

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-FormatVersion

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:Version
Alapértelmezett érték:None
Elfogadott értékek:2.0
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-IconUri

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:Uri
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-LicenseUri

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:Uri
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Name

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ModuleNameParameterSet
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték: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-PSResourcele: .

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték: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.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ModulePathParameterSet
Position:Named
Kötelező:True
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:True
Fennmaradó argumentumokból származó érték:False

-ProjectUri

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:Uri
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-ReleaseNotes

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Repository

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

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-RequiredVersion

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:String
Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

ModuleNameParameterSet
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-SkipAutomaticTags

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-Tags

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Publish-PSResource.

Paramétertulajdonságok

Típus:

String[]

Alapértelmezett érték:None
Támogatja a helyettesítő karaktereket:False
DontShow:False

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

-WhatIf

Megjeleníti, mi történne, ha a Publish-Module futna. A parancsmag nem fut.

Paramétertulajdonságok

Típus:SwitchParameter
Alapértelmezett érték:False
Támogatja a helyettesítő karaktereket:False
DontShow:False
Aliasok:Wi

Paraméterkészletek

(All)
Position:Named
Kötelező:False
Folyamatból származó érték:False
Folyamatból származó érték tulajdonságnév alapján:False
Fennmaradó argumentumokból származó érték:False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

Bevitelek

String

PSCredential

Kimenetek

Object

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ó: Csomagjegyzék-értékek, amelyek hatással vannak a PowerShell-katalógus felhasználói felületére.