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
這是動態參數,只有在您提供 Path 或 Nupkg 參數和 存放庫 參數時,才能在命令行 ContainerRegistry
上使用。
參數的值會預先寫入套件名稱。 這項資訊僅用於發佈,而且不包含在套件元數據中。 模組前置詞會控制模組的可見性,例如:internal
、public
、staging
。
只有在發行至 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 型存放庫沒有資源的相關元數據。 因此,無法檢查相依性。