Install-Module

Referencia

Modul:: PowerShellGet

Letölt egy vagy több modult egy adattárból, és telepíti őket a helyi számítógépre.

Syntax

Install-Module
       [-Name] <String[]>
       [-MinimumVersion <String>]
       [-MaximumVersion <String>]
       [-RequiredVersion <String>]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-Force]
       [-AllowPrerelease]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Install-Module
       [-InputObject] <PSObject[]>
       [-Credential <PSCredential>]
       [-Scope <String>]
       [-Proxy <Uri>]
       [-ProxyCredential <PSCredential>]
       [-AllowClobber]
       [-SkipPublisherCheck]
       [-Force]
       [-AcceptLicense]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

A Install-Module parancsmag egy vagy több olyan modult kap, amely megfelel egy online adattár megadott feltételeinek. A parancsmag ellenőrzi, hogy a keresési eredmények érvényes modulok-e, és a modulmappákat a telepítési helyre másolja. A telepített modulok nem lesznek automatikusan importálva a telepítés után. A telepített modulokat a megadott modulok minimális, maximális és pontos verziói alapján szűrheti.

Ez egy proxyparancsmag a Get-InstalledPSResourceMicrosoft.PowerShell.PSResourceGet parancsmaghoz. További információ: Install-PSResource.

Példák

1. példa: Modul keresése és telepítése

Ez a példa megkeres egy modult az adattárban, és telepíti a modult.

Find-Module -Name PowerShellGet | Install-Module

A Find-ModuleNév paraméter használatával adja meg a PowerShellGet modult. Alapértelmezés szerint a modul legújabb verziója töltődik le az adattárból. A rendszer elküldi az objektumot a folyamatnak a Install-Module parancsmagba. Install-Module telepíti a modult az összes felhasználó számára a fájlban $env:ProgramFiles\PowerShell\Modules.

2. példa: Modul telepítése név szerint

Ebben a példában a PowerShellGet modul legújabb verziója van telepítve.

Install-Module -Name PowerShellGet

A Install-ModuleNév paraméter használatával adja meg a PowerShellGet modult. Alapértelmezés szerint a modul legújabb verziója letöltődik az adattárból, és telepítve van.

3. példa: Modul telepítése a minimális verzióval

Ebben a példában a PowerShellGet modul minimális verziója van telepítve. A MinimumVersion paraméter határozza meg a modul azon legalacsonyabb verzióját, amelyet telepíteni kell. Ha elérhető a modul újabb verziója, a rendszer letölti és telepíti az adott verziót az összes felhasználó számára.

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

A Install-ModuleNév paraméter használatával adja meg a PowerShellGet modult. A MinimumVersion paraméter azt határozza meg, hogy a 2.0.1-es verzió letöltődik az adattárból, és telepítve van. Mivel a 2.0.4-es verzió elérhető, ez a verzió minden felhasználó számára le lesz töltve és telepítve.

4. példa: Modul adott verziójának telepítése

Ebben a példában a PowerShellGet modul egy adott verziója van telepítve.

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

A Install-ModuleNév paraméter használatával adja meg a PowerShellGet modult. A RequiredVersion paraméter azt határozza meg, hogy a 2.0.0-s verzió minden felhasználó számára letöltve és telepítve legyen.

5. példa: Modul telepítése csak az aktuális felhasználó számára

Ez a példa letölti és telepíti a modul legújabb verzióját, csak az aktuális felhasználó számára.

Install-Module -Name PowerShellGet -Scope CurrentUser

A Install-ModuleNév paraméter használatával adja meg a PowerShellGet modult. Install-Module letölti és telepíti a PowerShellGet legújabb verzióját az aktuális felhasználó könyvtárába( $HOME\Documents\PowerShell\Modules).

6. példa: Modul legújabb előzetes verziójának telepítése

Ez a példa bemutatja, hogyan telepítheti a modul legújabb verzióját, ha az előzetes verzió. Az előzetes verzió telepítéséhez az AllowPrerelease paraméter szükséges .

Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease

Ezzel a módszerrel a legújabb verzió érhető el. Ha a legújabb verzió nem előzetes verzió, akkor a modul legújabb stabil verzióját kapja meg.

7. példa: Modul adott előzetes verziójának telepítése

Ez a példa bemutatja, hogyan telepíthető egy modul egy adott előzetes verziója. A Find-Module parancsmag a modulok előzetes verzióinak megkeresésére használható a PowerShell-galéria.

Az előzetes verziók formátuma <version_number>-<prerelease_label>: .

Find-Module PSReadLine -AllVersions -AllowPrerelease | Select-Object -First 5

Version        Name             Repository       Description
-------        ----             ----------       -----------
2.2.6          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.5          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.4-beta1    PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.3          PSReadLine       PSGallery        Great command line editing in the PowerS…
2.2.2          PSReadLine       PSGallery        Great command line editing in the PowerS…

Install-Module -Name PSReadLine -RequiredVersion 2.2.4-beta1 -AllowPrerelease

Használja a PowerShell-galéria a RequiredVersion paraméter értékét.

Paraméterek

-AcceptLicense

Licenccel rendelkező modulok esetén az AcceptLicense automatikusan elfogadja a licencszerződést a telepítés során. További információ: Licencelfoglalást igénylő modulok.

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

-AllowClobber

Felülbírálja a számítógépen meglévő parancsokkal kapcsolatos telepítési ütközésekkel kapcsolatos figyelmeztető üzeneteket. Felülírja azokat a meglévő parancsokat, amelyek neve megegyezik a modul által telepített parancsokkal. Az AllowClobber és a Force együtt használható egy Install-Module parancsban.

A proxyparancsmag ennek a paraméternek az értékét a parancsmag NoClobber paraméterévé Install-PSResource alakítja.

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

-AllowPrerelease

Lehetővé teszi egy előzetes kiadásként megjelölt modul telepítését.

A proxyparancsmag ezt a paramétert a prerelease paraméterreInstall-PSResourceképezi le.

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

-Confirm

Megerősítést kér a Install-Module 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

Olyan felhasználói fiókot ad meg, amely jogosultságokkal rendelkezik egy adott csomagszolgáltató vagy -forrás moduljának telepítéséhez.

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

-Force

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Install-PSResource

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

-InputObject

Folyamatbemenethez használatos. Hiba jelenik meg, ha egy érték közvetlenül az InputObjectnek van megadva. A folyamat használatával adja át az objektumokat az InputObject paraméterrel.

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

-MaximumVersion

A proxy parancsmagja ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Install-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-MinimumVersion

A proxy parancsmagja ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Install-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-Name

Megadja az online katalógusból telepíteni kívánt modulok pontos nevét. A modulnevek vesszővel tagolt listája elfogadott. A modul nevének meg kell egyeznie az adattár modulnevével. A használatával Find-Module lekérheti a modulnevek listáját.

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

-PassThru

A PassThru paraméter Install-Module használatakor egy PSRepositoryItemInfo objektumot ad ki a modulhoz. Ez ugyanaz az információ, amelyet a Find-Module parancsmagból kap.

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

-Proxy

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Install-PSResource

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

-ProxyCredential

A proxy parancsmagja figyelmen kívül hagyja ezt a paramétert, mivel az nem támogatja.Install-PSResource

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

-Repository

Az Adattár paraméterrel megadhatja annak az adattárnak a nevét, amelyből modult tölthet le és telepíthet. Több adattár regisztrálásakor használatos. Egy regisztrált adattár nevét adja meg a Install-Module parancsban. Adattár regisztrálásához használja a következőt Register-PSRepository: . A regisztrált adattárak megjelenítéséhez használja a következőt Get-PSRepository: .

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

-RequiredVersion

A proxy parancsmagja ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési Install-PSResourcesztringet a Verzió paraméterrel való használatra.

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

-Scope

Meghatározza a modul telepítési hatókörét. A paraméter elfogadható értékei az AllUsers és a CurrentUser.

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

$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

Ha nincs definiálva hatókör , az alapértelmezett beállítás a PowerShellGet-verzió alapján van beállítva.

A PowerShellGet 1.x verzióiban az alapértelmezett allUsers, amely a telepítéshez jogosultságszint-emelést igényel.
A PowerShellGet 2.0.0-s és újabb verziói a PowerShell 6-os vagy újabb verziójában:
- Az alapértelmezett érték a CurrentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.
- Ha emelt szintű munkamenetben fut, az alapértelmezett érték az AllUsers.

Type:	String
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipPublisherCheck

A proxy parancsmagja ezt a paramétert AthenticodeCheck értékre alakítja a hívás Install-PSResourceelőtt.

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

-WhatIf

Azt mutatja, mi történne, ha egy Install-Module parancsot futtatnának. A parancsmag nem fut.

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

Bevitelek

PSRepositoryItemInfo

Find-ModulePSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamatba.Install-Module

String[]

PSObject[]

String

PSCredential

Uri

Kimenetek

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

A PassThru paraméter Install-Module használatakor egy PSRepositoryItemInfo objektumot ad ki a modulhoz. Ez ugyanaz az információ, amelyet a Find-Module parancsmagból kap.

Jegyzetek

A PowerShell a következő aliasokat tartalmazza:Install-Module

Összes platform:
- inmo

Install-Module a PowerShell 5.0-s vagy újabb verzióiban, a Windows 7-es vagy a Windows 2008 R2-es és újabb verzióiban fut.

Fontos

2020 áprilisától a PowerShell-galéria már nem támogatja a Transport Layer Security (TLS) 1.0-s és 1.1-es verzióját. Ha nem TLS 1.2-t vagy újabb verziót használ, hibaüzenet jelenik meg a PowerShell-galéria elérésekor. Az alábbi paranccsal győződjön meg arról, hogy a TLS 1.2-t használja:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

További információért tekintse meg a bejelentést a PowerShell-blogon.

Biztonsági ajánlott eljárásként értékelje ki a modul kódját, mielőtt első alkalommal futtatja a parancsmagokat vagy függvényeket. A kártékony kódot tartalmazó modulok futtatásának megakadályozása érdekében a telepített modulok nem lesznek automatikusan importálva a telepítés után.

Ha a Name paraméter által megadott modulnév nem létezik az adattárban, Install-Module hibát ad vissza.

Több modul telepítéséhez használja a Name paramétert, és adjon meg egy vesszővel tagolt modulneveket tartalmazó tömböt. Ha több modulnevet ad meg, nem használhatja a MinimumVersion, a MaximumVersion vagy a RequiredVersion nevet. Find-ModulePSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamatba.Install-Module A folyamat egy másik módja annak, hogy több modult adjon meg egyetlen parancsban való telepítéshez.

Alapértelmezés szerint az AllUsers hatóköréhez tartozó modulok a(z) rendszerben $env:ProgramFiles\PowerShell\Modulesvannak telepítve. Az alapértelmezett beállítás megakadályozza a zavart a PowerShell-Desired State Configuration (DSC) erőforrások telepítésekor.

A modul telepítése sikertelen, és nem importálható, ha nem rendelkezik .psm1, .psd1vagy .dll azonos nevűvel a mappában. A modul telepítéséhez használja a Force paramétert.

Ha egy meglévő modul verziója megegyezik a Name paraméter által megadott névvel, és a MinimumVersion vagy a RequiredVersion paraméter nem használatos, csendesen folytatja, Install-Module de nem telepíti a modult.

Ha egy meglévő modul verziója nagyobb, mint a MinimumVersion paraméter értéke, vagy megegyezik a RequiredVersion paraméter értékével, csendesen folytatja, Install-Module de nem telepíti a modult.

Ha a meglévő modul nem egyezik a MinimumVersion vagy a RequiredVersion paraméterek által megadott értékekkel, hiba történik a Install-Module parancsban. Ha például a meglévő telepített modul verziója alacsonyabb, mint a MinimumVersion érték, vagy nem egyenlő a RequiredVersion értékkel.

Install-Module emellett telepíti a modul közzétevője által előírt módon megadott függő modulokat is. A közzétevő felsorolja a szükséges modulokat és azok verzióit a moduljegyzékben.

Install-Module

Syntax

Description

Példák

1. példa: Modul keresése és telepítése

2. példa: Modul telepítése név szerint

3. példa: Modul telepítése a minimális verzióval

4. példa: Modul adott verziójának telepítése

5. példa: Modul telepítése csak az aktuális felhasználó számára

6. példa: Modul legújabb előzetes verziójának telepítése

7. példa: Modul adott előzetes verziójának telepítése

Paraméterek

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

Visszajelzés

További források

Install-Module

Syntax

Description

Példák

1. példa: Modul keresése és telepítése

2. példa: Modul telepítése név szerint

3. példa: Modul telepítése a minimális verzióval

4. példa: Modul adott verziójának telepítése

5. példa: Modul telepítése csak az aktuális felhasználó számára

6. példa: Modul legújabb előzetes verziójának telepítése

7. példa: Modul adott előzetes verziójának telepítése

Paraméterek

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások

Visszajelzés

További források