Sdílet prostřednictvím

about_PSResourceGet

  • Článek

Krátký popis

Popisuje, jak používat verzi 1.0.5 modulu Microsoft.PowerShell.PSResourceGet .

Dlouhý popis

Microsoft.PowerShell.PSResourceGet je aktualizovaná verze modulu PowerShellGet , která je 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 modulu PowerShellGet obsahovaly samostatné příkazy pro práci s moduly a skripty. V Microsoft.PowerShell.PSResourceGet jsou všechny balíčky v Galerie prostředí PowerShell definovány jako objekty PSResource. Tím se sníží počet rutin z 26 ve verzi 2.x na 18 ve verzi 0.9.

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

Microsoft.PowerShell.PSResourceGet PowerShellGet v2
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 –
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 poskytuje parametr Verze , který umožňuje zadat rozsah verzí, které se mají vyhledat. Parametr Version používá syntaxi správy verzí NuGet. Další informace o rozsazích verzí NuGet najdete v tématu Správa verzí balíčků.

PowerShellGet podporuje všechny kromě minimální inkluzivní verze uvedené v dokumentaci k rozsahu verzí NuGet. Použití 1.0.0.0 jako verze nepřináší 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, ] ho jako rozsah verzí.

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

Rutina Install-PSResource obsahuje parametry RequiredResource a RequiredResourceFile , které slouží k vyhledání objektů PSResource 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 je hashtable uložen v .psd1 souboru a objekt JSON je uložen v .json souboru.

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é