Install-Module

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

De Install-Module cmdlet haalt een of meer modules op die voldoen aan opgegeven criteria uit een onlineopslagplaats. De cmdlet controleert of zoekresultaten geldige modules zijn en kopieert de modulemappen naar de installatielocatie. Geïnstalleerde modules worden na de installatie niet automatisch geïmporteerd. U kunt filteren welke module is geïnstalleerd op basis van de minimale, maximale en exacte versies van opgegeven modules.

Dit is een proxy-cmdlet voor de Get-InstalledPSResource cmdlet in microsoft.PowerShell.PSResourceGet. Zie Install-PSResource voor meer informatie.

In dit voorbeeld wordt een module gevonden in de opslagplaats en wordt de module geïnstalleerd.

Find-Module -Name PowerShellGet | Install-Module

De Find-Module parameter Name wordt gebruikt om de PowerShellGet-module op te geven. Standaard wordt de nieuwste versie van de module gedownload uit de opslagplaats. Het object wordt naar de pijplijn verzonden naar de cmdlet Install-Module. Install-Module installeert de module voor alle gebruikers in $env:ProgramFiles\PowerShell\Modules.

In dit voorbeeld wordt de nieuwste versie van de PowerShellGet-module geïnstalleerd.

Install-Module -Name PowerShellGet

De Install-Module parameter Name wordt gebruikt om de PowerShellGet-module op te geven. Standaard wordt de nieuwste versie van de module gedownload uit de opslagplaats en geïnstalleerd.

In dit voorbeeld wordt de minimale versie van de PowerShellGet-module geïnstalleerd. De parameter MinimumVersion geeft de laagste versie van de module op die moet worden geïnstalleerd. Als er een nieuwere versie van de module beschikbaar is, wordt die versie voor alle gebruikers gedownload en geïnstalleerd.

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

De Install-Module parameter Name wordt gebruikt om de PowerShellGet-module op te geven. De parameter MinimumVersion geeft aan dat versie 2.0.1 wordt gedownload uit de opslagplaats en geïnstalleerd. Omdat versie 2.0.4 beschikbaar is, wordt die versie voor alle gebruikers gedownload en geïnstalleerd.

In dit voorbeeld wordt een specifieke versie van de PowerShellGet-module geïnstalleerd.

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

De Install-Module parameter Name wordt gebruikt om de PowerShellGet-module op te geven. De parameter RequiredVersion geeft aan dat versie 2.0.0 wordt gedownload en geïnstalleerd voor alle gebruikers.

In dit voorbeeld wordt de nieuwste versie van een module gedownload en geïnstalleerd, alleen voor de huidige gebruiker.

Install-Module -Name PowerShellGet -Scope CurrentUser

De Install-Module parameter Name wordt gebruikt om de PowerShellGet-module op te geven. Install-Moduledownloadt en installeert de nieuwste versie van PowerShellGet in de map van de huidige gebruiker. $HOME\Documents\PowerShell\Modules

In dit voorbeeld ziet u hoe u de nieuwste versie van een module installeert wanneer die versie een voorlopige versie is. Voor het installeren van een voorlopige versie is de parameter AllowPrerelease vereist.

Install-Module -Name Microsoft.PowerShell.Crescendo -AllowPrerelease

Met deze methode krijgt u de nieuwste versie die beschikbaar is. Als de nieuwste versie geen voorlopige versie is, krijgt u de nieuwste stabiele versie van de module.

In dit voorbeeld ziet u hoe u een specifieke voorlopige versie van een module installeert. De Find-Module cmdlet kan worden gebruikt om voorlopige versies van modules te vinden in de PowerShell Gallery.

Prerelease-versies hebben een indeling van <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

Gebruik de versie die wordt weergegeven in de PowerShell Gallery voor de waarde van de parameter RequiredVersion .

Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.

Find-Module maakt PSRepositoryItemInfo-objecten die naar de pijplijn Install-Modulekunnen worden verzonden.

Wanneer u de parameter PassThru gebruikt, Install-Module wordt een PSRepositoryItemInfo-object voor de module uitgevoerd. Dit is dezelfde informatie die u van de Find-Module cmdlet krijgt.

PowerShell bevat de volgende aliassen voor Install-Module:

• Alle platforms:
  • inmo

Install-Module wordt uitgevoerd op PowerShell 5.0 of hoger, in Windows 7 of Windows 2008 R2 en latere versies van Windows.

Als best practice voor beveiliging evalueert u de code van een module voordat u cmdlets of functies voor de eerste keer uitvoert. Om te voorkomen dat modules worden uitgevoerd die schadelijke code bevatten, worden geïnstalleerde modules na de installatie niet automatisch geïmporteerd.

Als de modulenaam die is opgegeven door de parameter Name niet in de opslagplaats bestaat, Install-Module wordt een fout geretourneerd.

Als u meerdere modules wilt installeren, gebruikt u de parameter Naam en geeft u een door komma's gescheiden matrix met modulenamen op. Als u meerdere modulenamen opgeeft, kunt u MinimumVersion, MaximumVersion of RequiredVersion niet gebruiken. Find-Module maakt PSRepositoryItemInfo-objecten die naar de pijplijn Install-Modulekunnen worden verzonden. De pijplijn is een andere manier om meerdere modules op te geven die in één opdracht moeten worden geïnstalleerd.

Modules voor het bereik van AllUsers worden standaard geïnstalleerd in $env:ProgramFiles\PowerShell\Modules. De standaardinstelling voorkomt verwarring wanneer u DSC-resources (PowerShell Desired State Configuration) installeert.

De installatie van een module mislukt en kan niet worden geïmporteerd als deze geen , .psm1of .psd1 dezelfde naam in de map heeft.dll. Gebruik de parameter Force om de module te installeren.

Als de versie van een bestaande module overeenkomt met de naam die is opgegeven door de parameter Name en de parameter MinimumVersion of RequiredVersion niet wordt gebruikt, Install-Module gaat u op de achtergrond verder, maar installeert u de module niet.

Als de versie van een bestaande module groter is dan de waarde van de parameter MinimumVersion of gelijk is aan de waarde van de parameter RequiredVersion , Install-Module gaat u op de achtergrond verder, maar installeert u de module niet.

Als de bestaande module niet overeenkomt met de waarden die zijn opgegeven door de parameters MinimumVersion of RequiredVersion , treedt er een fout op in de Install-Module opdracht. Als de versie van de bestaande geïnstalleerde module bijvoorbeeld lager is dan de minimumversiewaarde of niet gelijk is aan de waarde RequiredVersion .

Install-Module installeert ook afhankelijke modules die zijn opgegeven zoals vereist door de uitgever van de module. De uitgever vermeldt de vereiste modules en de bijbehorende versies in het modulemanifest.