套件管理提供者資源

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 資料夾中。