about_PSResourceGet

發行項
01/10/2025

簡短描述

描述如何使用 Microsoft.PowerShell.PSResourceGet 模組 1.1.0 版。

完整描述

Microsoft.PowerShell.PSResourceGet 是以 C# 完整撰寫的 PowerShellGet 模組更新版本。

此版本的 PowerShellGet 著重於幾個主要領域：

簡化程式代碼基底，讓您更輕鬆地增強和修正 Bug
拿掉 PackageManagement 模組的相依性，並直接使用 NuGet 連結庫
解決從 v2 中斷變更的長期可用性問題
透過個別相容性模組維護預期 v2 所撰寫之現有腳本的相容性
改善搜尋和安裝效能

設計變更

舊版 PowerShellGet 有個別的命令來處理模組和腳本。在 Microsoft.PowerShell.PSResourceGet中，PowerShell 資源庫中的所有套件都會定義為 PSResource 物件。

下表顯示 PowerShellGet v3 及其 v2 對等專案的 Cmdlet。

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 Cmdlet 提供 Version 參數，可讓您指定要搜尋的版本範圍。 Version 參數使用 NuGet 版本設定語法。如需 NuGet 版本範圍的詳細資訊，請參閱套件版本設定。

PowerShellGet 支援 NuGet 版本範圍檔中所列 最低內含版本。使用 1.0.0.0，因為版本不會產生 1.0.0.0 版和更新版本（最小內含範圍）。相反地，此值會被視為必要的版本。若要搜尋最小內含範圍，請使用 [1.0.0.0, ] 作為版本範圍。

依必要資源搜尋

Install-PSResource Cmdlet 具有 RequiredResource 和 RequiredResourceFile 參數，這些參數可用來尋找符合特定準則 PSResource 物件。您可以使用哈希表或 JSON 物件來指定搜尋準則。對於 requiredResourceFile 參數，哈希表會儲存在檔案中，而 JSON 物件會儲存在檔案中。

哈希表可以包含多個模組的屬性。下列範例顯示模組規格的結構：

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

此範例包含三個模組的規格。您可以視需要選擇模組屬性。

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

共用方式為