包管理提供者资源

Announcement

该存储库已被弃用。 PackageManagementProviderResource 模块已合并到 PackageManagement。请使用 https://github.com/OneGet/oneget 继续。谢谢你！

包管理提供者资源

PackageManagementProviderResource 是 PackageManagement（又名 OneGet）提供程序的 DSC 资源。目前它包含 Nuget 和 PowerShellGet 提供程序 DSC 资源，允许您管理包和 Windows PowerShell 模块。

贡献

请查看常见的 DSC 资源贡献指南。

资源

• PackageManagement – 通用 PackageManagement 提供程序，可让您从任何来源下载和安装包。此提供程序使用 Install-Package 和 Get-Package cmdlet。您可能必须使用 PackageManagementSource DSC 资源来注册非默认源。

• NugetPackage – 允许您从 NuGet 源位置（例如，http://nuget.org/api/v2/）下载包，并安装或卸载该包。

• PSModule – 允许您从 PowerShell 库“PSGallery”（例如 https://www.powershellgallery.com/api/v2/ ）下载 Windows PowerShell 模块，并将其安装在您的计算机上。

• PackageManagementSource – 允许您在计算机上注册或取消注册包源

PackageManagement DSC 资源具有以下属性：

财产	描述
姓名	指定要安装或卸载的软件包的名称。
来源	指定可以在其中找到包的包源的名称。这可以是 URI，也可以是使用 Register-PackageSource cmdlet 或 PackageManagementSource DSC 资源注册的源。 DSC 资源 MSFT_PackageManagementSource 还可以注册包源。
确保	确定是否要安装或卸载该包。
所需版本	指定您要安装的软件包的确切版本。如果不指定此参数，则此 DSC 资源将安装包的最新可用版本，该版本也满足 MaximumVersion 参数指定的任何最大版本。
最低版本	指定要安装的软件包的最低允许版本。如果不添加此参数，则此 DSC 资源将安装包的最高可用版本，该版本也满足 MaximumVersion 参数指定的任何最大指定版本。
最大版本	指定要安装的软件包的最大允许版本。如果不指定此参数，则此 DSC 资源将安装该包的最大可用版本。
来源凭证	指定有权为指定包提供程序或源安装包的用户帐户。
提供商名称	指定包搜索范围的包提供程序名称。您可以通过运行 Get-PackageProvider cmdlet 来获取包提供程序名称。
附加参数	作为哈希表传递的提供程序特定参数。例如，对于 NuGet 提供程序，您可以传递其他参数，例如 DestinationPath。

NugetPackage DSC 资源具有以下属性：

财产	描述
姓名	指定要安装或卸载的包的名称。
目的路径	指定要安装包的文件位置。
确保	确定是否要安装或卸载该包。
安装政策	确定您是否信任包的来源。
所需版本	指定要安装或卸载的软件包的确切版本。
最低版本	指定要安装或卸载的软件包的最低版本。
最大版本	指定要安装或卸载的软件包的最高版本。
来源	指定已注册包源的 URI 或名称。
来源凭证	提供对远程源上的包的访问。此属性不用于安装包。该软件包始终安装在本地系统帐户上。

PSModule DSC 资源具有以下属性：

财产	描述
姓名	指定要安装或卸载的PowerShell模块的名称。
确保	确定是否要安装或卸载模块。
安装政策	确定您是否信任模块所在的源存储库。
所需版本	指定要安装或卸载的模块的确切版本。
最低版本	指定要安装或卸载的模块的最低版本。
存储库	指定可以找到该模块的模块源存储库的名称。

PackageManagementSource具有以下属性：

财产	描述
姓名	指定要在系统上注册或取消注册的包源的名称。
提供商名称	指定 OneGet 提供程序的名称，您可以通过该提供程序与包源进行互操作。
确保	确定包源是注册还是取消注册。
安装政策	确定您是否信任包源。
源Uri	指定包源的 URI。
来源凭证	提供对远程源上的包的访问。

＃＃＃＃**要求**＃＃＃＃

在安装此软件包之前，您必须运行 [Windows Management Framework 5.0 RTM(https://www.microsoft.com/en-us/download/details.aspx?id=50395)。

＃＃＃＃**安装**＃＃＃＃

要使用PackageManagementProviderResource模块，

• 将下载内容复制到 $env:ProgramFilesWindowsPowerShellModules 文件夹。

要确认安装，

• 运行Get-DSCResource以验证 PackageManagement、NugetPackage、PackageManagementSource 和 PSModule 是否属于 DSC 资源中列出的 DSC 资源。

#####构建代码**####

该代码是 Windows PowerShell 脚本，由 Windows PowerShell 引擎在运行时解释。

#####运行测试**####

要测试模块，请运行以下命令。此处使用 NuGetPackage 资源作为示例。

• cd $env:ProgramFilesWindowsPowerShellModulesPackageManagementProviderResourceTest
• .NugetPackageNugetPackage.Get.Tests.ps1
• .NugetPackageNugetPackage.Set.Tests.ps1
• .NugetPackageNugetPackage.Test.Tests.ps1

您可以类似地重复这些命令来测试 PackageManagement、PSModule 和 PackageManagementSource DSC 资源。

#####为代码做出贡献**####

欢迎您为这个项目做出贡献。贡献方式有很多种：

1. 通过问题提交错误报告。有关提交良好错误报告的指南，请阅读无痛错误跟踪。

2. 验证错误修复。

3. 提交您对错误的修复。提交之前，请确保您拥有：

• 执行您自己的代码审查
• 如果需要更新测试用例
• 运行测试用例以确保没有功能中断或测试中断
• 添加了新代码的测试用例

4. 提交功能请求。
5. 帮助回答讨论列表中的问题。
6. 提交测试用例。
7. 向其他人介绍该项目。
8. 告诉开发人员您有多欣赏该产品！

您还可以阅读这两篇关于贡献代码的博​​客文章：Miguel de Icaza 的《开源贡献礼仪》和 Ilya Grigorik 的《不要“推送”您的 Pull 请求》。

在提交功能或大量代码贡献之前，请通过问题与 Windows PowerShell 团队进行讨论，并确保其遵循产品路线图。请注意，所有提交的代码都将经过 Windows PowerShell 团队的严格审核。只有那些满足质量和路线图契合度高标准的内容才会被合并到源代码中。

####示例####

示例包含在 Examples 文件夹中。