Sdílet prostřednictvím

Publish-PSResource

  • Reference
Modul:
Microsoft.PowerShell.PSResourceGet

Publikuje zadaný modul z místního počítače do úložiště PSResource.

Syntaxe

Publish-PSResource
       [-ApiKey <String>]
       [-Repository <String>]
       [-Path] <String>
       [-DestinationPath <String>]
       [-Credential <PSCredential>]
       [-SkipDependenciesCheck]
       [-SkipModuleManifestValidate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Publish-PSResource
       [-ApiKey <String>]
       [-Repository <String>]
       [-DestinationPath <String>]
       [-Credential <PSCredential>]
       [-SkipDependenciesCheck]
       [-SkipModuleManifestValidate]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       -NupkgPath <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Tato rutina kombinuje funkce Publish-Module a rutin Publish-Script z PowerShellGet v2. Publish-PSResource publikuje prostředek z místního počítače do online úložiště založeného na NuGetu. Prostředek můžete zadat cestou obsahující soubory prostředků modulu nebo skriptu nebo odkazováním na předem zabalený soubor .nupkg.

Příklady

Příklad 1

Tento příklad publikuje modul TestModule do úložiště zaregistrovaného s nejvyšší prioritou.

Publish-PSResource -Path c:\TestModule

Příklad 2

Tento příklad publikuje modul TestModule do galerie Prostředí PowerShell. Klíč rozhraní API je tajný klíč, který vygeneruje galerie Prostředí PowerShell pro uživatelský účet.

Publish-PSResource -Path c:\TestModule -Repository PSGallery -APIKey '1234567'

Příklad 3

Tento příklad publikuje modul Nupkg TestModule.nupkg do repositroy s názvem TestRepository.

Publish-PSResource -NupkgPath c:\TestModule.nupkg -Repository TestRepository

Parametry

-ApiKey

Určuje klíč rozhraní API, který chcete použít k publikování prostředku do online galerie.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Confirm

Před spuštěním rutiny vás vyzve k potvrzení.

Typ:SwitchParameter
Aliasy:cf
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Credential

Určuje uživatelský účet, který má práva k určitému úložišti.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-DestinationPath

Určuje cestu, kam má být uložen balíček NuGet .nupkg soubor. Tento parametr lze použít ve spojení s parametrem Repository k publikování do úložiště a také uložit úplně stejný balíček do místního systému souborů.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ModulePrefix

Jedná se o dynamický parametr, který je k dispozici pouze na příkazovém řádku, pokud jste zadali parametry Path nebo Nupkg a parametr úložiště pro úložiště ContainerRegistry.

Hodnota parametru je předpřipravena k názvu balíčku. Tyto informace se používají jenom pro publikování a nejsou zahrnuty do metadat balíčku. Předpona modulu řídí viditelnost modulu, například: internal, public, staging.

Tento parametr se používá pouze při publikování do služby Microsoft Artifact Registry (MAR).

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-NupkgPath

Cesta k souboru .nupkg, který se má publikovat. Soubor .nupkg mohl být vytvořen předchozím spuštěním Publish-PSResource s parametrem DestinationPath. Nebo můžete soubor .nupkg vytvořit pomocí příkazu Compress-PSResource.

Tento parametr byl přidán do verze 1.1.0-preview2 Microsoft.PowerShell.PSResourceGet.

Typ:String
Position:Named
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Path

Cesta k souboru modulu nebo skriptu nebo cestě ke složce obsahující modul nebo soubor skriptu, který se má publikovat. Rutina před publikováním do úložiště zabalí všechny soubory ve složce do souboru .nupkg.

Typ:String
Position:0
Default value:None
Vyžadováno:True
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Proxy

Adresa URL proxy serveru sloužícího k přístupu k úložištím mimo vaši síť.

Typ:Uri
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-ProxyCredential

Přihlašovací údaje potřebné k použití proxy serveru.

Typ:PSCredential
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-Repository

Určuje úložiště, do které se má publikovat.

Typ:String
Position:Named
Default value:None
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipDependenciesCheck

Obchází výchozí kontrolu, že jsou v cílovém úložišti přítomny všechny závislosti.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-SkipModuleManifestValidate

Před publikováním přeskočí ověřování manifestu modulu.

Typ:SwitchParameter
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

-WhatIf

Ukazuje, co se stane, když se rutina spustí. Rutina se nespustí.

Typ:SwitchParameter
Aliasy:wi
Position:Named
Default value:False
Vyžadováno:False
Přijmout vstup kanálu:False
Přijmout zástupné znaky:False

Vstupy

None

Výstupy

Poznámky

Modul definuje pbres jako alias pro Publish-PSResource.

Úložiště založené na sdílených složkách nemá žádná metadata o prostředcích. Proto neexistuje způsob, jak kontrolovat závislosti.