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

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 a Microsoft.PowerShell.PSResourceGet parancsmag proxyparancsmagja. 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 a Name 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-Module telepíti a modult az $env:ProgramFiles\PowerShell\Modulesösszes felhasználója számára.

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 a Name 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 telepíteni kívánt modul legalacsonyabb verzióját adja meg. 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-Module a Name 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ójú az adattárból letölti és telepíti. Mivel a 2.0.4-es 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 a Name 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ójú minden felhasználó 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-Module a Name 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ói könyvtárba, $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-gyűjteményben.

Az előzetes verziók <version_number>-<prerelease_label>formátummal rendelkeznek.

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

A RequiredVersion paraméter értékéhez használja a PowerShell-gyűjteményben látható verziót.

Paraméterek

-AcceptLicense

Licenccel rendelkező modulok esetén AcceptLicense automatikusan elfogadja a licencszerződést a telepítés során. További információ: licencelfoglalást igénylő modulok.

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. AllowClobber és Force együtt használható egy Install-Module parancsban.

A proxyparancsmag átalakítja ennek a paraméternek az értékét a Install-PSResource parancsmag NoClobber paraméterévé.

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 proxyparancsmag leképozza ezt a paramétert a Prerelease paraméterre 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

-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 Install-PSResourcenem támogatja.

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 az InputObjectközvetlenül megadott érték. A folyamat használatával továbbíthat 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 Install-PSResourceVerzió paraméterével haszná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 Install-PSResourceVerzió paraméterével haszná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 Find-Module használatával lekérheti a modulnevek listáját.

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 használatakor Install-Module egy PSRepositoryItemInfo objektumot ad ki a modulhoz. Ez ugyanaz az információ, amelyet 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 Install-PSResourcenem támogatja.

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 Install-PSResourcenem támogatja.

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

-Repository

A Adattár paraméterrel adja meg 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 Register-PSRepository. A regisztrált adattárak megjelenítéséhez használja a 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 Install-PSResourceVerzió paraméterével haszná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 AllUsers és CurrentUser.

A 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 érték 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 CurrentUser, amely nem igényel jogosultságszint-emelést a telepítéshez.
    • Ha emelt szintű munkamenetben fut, az alapértelmezett 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 átalakítja ezt a paramétert AuthenticodeCheck-ra, mielőtt meghívná 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

-WhatIf

Megjeleníti, mi történne, ha egy Install-Module parancs futna. 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 létrehoz PSRepositoryItemInfo objektumokat, amelyek elküldhetők a folyamaton Install-Module.

String[]

PSObject[]

String

PSCredential

Uri

Kimenetek

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

A PassThru paraméter használatakor Install-Module 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:

  • Minden platform:
    • inmo

Install-Module a PowerShell 5.0-s vagy újabb kiadásain 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 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 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 MinimumVersion, MaximumVersionvagy RequiredVersion. Find-Module létrehoz PSRepositoryItemInfo objektumokat, amelyek elküldhetők a folyamaton Install-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 a allUsers hatókörének moduljai telepítve vannak a $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 .psm1, .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 RequiredVersion paraméter nem használatos, Install-Module csendben 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, Install-Module csendben folytatja, de nem telepíti a modult.

Ha a meglévő modul nem egyezik a MinimumVersion vagy 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éke, vagy nem egyenlő a RequiredVersion értékkel.

Install-Module a modul közzétevője által megkövetelt függő modulokat is telepíti. A közzétevő felsorolja a szükséges modulokat és azok verzióit a moduljegyzékben.