Share via

about_PSResourceGet

  • Cikk

Rövid leírás

A Microsoft.PowerShell.PSResourceGet modul 1.0.5-ös verziójának használatát ismerteti.

Hosszú leírás

A Microsoft.PowerShell.PSResourceGet a PowerShellGet modul teljesen C#-ban írt frissített verziója.

A PowerShellGet ezen verziója néhány kulcsfontosságú területre összpontosít:

  • A kódbázis egyszerűsítése a hibák javításának és javításának megkönnyítése érdekében
  • Távolítsa el a PackageManagement modultól való függőséget, és használja közvetlenül a NuGet-kódtárat
  • A v2-ről származó kompatibilitástörő változásokat okozó, régóta fennálló használhatósági problémák megoldása
  • A v2-t váró meglévő szkriptek kompatibilitásának fenntartása külön kompatibilitási modulon keresztül
  • A keresési és telepítési teljesítmény javítása

Tervezési módosítások

A PowerShellGet korábbi verzióiban külön parancsok voltak a modulok és szkriptek használatához. A Microsoft.PowerShell.PSResourceGetben a PowerShell-galéria összes csomagja PSResource objektumként van definiálva. Ez csökkenti a parancsmagok számát a 2.x verzió 26-ról 18-ra a 0.9-es verzióban.

Az alábbi táblázat a PowerShellGet v3-ban elérhető parancsmagokat és azok v2-ekvivalenseit mutatja be.

Microsoft.PowerShell.PSResourceGet PowerShellGet v2
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

Keresés NuGet-verziótartományok szerint

Számos Microsoft.PowerShell.PSResourceGet-parancsmag egy Verzió paramétert biztosít, amely lehetővé teszi a keresendő verziók tartományának megadását. A Verzió paraméter a NuGet verziószámozási szintaxisát használja. A NuGet-verziótartományokról további információt a Csomag verziószámozása című témakörben talál.

A PowerShellGet a NuGet-verziótartomány dokumentációjában felsorolt minimális befogadó verzión kívül minden verziót támogat. A verzió használata 1.0.0.0 nem eredményez 1.0.0.0.0-s vagy újabb verziót (minimális befogadó tartomány). Ehelyett az érték a szükséges verziónak minősül. A minimális befogadó tartomány kereséséhez használja [1.0.0.0, ] a verziótartományt.

Keresés a szükséges erőforrások szerint

A Install-PSResource parancsmag requiredResource és RequiredResourceFile paraméterekkel rendelkezik, amelyek meghatározott feltételeknek megfelelő PSResource-objektumok keresésére szolgálnak. A keresési feltételeket kivonatolóval vagy JSON-objektummal adhatja meg. A RequiredResourceFile paraméter esetében a kivonatoló egy .psd1 fájlban, a JSON-objektum pedig egy .json fájlban van tárolva.

A kivonatoló több modul attribútumait is tartalmazhatja. Az alábbi példa a modul specifikációjának szerkezetét mutatja be:

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

Ez a példa három modul specifikációit tartalmazza. Ahogy teheti, a modulattribútumok nem kötelezőek.

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

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

    TestModule99 = @{}
}

A következő példa ugyanazt a specifikációt mutatja be JSON formátumban.

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

Lásd még