Install-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.
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 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.
A proxyparancsmag ennek a paraméternek az értékét a parancsmag NoClobber paraméterévé Install-PSResource alakítja.
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.
A proxy parancsmag ezt a paramétert a prerelease paraméterreInstall-PSResourceképezi le.
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
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Install-PSResource.
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
A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelInstall-PSResourcehasználható: .
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
A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelInstall-PSResourcehasználható: .
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. Ez ugyanaz az információ, mint amit a Find-Module parancsmagból kap.
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
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Install-PSResource.
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
A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Install-PSResource.
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
A proxyparancsmag ennek a paraméternek az értékével hoz létre egy NuGet-verziókeresési sztringet, amely a következő verzióparaméterrelInstall-PSResourcehasználható: .
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
A proxyparancsmag ezt a paramétert AuthenticodeCheckre alakítja a hívás Install-PSResourceelőtt.
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.
