パッケージ管理プロバイダーリソース

Announcement

このリポジトリは非推奨になりました。 PackageManagementProviderResource モジュールが PackageManagement にマージされました。今後は https://github.com/OneGet/oneget を使用してください。ありがとう！

パッケージ管理プロバイダーリソース

PackageManagementProviderResource は、PackageManagement (別名 OneGet) プロバイダーの DSC リソースです。現在、パッケージと Windows PowerShell モジュールを管理できるようにする Nuget および PowerShellGet プロバイダー DSC リソースが含まれています。

貢献する

一般的な DSC リソースの貢献ガイドラインを確認してください。

リソース

• PackageManagement – 任意のソースからパッケージをダウンロードしてインストールできる汎用の PackageManagement プロバイダーです。このプロバイダーは、Install-Package および Get-Package コマンドレットを使用します。デフォルト以外のソースを登録するには、PackageManagementSource DSC リソースを使用する必要がある場合があります。

• NugetPackage – NuGet ソースの場所 (http://nuget.org/api/v2/ など) からパッケージをダウンロードし、パッケージをインストールまたはアンインストールできます。

• PSModule – Windows PowerShell モジュールを PowerShell ギャラリー「PSGallery」 (例: https://www.powershellgallery.com/api/v2/ ) からダウンロードし、コンピューターにインストールできます。

• PackageManagementSource – コンピュータ上でパッケージ ソースを登録または登録解除できます。

PackageManagement DSC リソースには次のプロパティがあります。

財産	説明
名前	インストールまたはアンインストールするパッケージの名前を指定します。
ソース	パッケージが見つかるパッケージ ソースの名前を指定します。これは、URI または Register-PackageSource コマンドレットまたは PackageManagementSource DSC リソースで登録されたソースのいずれかです。 DSC リソース MSFT_PackageManagementSource では、パッケージ ソースを登録することもできます。
確保する	パッケージをインストールするかアンインストールするかを決定します。
必須バージョン	インストールするパッケージの正確なバージョンを指定します。このパラメーターを指定しない場合、この DSC リソースは、MinimumVersion パラメーターで指定された最大バージョンも満たす、利用可能な最新バージョンのパッケージをインストールします。
最小バージョン	インストールするパッケージの最小許可バージョンを指定します。このパラメーターを追加しない場合、この DSC リソースは、MinimumVersion パラメーターで指定された最大指定バージョンも満たす、利用可能なパッケージの最も高いバージョンをインストールします。
最大バージョン	インストールするパッケージの最大許可バージョンを指定します。このパラメーターを指定しない場合、この DSC リソースは、パッケージの最も大きい番号の利用可能なバージョンをインストールします。
ソース認証情報	指定したパッケージプロバイダーまたはソースのパッケージをインストールする権限を持つユーザーアカウントを指定します。
プロバイダー名	パッケージ検索の範囲を指定するパッケージ プロバイダー名を指定します。 Get-PackageProvider コマンドレットを実行すると、パッケージ プロバイダー名を取得できます。
追加パラメータ	ハッシュテーブルとして渡されるプロバイダー固有のパラメーター。たとえば、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 を実行して、DSC リソースにリストされている DSC リソースに PackageManagement、NugetPackage、PackageManagementSource、および PSModule が含まれていることを確認します。

####**コードの構築**####

コードは 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. 問題からバグレポートを送信してください。適切なバグ レポートを送信するためのガイドについては、「Painless Bug Tracking」を参照してください。

2. バグの修正を確認します。

3. バグの修正を送信してください。送信する前に、次のものが揃っていることを確認してください。

• 独自のコードレビューを実行した
• 必要に応じてテストケースを更新
• テスト ケースを実行して、機能の中断やテストの中断がないことを確認します。
• 新しいコードのテスト ケースを追加しました

4. 機能リクエストを送信します。
5. ディスカッション リストの質問に答えるのに役立ちます。
6. テストケースを提出します。
7. プロジェクトについて他の人に伝えます。
8. 製品に対する感謝の気持ちを開発者に伝えてください。

コードのコントリビュートに関する次の 2 つのブログ投稿もお読みください。Miguel de Icaza の Open Source Contribution Etiquette と Ilya Grigorik の Don't "Push" Your Pull Requests です。

機能や実質的なコードの貢献を送信する前に、問題を通じて Windows PowerShell チームと話し合い、それが製品ロードマップに従っていることを確認してください。提出されたすべてのコードは、Windows PowerShell チームによって厳密にレビューされることに注意してください。品質とロードマップへの適合性の両方において高い基準を満たすもののみがソースにマージされます。

####例####

サンプルは Examples フォルダーに含まれています。