Install-Module

Modul:

PowerShellGet Module

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

Syntax

NameParameterSet (Alapértelmezett)

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

InputObject

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.

Ha a telepített modul neve vagy verziója azonos, vagy parancsokat tartalmaz egy meglévő modulban, figyelmeztető üzenetek jelennek meg. Miután megerősítette, hogy telepíteni szeretné a modult, és felül szeretné bírálni a figyelmeztetéseket, használja a paramétereket és -Force a -AllowClobber paramétereket. Az adattár beállításaitól függően előfordulhat, hogy válaszolnia kell a modul telepítésének folytatására vonatkozó kérdésre.

A modul verziószámait tartalmazó paraméterek verziószámként formázott sztringeket várnak.

• A standard verziószámok formátuma x.y.z az x, y és z számokat jelöli
• Az előzetes verziók formátuma x.y.z-<prerelease_label><prerelease_label> az adott kiadáshoz rendelt tetszőleges sztring.

Ezek a példák a PowerShell-gyűjteményt használják egyetlen regisztrált adattárként. Get-PSRepository megjeleníti a regisztrált adattárakat. Ha több regisztrált adattárral rendelkezik, a -Repository paraméter használatával adja meg az adattár nevét.

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 letöltődik az adattárból. A rendszer elküldi az objektumot a folyamaton a Install-Module parancsmagnak. Install-Moduletelepíti a modult az összes felhasználó számára a következő helyen: .$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 a modul azon legalacsonyabb verzióját adja meg, amelyet telepíteni kell. Ha a modul egy újabb verziója érhető el, a rendszer letölti és telepíti a 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öltve legyen az adattárból, és telepítve legyen. Mivel a 2.0.4-es verzió elérhető, a rendszer letölti és telepíti a verziót az összes felhasználó számára.

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: Csak az aktuális felhasználó moduljának telepítése

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-Moduleletö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: A 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ó, 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-katalógusban.

A prerelease-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-katalógusban látható verziót a RequiredVersion paraméter értékéhez.

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ókért lásd a licenc elfogadását igénylő modulokat.

Paramétertulajdonságok

Típus:	SwitchParameter
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

-AllowClobber

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

Paramétertulajdonságok

Típus:	SwitchParameter
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

-AllowPrerelease

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

Paramétertulajdonságok

Típus:	SwitchParameter
Alapértelmezett érték:	None
Támogatja a helyettesítő karaktereket:	False
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:	False
Fennmaradó argumentumokból származó érték:	False

-Confirm

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

Olyan felhasználói fiókot határoz meg, amely jogosult modul telepítésére egy adott csomagszolgáltatóhoz vagy -forráshoz.

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:	True
Fennmaradó argumentumokból származó érték:	False

-Force

Telepíti a modult, és felülbírálja a modultelepítési ütközésekre vonatkozó figyelmeztető üzeneteket. Ha egy azonos nevű modul már létezik a számítógépen, a Force lehetővé teszi több verzió telepítését. Ha egy meglévő modul ugyanazzal a névvel és verzióval rendelkezik, a Force felülírja ezt a verziót. A Force és az AllowClobber együtt használható egy Install-Module parancsban.

Paramétertulajdonságok

Típus:	SwitchParameter
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. Hiba jelenik meg, ha egy közvetlenül az InputObjectnek megadott érték jelenik meg. A folyamat használatával adja át az objektumokat az InputObject paraméterrel.

Paramétertulajdonságok

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

Paraméterkészletek

InputObject

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

-MaximumVersion

Megadja a telepíteni kívánt modul maximális verzióját. A telepített verziónak a MaximumVersion-nál kisebbnek vagy egyenlőnek kell lennie. Ha több modult szeretne telepíteni, nem használhatja a MaximumVersion szolgáltatást. A MaximumVersion és a RequiredVersion nem használható ugyanabban Install-Module a parancsban.

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

-MinimumVersion

Megadja a telepíteni kívánt modul minimális verzióját. A telepített verziónak a MinimumVersion-nál nagyobbnak vagy egyenlőnek kell lennie. Ha a modul egy újabb verziója érhető el, az újabb verzió lesz telepítve. Ha több modult szeretne telepíteni, a MinimumVersion nem használható. A MinimumVersion és a RequiredVersion nem használható ugyanabban Install-Module a parancsban.

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

-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 modulnevek listájának lekérésére használható Find-Module .

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:	False
Folyamatból származó érték tulajdonságnév alapján:	True
Fennmaradó argumentumokból származó érték:	False

-PassThru

A PassThru paraméter Install-Module használatakor egy PSRepositoryItemInfo objektumot ad ki a modulhoz.

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

-Proxy

Proxykiszolgálót ad meg a kéréshez, ahelyett, hogy közvetlenül csatlakozik az interneterőforráshoz.

Paramétertulajdonságok

Típus:	Uri
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:	True
Fennmaradó argumentumokból származó érték:	False

-ProxyCredential

Olyan felhasználói fiókot ad meg, amely jogosult a Proxy paraméter által megadott proxykiszolgáló használatára.

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:	True
Fennmaradó argumentumokból származó érték:	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: .

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

-RequiredVersion

Megadja a telepíteni kívánt modul pontos verzióját. Ha nincs egyezés a megadott verzió adattárában, hibaüzenet jelenik meg. Ha több modult szeretne telepíteni, nem használhatja a RequiredVersion szolgáltatást. A RequiredVersion nem használható ugyanabban Install-Module a parancsban, mint a MinimumVersion vagy a MaximumVersion.

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

-Scope

Megadja 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 helyre 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 esetén a PowerShell 6-os vagy újabb verziói:
  • 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.

Paramétertulajdonságok

Típus:	String
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

-SkipPublisherCheck

Lehetővé teszi egy modul újabb verziójának telepítését, amely már létezik a számítógépen. Ha például egy meglévő modult egy megbízható közzétevő digitálisan aláír, de az új verziót nem egy megbízható közzétevő írja alá digitálisan.

Paramétertulajdonságok

Típus:	SwitchParameter
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

-WhatIf

Megjeleníti, mi történne egy Install-Module parancs futtatásakor. 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

PSRepositoryItemInfo

Find-Module PSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamatbaInstall-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ó, mint amit a Find-Module parancsmagból kap.

Jegyzetek

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

• Minden platform:
  • inmo

Install-Module PowerShell 5.0-s vagy újabb verziókon fut, Windows 7 vagy Windows 2008 R2 rendszeren, valamint a Windows újabb kiadásain.

Fontos

2020 áprilisától a PowerShell-katalógus 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-gyűjtemény elérésekor. A következő 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ó: közlemény a PowerShell blogjában.

Ajánlott biztonsági 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 Név 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 Név 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-Module PSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamatbaInstall-Module. A folyamat egy másik módja annak, hogy több modult adjon meg, amelyet egyetlen parancsba kell telepíteni.

Alapértelmezés szerint az AllUsers hatókörének moduljai telepítve vannak a következőben $env:ProgramFiles\PowerShell\Modules: . Az alapértelmezett beállítás megakadályozza a zavart a PowerShell Desired State Configuration (DSC) erőforrásainak telepítésekor.

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

Ha egy meglévő modul verziója megegyezik a Név paraméter által megadott névvel, és a MinimumVersion vagy a RequiredVersion paraméter nem használatos, csendben 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, csendben 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 megkövetelt függő modulokat is. A közzétevő felsorolja a szükséges modulokat és azok verzióit a moduljegyzékben.

Kapcsolódó hivatkozások

• Find-Module
• Get-PSRepository
• Import-Modul
• Publish-Module
• Register-PSRepository
• Uninstall-Module
• Update-Module
• about_Module