about_PSResourceGet

[アーティクル]
10/31/2024

簡単な説明

Microsoft.PowerShell.PSResourceGet モジュールのバージョン 1.1.0-rc1 の使用方法について説明します。

長い説明

Microsoft.PowerShell.PSResourceGet は、C# で完全に記述された PowerShellGet モジュールの更新バージョンです。

このバージョンの PowerShellGet では、いくつかの重要な領域に焦点を当てています。

コードベースを簡略化して、バグの強化と修正を容易にする
PackageManagement モジュールへの依存関係を削除し、NuGet ライブラリを直接使用します
v2 からの破壊的変更に伴う長年のユーザビリティの問題に対処する
別の互換性モジュールを使用して v2 を想定して記述された既存のスクリプトの互換性を維持する
検索とインストールのパフォーマンスを向上させる

デザインの変更

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

次の表は、PowerShellGet v3 で使用できるコマンドレットとその v2 の同等のコマンドレットを示しています。

Microsoft.PowerShell.PSResourceGet	PowerShellGet v2
`Compress-PSResource`	n/a
`Find-PSResource`	`Find-Command`
`Find-PSResource`	`Find-DscResource`
`Find-PSResource`	`Find-Module`
`Find-PSResource`	`Find-Script`
n/a	`Find-RoleCapability`
`Get-InstalledPSResource`	`Get-InstalledModule`
`Get-InstalledPSResource`	`Get-InstalledScript`
`Get-PSResourceRepository`	`Get-PSRepository`
`Get-PSScriptFileInfo`	n/a
`Import-PSGetRepository`	n/a
`Install-PSResource`	`Install-Module`
`Install-PSResource`	`Install-Script`
`New-PSScriptFileInfo`	`New-ScriptFileInfo`
`Publish-PSResource`	`Publish-Module`
`Publish-PSResource`	`Publish-Script`
`Register-PSResourceRepository`	`Register-PSRepository`
`Save-PSResource`	`Save-Module`
`Save-PSResource`	`Save-Script`
`Set-PSResourceRepository`	`Set-PSRepository`
`Test-PSScriptFileInfo`	`Test-ScriptFileInfo`
`Uninstall-PSResource`	`Uninstall-Module`
`Uninstall-PSResource`	`Uninstall-Script`
`Unregister-PSResourceRepository`	`Unregister-PSRepository`
`Update-PSModuleManifest`	`Update-ModuleManifest`
`Update-PSResource`	`Update-Module`
`Update-PSResource`	`Update-Script`
`Update-PSScriptFileInfo`	`Update-ScriptFileInfo`

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": {}
}

次の方法で共有