Publish-PSResource
将指定模块从本地计算机发布到 PSResource 存储库。
语法
PathParameterSet
Publish-PSResource
[-Path] <String>
[-ApiKey <String>]
[-Repository <String>]
[-DestinationPath <String>]
[-Credential <PSCredential>]
[-SkipDependenciesCheck]
[-SkipModuleManifestValidate]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
NupkgPathParameterSet
Publish-PSResource
-NupkgPath <String>
[-ApiKey <String>]
[-Repository <String>]
[-DestinationPath <String>]
[-Credential <PSCredential>]
[-SkipDependenciesCheck]
[-SkipModuleManifestValidate]
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
说明
此 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 的存储库。
Publish-PSResource -NupkgPath c:\TestModule.nupkg -Repository TestRepository
参数
-ApiKey
指定要用于将资源发布到联机库的 API 密钥。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
在运行 cmdlet 之前,提示你进行确认。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Credential
指定有权访问特定存储库的用户帐户。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DestinationPath
指定应保存 NuGet 包 .nupkg 文件的路径。 此参数可与 Repository 参数结合使用,以发布到存储库,并将完全相同的包保存到本地文件系统。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ModulePrefix
这是一个动态参数,仅在您为存储库提供了 Path 或 Nupkg 参数以及 Repository 参数 ContainerRegistry 时,该参数在命令行中可用。
参数的值预写到包名称。 此信息仅用于发布,并且不包含在包元数据中。 模块前缀控制模块的可见性,例如:internal、public、staging。
仅当发布到Microsoft项目注册表(MAR)时,才使用此参数。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
All
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-NupkgPath
要发布的 .nupkg 文件的路径。
.nupkg 文件可能是使用 Publish-PSResource 参数的上一次运行 创建的。 或者,可以使用 .nupkg 命令创建 Compress-PSResource 文件。
此参数是在 Microsoft.PowerShell.PSResourceGetv1.1.0-preview2 中添加的。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
NupkgPathParameterSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Path
模块或脚本文件的路径,或包含要发布的模块或脚本文件的文件夹的路径。 该 cmdlet 将文件夹中的所有文件打包到 .nupkg 文件中,然后再发布到存储库。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
PathParameterSet
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Proxy
用于访问网络外部存储库的代理服务器的 URL。
参数属性
| 类型: | Uri
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ProxyCredential
使用代理服务器所需的凭据。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Repository
指定要发布到的存储库。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SkipDependenciesCheck
绕过默认检查目标存储库中是否存在所有依赖项。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SkipModuleManifestValidate
在发布之前跳过验证模块清单。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。
None
输出
备注
该模块将 pbres 定义为 Publish-PSResource的别名。
基于文件共享的存储库没有有关资源的元数据。 因此,无法检查依赖项。