Install-PSResource

Modul:

Microsoft.PowerShell.PSResourceGet

Erőforrásokat telepít egy regisztrált adattárból.

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 számítógépen lévő telepítési útvonalra. 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érdéseket.

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

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 7.3.0 és 8.3.0kö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. Az Újratelepítés paraméter használata esetén 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 kivonattáblá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

Meghatározza, 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.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-AuthenticodeCheck

Ellenőrzi az Authenticode aláírásokat és a katalógusfájlokat Windows rendszeren.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

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

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

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

Type:	PSCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Folyamatbemenethez használatos.

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:	ParentResource
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Egy vagy több telepítendő erőforrás neve.

Type:	String[]
Position:	0
Default value:	None
Required:	True
Accept pipeline input:	True
Accept wildcard characters:	False

-NoClobber

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-PassThru

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

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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.

Type:	SwitchParameter
Aliases:	IsPrerelease
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False

-Quiet

Letiltja a telepítési folyamatjelzőt.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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 lesz í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ó párhuzamosan települ egy új verzióspecifikus mappába.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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 sorrendben 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, az összes névnek tartalmaznia kell a helyettesítő karaktert, vagy el kell kihagynia azt. Helyettesítő karakterekkel és anélkül nem adhatja meg a nevek kombinációját.

Type:	String[]
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-RequiredResource

Egy kivonatoló vagy JSON-sztring, amely megadja a telepíteni kívánt erőforrásokat. A helyettesítő karakterek nem használhatók. A fájlformátumok leírását a JEGYZETEK szakaszban találja.

Type:	Object
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-RequiredResourceFile

.psd1 A telepítendő erőforrásokat meghatározó vagy .json elérési út. A helyettesítő karakterek nem használhatók. A fájlformátumok leírását a JEGYZETEK szakaszban találja.

Type:	String
Position:	Named
Default value:	None
Required:	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 a 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éldául:

• $env:ProgramFiles\PowerShell\Modules

A CurrentUser modulok telepítése olyan helyen, 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

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	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. Nincs telepítve a talált erőforrás erőforrása.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	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ül az aktuális felhasználó ideiglenes mappájába.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-TrustRepository

Tiltsa le a megbízható adattárra vonatkozó kéréseket. A megbízhatósági kérés csak akkor jelenik meg, ha az adattár nincs megbízhatóként konfigurálva.

Type:	SwitchParameter
Position:	Named
Default value:	False
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Version

A visszaadni kívánt 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ó-készítés.

A PowerShellGet a NuGet-verziótartomány dokumentációjában felsorolt minimális befogadó verzión kívül az összeset támogatja. A verzióként való használat 1.0.0.0 nem eredményez 1.0.0.0-s vagy újabb verziót (minimális befogadó tartomány). Ehelyett a rendszer a szükséges verziónak tekinti az értéket. A minimális befogadó tartomány kereséséhez használja [1.0.0.0, ] a verziótartományt.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	True

-WhatIf

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

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Required:	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őt: Install-PSResource.

A RequiredResource és a RequiredResourceFile paraméterekkel megkereshetőek az adott feltételeknek megfelelő PSResource-objektumok . A keresési feltételeket hashtable vagy JSON-objektum használatával adhatja meg. A RequiredResourceFile paraméter esetében a kivonattábla 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