about_PSResourceGet

Krátký popis

Popisuje, jak používat verzi 1.1.0-rc1 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é