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

说明

此 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项目注册表(MAR)时,才使用此参数。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-NupkgPath

要发布的 .nupkg 文件的路径。 .nupkg 文件可能是使用 Publish-PSResource 参数的上一次运行 创建的。 或者,可以使用 .nupkg 命令创建 Compress-PSResource 文件。

此参数是在 Microsoft.PowerShell.PSResourceGetv1.1.0-preview2 中添加的。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Path

模块或脚本文件的路径,或包含要发布的模块或脚本文件的文件夹的路径。 该 cmdlet 将文件夹中的所有文件打包到 .nupkg 文件中,然后再发布到存储库。

类型:String
Position:0
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Proxy

用于访问网络外部存储库的代理服务器的 URL。

类型:Uri
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-ProxyCredential

使用代理服务器所需的凭据。

类型: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的别名。

基于文件共享的存储库没有有关资源的元数据。 因此,无法检查依赖项。