Megosztás a következőn keresztül:

Install-PSResource

  • Referencia
Modul:
Microsoft.PowerShell.PSResourceGet

Egy regisztrált adattárból telepíti az erőforrásokat.

Syntax

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

Ez a parancsmag erőforrásokat telepít egy regisztrált adattárból egy gép telepítési útvonalára. Alapértelmezés szerint a parancsmag nem ad vissza objektumot. Más paraméterekkel megadhatja az erőforrás adattárát, hatókörét és verzióját, és letilthatja a licenckéréseket.

Ez a parancsmag egyesíti a Install-Module PowerShellGet v2-ből származó parancsmagok és Install-Script parancsmagok funkcióit.

Install-PSResource nem tölti be az újonnan telepített modult az aktuális munkamenetbe. Importálnia kell az új verziót, vagy új munkamenetet kell indítania a frissített modul használatához. További információ: Import-Module.

Példák

1. példa

Telepíti az Az modul legújabb stabil (nem előzetes) verzióját.

Install-PSResource Az

2. példa

Telepíti a legújabb stabil Az modult a verziók és 8.3.0a .7.3.0

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

3. példa

Telepíti az Az modul legújabb stabil verzióját. Az Újratelepítés paraméter használatakor a parancsmag a korábban telepített verziókra ír.

Install-PSResource Az -Reinstall

4. példa

Telepíti a psd1 fájlban megadott PSResource-okat.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

5. példa

Telepíti a kivonatolóban megadott PSResource-okat.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Paraméterek

-AcceptLicense

Megadja, hogy az erőforrásnak el kell fogadnia a licencszerződés elfogadására vonatkozó kéréseket. Ez letiltja a kérést, ha a modul arra kötelezi a felhasználót, hogy fogadja el a licencszerződést.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-AuthenticodeCheck

Hitelesít aláírásokat és katalógusfájlokat Windows rendszeren.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Jóváhagyást kér a parancsmag futtatása előtt.

Típus:SwitchParameter
Aliases:cf
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-Credential

Az adattárak elérésekor használt opcionális hitelesítő adatok.

Típus:PSCredential
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-InputObject

Folyamatbemenethez használatos.

Típus:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
alapértelmezett érték:None
Kötelező:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Egy vagy több telepíteni kívánt erőforrás neve.

Típus:String[]
Position:0
alapértelmezett érték:None
Kötelező:True
Accept pipeline input:True
Accept wildcard characters:False

-NoClobber

Megakadályozza a számítógépen már létező parancsmagokat tartalmazó csomag telepítését.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-PassThru

Ha meg van adva, egy PSResourceInfo objektumot ad ki a mentett erőforráshoz.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

Ha meg van adva, előzetes verziókat is tartalmaz a visszaadott keresési eredményekben.

Típus:SwitchParameter
Aliases:IsPrerelease
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:False

-Quiet

Letiltja a telepítési folyamatjelző sávot.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-Reinstall

Akkor is telepíti a modul legújabb verzióját, ha a legújabb verzió már telepítve van. A telepített verzió felül van írva. Ez lehetővé teszi a modul sérült telepítésének javítását.

Ha a modul egy régebbi verziója van telepítve, az új verzió egymás mellett lesz telepítve egy új verzióspecifikus mappában.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-Repository

Egy vagy több keresendő adattárnevet ad meg. Ha nincs megadva, a keresés az összes regisztrált adattárat prioritási sorrendben (elsőként a legmagasabb) tartalmazza, amíg meg nem találja a csomagot tartalmazó adattárat. Az adattárak prioritás, majd név szerint vannak rendezve. Az alacsonyabb prioritású értékek elsőbbséget élveznek.

Ha több adattárban keres erőforrásokat, a PSResourceGet parancsmagok ezzel a rendezési sorrenddel keresik az adattárakat. Install-PSResource Telepíti az első egyező csomagot az adattárak rendezett listájából.

A paraméter támogatja a * helyettesítő karaktert. Ha több adattárat ad meg, minden névnek tartalmaznia kell a helyettesítő karaktert, vagy kihagynia azt. Helyettesítő karakterekkel és anélkül nem adhatja meg a nevek kombinációját.

Típus:String[]
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:True

-RequiredResource

A telepíteni kívánt erőforrásokat meghatározó kivonatoló vagy JSON-sztring. A helyettesítő karakterek nem engedélyezettek. A fájlformátumok leírását a NOTES szakaszban találja.

Típus:Object
Position:Named
alapértelmezett érték:None
Kötelező:True
Accept pipeline input:False
Accept wildcard characters:False

-RequiredResourceFile

A telepíteni kívánt erőforrások elérési .psd1 útja..json A helyettesítő karakterek nem engedélyezettek. A fájlformátumok leírását a NOTES szakaszban találja.

Típus:String
Position:Named
alapértelmezett érték:None
Kötelező:True
Accept pipeline input:False
Accept wildcard characters:False

-Scope

Megadja a telepítési hatókört. Az elfogadott értékek a következők:

  • CurrentUser
  • AllUsers

Az alapértelmezett hatókör az CurrentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.

A AllUsers hatókör olyan helyre telepíti a modulokat, amely a számítógép összes felhasználója számára elérhető. Példa:

  • $env:ProgramFiles\PowerShell\Modules

A CurrentUser modulok telepítése olyan helyre, amely csak a számítógép aktuális felhasználója számára érhető el. Példa:

  • $home\Documents\PowerShell\Modules
Típus:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
elfogadott értékek:CurrentUser, AllUsers
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-SkipDependencyCheck

Kihagyja az erőforrás-függőségek ellenőrzését. Csak a talált erőforrások vannak telepítve. Nincsenek telepítve a talált erőforrás erőforrásai.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-TemporaryPath

Megadja az erőforrás tényleges telepítés előtti ideiglenes telepítésének elérési útját. Ha nincs megadva ideiglenes elérési út, az erőforrás ideiglenesen telepítve van az aktuális felhasználó ideiglenes mappájában.

Típus:String
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-TrustRepository

Tiltsa le a megbízható adattárra vonatkozó kéréseket. Az adattár megbízhatósági kérése csak akkor fordul elő, ha az adattár nincs megbízhatóként konfigurálva.

Típus:SwitchParameter
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

-Version

A visszaadandó erőforrás verzióját adja meg. Az érték lehet pontos verzió vagy verziótartomány a NuGet verziószámozási szintaxisával.

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.

Típus:String
Position:Named
alapértelmezett érték:None
Kötelező:False
Accept pipeline input:True
Accept wildcard characters:True

-WhatIf

Bemutatja, mi történne a parancsmag futtatásakor. A parancsmag nem fut.

Típus:SwitchParameter
Aliases:wi
Position:Named
alapértelmezett érték:False
Kötelező:False
Accept pipeline input:False
Accept wildcard characters:False

Bevitelek

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Kimenetek

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Alapértelmezés szerint a parancsmag nem ad vissza objektumokat. A PassThru paraméter használatakor a parancsmag egy PSResourceInfo objektumot ad ki a mentett erőforráshoz.

Jegyzetek

A modul aliasként definiálja isres a következőhöz: Install-PSResource.

A RequiredResource és a RequiredResourceFile paraméterekkel megkereshetőek az adott feltételeknek megfelelő PSResource-objektumok . 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. További információ: about_PSResourceGet.