共用方式為


Publish-PSResource

將指定的模組從本機計算機發佈至 PSResource 存放庫。

語法

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

此 Cmdlet 會結合 Publish-Module v2 Publish-Script Cmdlet 的函式。 Publish-PSResource 將資源從本機計算機發佈至在線 NuGet 型存放庫。 您可以透過包含模組或文本資源檔的路徑,或指向預先封裝 .nupkg 檔案來指定資源。

範例

範例 1

此範例會將模組發佈至以最高優先順序註冊的存放庫 TestModule

Publish-PSResource -Path c:\TestModule

範例 2

本範例會將測試模組 TestModule 發佈至PowerShell資源庫。 API 金鑰是使用者帳戶的 PowerShell 資源庫所產生的秘密。

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

範例 3

本範例會將 Nupkg TestModule.nupkg 模組發佈至名為 TestRepository 的 repositroy。

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

參數

-ApiKey

指定您想要用來將資源發佈至在線資源庫的 API 金鑰。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Confirm

在執行 Cmdlet 之前,提示您進行確認。

類型:SwitchParameter
別名:cf
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-Credential

指定具有特定存放庫許可權的用戶帳戶。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-DestinationPath

指定應該儲存 NuGet 套件 .nupkg 檔案的路徑。 此參數可以與 Repository 參數搭配使用,以發行至存放庫,並將完全相同的套件儲存至本機文件系統。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ModulePrefix

這是動態參數,只有在您提供 PathNupkg 參數和 存放庫 參數時,才能在命令行 ContainerRegistry 上使用。

參數的值會預先寫入套件名稱。 這項資訊僅用於發佈,而且不包含在套件元數據中。 模組前置詞會控制模組的可見性,例如:internalpublicstaging

只有在發行至 Microsoft Artifact Registry (MAR) 時,才會使用此參數。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-NupkgPath

要發行 .nupkg 檔案的路徑。 .nupkg 檔案可能是先前使用 Publish-PSResource 參數執行 所建立。 或者,您可以使用 .nupkg 命令來建立 Compress-PSResource 檔案。

此參數已在 Microsoft.PowerShell.PSResourceGet的 v1.1.0-preview2 中新增。

類型:String
Position:Named
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Path

模組或腳本檔案的路徑,或包含要發行之模組或腳本檔案的資料夾路徑。 Cmdlet 會將資料夾中的所有檔案封裝成 .nupkg 檔案,再發佈至存放庫。

類型:String
Position:0
預設值:None
必要:True
接受管線輸入:False
接受萬用字元:False

-Proxy

用來存取網路外部存放庫之 Proxy 伺服器的 URL。

類型:Uri
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-ProxyCredential

使用 Proxy 伺服器所需的認證。

類型:PSCredential
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-Repository

指定要發行至的存放庫。

類型:String
Position:Named
預設值:None
必要:False
接受管線輸入:False
接受萬用字元:False

-SkipDependenciesCheck

略過預設檢查目標存放庫中是否有所有相依性。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-SkipModuleManifestValidate

在發佈之前略過驗證模組指令清單。

類型:SwitchParameter
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

-WhatIf

顯示 Cmdlet 執行時會發生什麼事。 Cmdlet 未執行。

類型:SwitchParameter
別名:wi
Position:Named
預設值:False
必要:False
接受管線輸入:False
接受萬用字元:False

輸入

None

輸出

備註

模組會將 pbres 定義為 Publish-PSResource的別名。

Fileshare 型存放庫沒有資源的相關元數據。 因此,無法檢查相依性。