about_PSResourceGet

Artikel
10/31/2024

Korte beschrijving

Hierin wordt beschreven hoe u versie 1.1.0-rc1 van de module Microsoft.PowerShell.PSResourceGet gebruikt.

Lange beschrijving

Microsoft.PowerShell.PSResourceGet is een bijgewerkte versie van de module PowerShellGet volledig geschreven in C#.

Deze versie van PowerShellGet richt zich op een aantal belangrijke gebieden:

Vereenvoudig de codebasis waardoor het eenvoudiger is om bugs te verbeteren en op te lossen
Verwijder de afhankelijkheid van de module PackageManagement en gebruik de NuGet-bibliotheek rechtstreeks
Problemen met langdurige bruikbaarheid oplossen die wijzigingen van v2 veroorzaken
Compatibiliteit behouden voor bestaande scripts die v2 verwachten via een afzonderlijke compatibiliteitsmodule
Zoek- en installatieprestaties verbeteren

Ontwerpwijzigingen

Vorige versies van PowerShellGet hadden afzonderlijke opdrachten om te werken met modules en scripts. In Microsoft.PowerShell.PSResourceGetworden alle pakketten in de PowerShell Gallery gedefinieerd als PSResource--objecten.

In de volgende tabel ziet u de cmdlets die beschikbaar zijn in PowerShellGet v3 en de bijbehorende v2-equivalenten.

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

Zoeken op NuGet-versiebereiken

Verschillende cmdlets Microsoft.PowerShell.PSResource Get bieden een versie- parameter waarmee u een reeks versies kunt opgeven waarnaar u wilt zoeken. De parameter Version maakt gebruik van de nuGet-versiebeheersyntaxis. Zie Package versioningvoor meer informatie over NuGet-versiebereiken.

PowerShellGet ondersteunt alle, maar de minimale, inclusieve versie vermeld in de documentatie van het NuGet-versiebereik. Het gebruik van 1.0.0.0 omdat de versie geen versies 1.0.0.0 en hoger oplevert (minimaal inclusief bereik). In plaats daarvan wordt de waarde beschouwd als de vereiste versie. Als u wilt zoeken naar een minimaal inclusief bereik, gebruikt u [1.0.0.0, ] als versiebereik.

Zoeken op vereiste resources

De cmdlet Install-PSResource heeft RequiredResource en RequiredResourceFile parameters die worden gebruikt om PSResource--objecten te vinden die voldoen aan specifieke criteria. U kunt de zoekcriteria opgeven met behulp van een hashtabel of een JSON-object. Voor de parameter RequiredResourceFile wordt de hashtabel opgeslagen in een .psd1-bestand en wordt het JSON-object opgeslagen in een .json bestand.

De hashtabel kan kenmerken voor meerdere modules bevatten. In het volgende voorbeeld ziet u de structuur van de modulespecificatie:

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

Dit voorbeeld bevat specificaties voor drie modules. Zoals u kunt, zijn de modulekenmerken optioneel.

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

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

    TestModule99 = @{}
}

In het volgende voorbeeld ziet u dezelfde specificatie in JSON-indeling.

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

Delen via