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 之前,提示你进行确认。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:cf

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Credential

指定有权访问特定存储库的用户帐户。

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-DestinationPath

指定应保存 NuGet 包 .nupkg 文件的路径。 此参数可与 Repository 参数结合使用,以发布到存储库,并将完全相同的包保存到本地文件系统。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-ModulePrefix

这是一个动态参数,仅在您为存储库提供了 PathNupkg 参数以及 Repository 参数 ContainerRegistry 时,该参数在命令行中可用。

参数的值预写到包名称。 此信息仅用于发布,并且不包含在包元数据中。 模块前缀控制模块的可见性,例如:internalpublicstaging

仅当发布到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

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

参数属性

类型:PSCredential
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-Repository

指定要发布到的存储库。

参数属性

类型:String
默认值:None
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkipDependenciesCheck

绕过默认检查目标存储库中是否存在所有依赖项。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-SkipModuleManifestValidate

在发布之前跳过验证模块清单。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

-WhatIf

显示 cmdlet 运行时会发生什么情况。 cmdlet 未能运行。

参数属性

类型:SwitchParameter
默认值:False
支持通配符:False
不显示:False
别名:无线

参数集

(All)
Position:Named
必需:False
来自管道的值:False
来自管道的值(按属性名称):False
来自剩余参数的值:False

CommonParameters

此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters

输入

None

输出

Object

备注

该模块将 pbres 定义为 Publish-PSResource的别名。

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