about_PSResourceGet

Článek
12/04/2024

Krátký popis

Popisuje, jak používat verzi 1.1.0-rc2 modulu Microsoft.PowerShell.PSResourceGet.

Dlouhý popis

Microsoft.PowerShell.PSResourceGet je aktualizovaná verze modulu PowerShellGet kompletně napsaná v jazyce C#.

Tato verze modulu PowerShellGet se zaměřuje na několik klíčových oblastí:

Zjednodušení základu kódu, což usnadňuje vylepšení a opravu chyb.
Odeberte závislost na modulu PackageManagement a použijte přímo knihovnu NuGet .
Řešení dlouhodobých problémů s použitelností, které by byly zásadními změnami z v2
Zachování kompatibility pro existující skripty napsané s očekáváním v2 prostřednictvím samostatného modulu kompatibility
Zlepšení výkonu vyhledávání a instalace

Změny návrhu

Předchozí verze PowerShellGet měly samostatné příkazy pro práci s moduly a skripty. V Microsoft.PowerShell.PSResourceGetjsou všechny balíčky v Galerii prostředí PowerShell definovány jako PSResource objekty.

Následující tabulka ukazuje rutiny, které jsou k dispozici v PowerShellGet v3 a jejich ekvivalenty v2.

Microsoft.PowerShell.PSResourceGet	PowerShellGet v2
`Compress-PSResource`	není k dispozici
`Find-PSResource`	`Find-Command`
`Find-PSResource`	`Find-DscResource`
`Find-PSResource`	`Find-Module`
`Find-PSResource`	`Find-Script`
není k dispozici	`Find-RoleCapability`
`Get-InstalledPSResource`	`Get-InstalledModule`
`Get-InstalledPSResource`	`Get-InstalledScript`
`Get-PSResourceRepository`	`Get-PSRepository`
`Get-PSScriptFileInfo`	není k dispozici
`Import-PSGetRepository`	není k dispozici
`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`

Vyhledávání podle rozsahů verzí NuGet

Několik rutin Microsoft.PowerShell.PSResourceGet poskytují parametr verze, který umožňuje zadat rozsah verzí, které se mají vyhledat. Parametr verze používá syntaxi správy verzí NuGet. Další informace o rozsazích verzí NuGet najdete v tématu Správa verzí balíčku.

PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0, protože verze nevolí verze 1.0.0.0 a vyšší (minimální včetně rozsahu). Místo toho se hodnota považuje za požadovanou verzi. Pokud chcete vyhledat minimální inkluzivní rozsah, použijte [1.0.0.0, ] jako rozsah verzí.

Vyhledávání podle požadovaných prostředků

Rutina Install-PSResource obsahuje RequiredResource a RequiredResourceFile parametry, které slouží k vyhledání PSResource objektů odpovídajících konkrétním kritériím. Kritéria hledání můžete zadat pomocí hashtable nebo objektu JSON. U parametru RequiredResourceFile se hodnota hashtable uloží do souboru .psd1 a objekt JSON se uloží do souboru .json.

Hashtable může obsahovat atributy pro více modulů. Následující příklad ukazuje strukturu specifikace modulu:

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

Tento příklad obsahuje specifikace pro tři moduly. Jak můžete, atributy modulu jsou volitelné.

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

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

    TestModule99 = @{}
}

Následující příklad ukazuje stejnou specifikaci ve formátu JSON.

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

Viz také

Install-PSResource
Find-PSResource
get-installedPSResource
Install-PSResource
Save-PSResource
Uninstall-PSResource
Update-PSResource

Sdílet prostřednictvím