about_PSResourceGet

Articolo
01/10/2025

Breve descrizione

Viene descritto come usare la versione 1.1.0 del modulo Microsoft.PowerShell.PSResourceGet.

Descrizione lunga

Microsoft.PowerShell.PSResourceGet è una versione aggiornata del modulo powerShellGet completamente scritto in C#.

Questa versione di PowerShellGet è incentrata su alcune aree chiave:

Semplificare la code base semplificando l'miglioramento e la correzione dei bug
Rimuovere la dipendenza dal modulo PackageManagement e usare direttamente la libreria NuGet
Risolvere i problemi di usabilità di lunga durata che causano un'interruzione delle modifiche dalla versione 2
Mantenere la compatibilità per gli script esistenti scritti in attesa della versione 2 tramite un modulo di compatibilità separato
Migliorare le prestazioni di ricerca e installazione

Modifiche alla progettazione

Le versioni precedenti di PowerShellGet avevano comandi separati da usare con moduli e script. In Microsoft.PowerShell.PSResourceGet, tutti i pacchetti in PowerShell Gallery vengono definiti come oggetti PSResource.

La tabella seguente illustra i cmdlet disponibili in PowerShellGet v3 e i relativi equivalenti v2.

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`

Ricerca in base a intervalli di versioni di NuGet

Diversi cmdlet Microsoft.PowerShell.PSResourceGet forniscono un parametro Version che consente di specificare un intervallo di versioni da cercare. Il parametro version usa la sintassi di controllo delle versioni di NuGet. Per altre informazioni sugli intervalli di versioni di NuGet, vedere Controllo delle versioni dei pacchetti.

PowerShellGet supporta tutte le versioni incluse elencate nella documentazione dell'intervallo di versioni di NuGet. L'uso di 1.0.0.0 perché la versione non restituisce versioni 1.0.0.0 e successive (intervallo inclusivo minimo). Il valore viene invece considerato la versione richiesta. Per cercare un intervallo inclusivo minimo, usare [1.0.0.0, ] come intervallo di versioni.

Ricerca in base alle risorse necessarie

Il cmdlet Install-PSResource include RequiredResource e parametri RequiredResourceFile usati per trovare oggetti PSResource corrispondenti a criteri specifici. È possibile specificare i criteri di ricerca usando una tabella hash o un oggetto JSON. Per il parametro RequiredResourceFile, la tabella hash viene archiviata in un file .psd1 e l'oggetto JSON viene archiviato in un file .json.

La tabella hash può contenere attributi per più moduli. L'esempio seguente illustra la struttura della specifica del modulo:

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

Questo esempio contiene le specifiche per tre moduli. Come è possibile, gli attributi del modulo sono facoltativi.

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

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

    TestModule99 = @{}
}

L'esempio seguente mostra la stessa specifica in formato JSON.

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

Condividi tramite