Install-Module

Referencia

Modul:: PowerShellGet

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

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Confirm

Megerősítést kér a Install-Module parancsmag futtatása előtt.

Típus:	SwitchParameter
Aliasok:	cf
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-Force

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Install-PSResource.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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.

Típus:	PSObject[]
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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ó: .

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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ó: .

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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 .

Típus:	String[]
Position:	0
Alapértelmezett érték:	None
Kötelező:	True
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-Proxy

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Install-PSResource.

Típus:	Uri
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	False

-ProxyCredential

A proxyparancsmag figyelmen kívül hagyja ezt a paramétert, mivel azt a program nem támogatja Install-PSResource.

Típus:	PSCredential
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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: .

Típus:	String[]
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	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ó: .

Típus:	String
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	True
Helyettesítő karakterek elfogadása:	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.

Típus:	String
Elfogadott értékek:	CurrentUser, AllUsers
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-SkipPublisherCheck

A proxyparancsmag ezt a paramétert AuthenticodeCheckre alakítja a hívás Install-PSResourceelőtt.

Típus:	SwitchParameter
Position:	Named
Alapértelmezett érték:	None
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

-WhatIf

Megjeleníti, mi történne egy Install-Module parancs futtatásakor. A parancsmag nem fut.

Típus:	SwitchParameter
Aliasok:	wi
Position:	Named
Alapértelmezett érték:	False
Kötelező:	False
Folyamatbemenet elfogadása:	False
Helyettesítő karakterek elfogadása:	False

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.

Megosztás a következőn keresztül:

Install-Module

Syntax

Description

Példák

1. példa: Modul keresése és telepítése

2. példa: Modul telepítése név szerint

3. példa: Modul telepítése a minimális verzióval

4. példa: Modul adott verziójának telepítése

5. példa: Csak az aktuális felhasználó moduljának telepítése

6. példa: A modul legújabb előzetes verziójának telepítése

7. példa: Modul adott előzetes verziójának telepítése

Paraméterek

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Bevitelek

Kimenetek

Jegyzetek

Kapcsolódó hivatkozások