Publish-Module

该 Publish-Module cmdlet 使用 API 密钥（作为用户配置文件的一部分存储在库中）将模块发布到基于 NuGet 的联机库。 可以指定要按模块名称发布的模块，也可以指定包含模块的文件夹的路径。

按名称指定模块时， Publish-Module 请发布通过运行 Get-Module -ListAvailable <Name>找到的第一个模块。 如果指定要发布的模块的最低版本， Publish-Module 则发布第一个模块，其版本大于或等于指定的最低版本。

发布模块需要模块的库页上显示的元数据。 所需的元数据包括模块名称、版本、说明和作者。 尽管大多数元数据是从模块清单中提取的，但某些元数据必须在参数（如 Tag、ReleaseNote、IconUri、ProjectUri 和 LicenseUri）中Publish-Module指定，因为这些参数与基于 NuGet 的库中的字段匹配。

采用模块版本号的参数需要格式化为版本号的字符串。

• 标准版本号的格式为 x.y.z x、y 和 z 是数字
• 预发行版版本的格式是x.y.z-<prerelease_label><prerelease_label>分配给该版本的任意字符串。

在此示例中，MyDscModule 通过使用 API 密钥指示模块所有者的联机库帐户发布到联机库。 如果 MyDscModule 不是指定名称、版本、说明和作者的有效清单模块，则会发生错误。

Publish-Module -Name "MyDscModule" -NuGetApiKey "11e4b435-6cb4-4bf7-8611-5162ed75eb73"

在此示例中，MyDscModule 通过使用 API 密钥指示模块所有者的库帐户发布到联机库。 提供的其他元数据显示在库中模块的网页上。 所有者为模块添加两个搜索标记，并将其关联到 Active Directory;添加了简短的发行说明。 如果 MyDscModule 不是指定名称、版本、说明和作者的有效清单模块，则会发生错误。

$parameters = @{
    Name        = "MyDscModule"
    NuGetApiKey = "11e4b435-6cb4-4bf7-8611-5162ed75eb73"
    LicenseUri  = "http://contoso.com/license"
    Tag         = "Active Directory","DSC"
    ReleaseNote = "Updated the ActiveDirectory DSC Resources to support adding users."
}
Publish-Module @parameters

String

PSCredential

Object

PowerShell 包含以下与 Publish-Module相关的别名：

• 所有平台：
  • pumo

Publish-Module 在 PowerShell 3.0 或更高版本的 PowerShell、Windows 7 或 Windows 2008 R2 及更高版本的 Windows 上运行。

发布模块需要模块的库页上显示的元数据。 所需的元数据包括模块名称、版本、说明和作者。 大多数元数据取自模块清单，但某些元数据可以在参数中Publish-Module指定，例如 Tag、ReleaseNote、IconUri、ProjectUri 和 LicenseUri。 有关详细信息，请参阅 影响 PowerShell 库 UI 的包清单值。