Install-PSResource

Modul:

Microsoft.PowerShell.PSResourceGet Module

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

Syntax

NameParameterSet (Alapértelmezett)

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>]

InputObjectParameterSet

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

RequiredResourceFileParameterSet

Install-PSResource
    -RequiredResourceFile <String>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

RequiredResourceParameterSet

Install-PSResource
    -RequiredResource <Object>
    [-Credential <PSCredential>]
    [-Scope <ScopeType>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-Reinstall]
    [-Quiet]
    [-AcceptLicense]
    [-NoClobber]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-PassThru]
    [-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 és Install-ScriptPowerShellGet v2-ből származó 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.

Megjegyzés:

Install-PSResource nem telepít függő erőforrásokat a NuGet v3 protokollt használó adattárakból. A függő erőforrásokat egyenként kell telepítenie. Ezt a funkciót egy későbbi kiadásban szeretnénk hozzáadni.

Példák

1. példa

Telepíti az Az modul legújabb stabil (nem előzetes) verzióját a PowerShell-katalógusból.

Install-PSResource Az -Repository PSGallery

Az Az modul egy metamodul, amely függőségként tartalmazza az összes Az PowerShell-modult. Ez a parancs telepíti az Az modult és annak összes függőségét.

2. példa

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

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

3. példa

Telepíti az Az modul legújabb stabil verzióját. Ha a Újratelepíti paramétert, 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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-AuthenticodeCheck

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Confirm

Megerősítést kér a parancsmag futtatása előtt.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Cf

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Credential

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

Paramétertulajdonságok

Típus:	PSCredential
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-InputObject

Folyamatbemenethez használatos.

Paramétertulajdonságok

Típus:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Szülői erőforrás

Paraméterkészletek

InputObjectParameterSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Name

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

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

NameParameterSet

Position:	0
Kötelező:	True
Folyamatból származó érték:	True
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-NoClobber

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-PassThru

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-Prerelease

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	IsKiadás előtt

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-Quiet

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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ási értékek nagyobb 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.

Paramétertulajdonságok

Típus:	String[]
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

InputObjectParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-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.

Paramétertulajdonságok

Típus:	Object
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

RequiredResourceParameterSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

-RequiredResourceFile

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

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

RequiredResourceFileParameterSet

Position:	Named
Kötelező:	True
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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 a CurrentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.

A AllUsers hatókör a modulokat a számítógép minden felhasználója számára elérhető helyen telepíti. Például:

• $env:ProgramFiles\PowerShell\Modules

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

• $home\Documents\PowerShell\Modules

Paramétertulajdonságok

Típus:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Alapértelmezett érték:	None
Elfogadott értékek:	CurrentUser, AllUsers
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	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.

További információ a NuGet-verziótartományokról: Csomagverziós.

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 1.0.0.0 verzióként való használata 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 a [1.0.0.0, ] verziótartományként.

Paramétertulajdonságok

Típus:	String
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	True
DontShow:	False

Paraméterkészletek

NameParameterSet

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-WhatIf

Megjeleníti, mi történne, ha a parancsmag futna. A parancsprogram nem lett futtatva.

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	False
Támogatja a helyettesítő karaktereket:	False
DontShow:	False
Aliasok:	Wi

Paraméterkészletek

(All)

Position:	Named
Kötelező:	False
Folyamatból származó érték:	False
Folyamatból származó érték tulajdonságnév alapján:	False
Fennmaradó argumentumokból származó érték:	False

CommonParameters

Ez a parancsmag a következő gyakori paramétereket támogatja: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction és -WarningVariable. További információért lásd about_CommonParameters.

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 a isresaliasaként definiálja a Install-PSResource.

A RequiredResource és RequiredResourceFile paraméterekkel megkeresi PSResource adott feltételeknek megfelelő objektumokat. 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.

Kapcsolódó hivatkozások

• Csomag verziószámozása
• Uninstall-PSResource