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 <version>]
[-MaximumVersion <version>]
[-RequiredVersion <version>]
[-Repository <string[]>]
[-Scope <string>]
[-Force]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
InputObject
Install-Module
[-InputObject] <psobject[]>
[-Scope <string>]
[-Force]
[-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ülbírálja a figyelmeztetéseket, használja a paramétert -Force . 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\WindowsPowerShell\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\WindowsPowerShell\Modules
Paraméterek
-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 |
-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.
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.
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. 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. 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 |
| Aliasok: | verzió |
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 |
-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\WindowsPowerShell\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:
$home\Documents\WindowsPowerShell\Modules
Ha nincs megadva hatókör , az alapértelmezett beállítás az aktuális munkamenet alapján történik:
- Emelt szintű PowerShell-munkamenet esetén a hatókör alapértelmezés szerint AllUsers.
- A PowerShellGet 2.0.0-s és újabb verzióiban a nem emelt szintű PowerShell-munkamenetek esetében a hatókör a CurrentUser.
- A PowerShellGet 1.6.7-s és korábbi verzióiban nem emelt szintű PowerShell-munkamenetek esetén a hatókör nincs meghatározva, és
Install-Modulesikertelen.
Paramétertulajdonságok
| Típus: | String |
| Alapértelmezett érték: | None |
| Elfogadott értékek: | AllUsers, CurrentUser |
| 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.
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.
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\WindowsPowerShell\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.