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 importálása a telepítés után nem történik meg automatikusan.
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.
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
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-t.
A MaximumVersion és a RequiredVersion nem használható ugyanabban a Install-Module 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, nem használhatja a MinimumVersion-t.
A MinimumVersion és a RequiredVersion nem használható ugyanabban a Install-Module 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 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 importálása a telepítés után nem történik meg automatikusan.
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.
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.
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 proxyparamé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
A Repository paraméterrel adhatja meg, hogy melyik adattárat használja a rendszer a modulok letöltéséhez és telepítéséhez. 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 függvényt.
A RequiredVersion nem használható ugyanabban a parancsban, mint a Install-ModuleMinimumVersion 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 a modulokat a számítógép minden felhasználója számára elérhető helyre telepíti:
$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 2.0.0-s és újabb verzióiban az alapértelmezett currentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.
- A PowerShellGet 1.x verzióiban az alapértelmezett allUsers, amely a telepítéshez jogosultságszint-emelést igényel.
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áírt, de az új verziót nem írta alá digitálisan egy megbízható közzétevő.
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 parancsmag nem fut.
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
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 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 rosszindulatú kódot tartalmazó modulok futtatásának megakadályozása érdekében a telepített modulok importálása nem történik meg automatikusan a telepítés után.
Ha a Name paraméter által megadott modulnév nem létezik az adattárban, hibaüzenetet Install-Module 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 értéket.
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 meghiúsul, és nem importálható, ha a mappában nincs , .psm1.psd1, vagy .dll azonos név. 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 nincs használatban, a Install-Module modul csendesen folytatódik, 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, a rendszer csendben folytatja, Install-Module de nem telepíti a modult.
Ha a meglévő modul nem egyezik meg 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.
A modul telepítése a modul közzétevője által megkövetelt függő modulokat is telepíti. A közzétevő a moduljegyzékben adja meg a szükséges modulokat és azok verzióit.