about_PSResourceGet

簡単な説明

Microsoft.PowerShell.PSResourceGetモジュールのバージョン1.2.0の使い方を説明します。

長い説明

Microsoft.PowerShell.PSResourceGet は、 PowerShellGet モジュールの更新版であり、以前のバージョンに比べて以下の利点を提供します。

• コードベースを簡素化し、バグの強化や修正が容易になります
• PackageManagementモジュールへの依存を排除し、NuGet APIを直接使用します
• PowerShellGet v2で変更が壊れてしまう長年の使いやすさの問題を解決します
• 検索およびインストール性能の向上

Microsoft.PowerShell.PSResourceGetを初めて使うとき、モジュールはPowerShellギャラリーをPSResourceリポジトリとして登録します。 デフォルトでは、PSGalleryリポジトリは優先度50で登録され、信頼できないとマークされています。 PSGalleryリポジトリを信頼するには以下のコマンドを使ってください:

Set-PSResourceRepository -Name PSGallery -Trusted -PassThru

設計変更

以前のバージョンの PowerShellGet には、モジュールとスクリプトを操作するための個別のコマンドがありました。 Microsoft.PowerShell.PSResourceGetでは、PowerShell ギャラリー内のすべてのパッケージが PSResource オブジェクト 定義されます。

以下の表は 、Microsoft.PowerShell.PSResourceGet で利用可能なコマンドレットおよびそれらの PowerShellGet v2対応のコマンドレットを示しています。

NuGet バージョン範囲による検索

Microsoft.PowerShell.PSResourceGet コマンドレット 、検索するバージョンの範囲を指定できる Version パラメーターが用意されています。 Version パラメーターは、NuGet のバージョン管理構文を使用します。 NuGet のバージョン範囲の詳細については、「パッケージのバージョン管理参照してください。

PowerShellGet では、NuGet のバージョン範囲のドキュメントに記載されている 最小包括バージョン 以外のすべてをサポートしています。 バージョンとして 1.0.0.0 を使用しても、バージョン 1.0.0.0 以降 (最小包括範囲) は生成されません。 代わりに、値は必要なバージョンと見なされます。 最小包括範囲を検索するには、バージョン範囲として [1.0.0.0, ] を使用します。

必要なリソースによる検索

コマンドレットには、特定の条件に一致する PSResource オブジェクト 検索するために使用される RequiredResourceFile パラメーター RequiredResource と があります。 ハッシュテーブルまたは JSON オブジェクトを使用して検索条件を指定できます。 RequiredResourceFile パラメーターの場合、ハッシュテーブルは .psd1 ファイルに格納され、JSON オブジェクトは .json ファイルに格納されます。

ハッシュテーブルには、複数のモジュールの属性を含めることができます。 次の例は、モジュール仕様の構造を示しています。

@{
    <modulename> = @{
        version = '<version-spcification>'
        repository = '<reponame>'
        prerelease = '<boolean>'
    }
}

この例には、3 つのモジュールの仕様が含まれています。 可能な限り、モジュール属性は省略可能です。

 @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
    }

    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = $true
    }

    TestModule99 = @{}
}

次の例では、同じ仕様を JSON 形式で示します。

{
  "TestModule": {
    "version": "[0.0.1,1.3.0)",
    "repository": "PSGallery"
  },
  "TestModulePrerelease": {
    "version": "[0.0.0,0.0.5]",
    "repository": "PSGallery",
    "prerelease": "true"
  },
  "TestModule99": {}
}

こちらも参照ください

• install-PSResource の
• Find-PSResource
• Get-InstalledPSResource の
• install-PSResource の
• Save-PSResource
• Uninstall-PSResource
• Update-PSResource の