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
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-InstalledPSResource
Microsoft.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-Module
Né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-Module
Né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-Module
Né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-Module
Né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-Module
Né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-PSResource
ké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-PSResource
sztringet 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-PSResource
sztringet 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-PSResource
sztringet 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-PSResource
elő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-Module
PSRepositoryItemInfo objektumokat hoz létre, amelyek elküldhetők a folyamatba.Install-Module
String[]
PSObject[]
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-Module
PSRepositoryItemInfo 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\Modules
vannak 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
, .psd1
vagy .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.
Kapcsolódó hivatkozások
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: