Install-Module
Hiermee downloadt u een of meer modules uit een opslagplaats en installeert u deze op de lokale computer.
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
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.
Als de module die wordt geïnstalleerd dezelfde naam of versie heeft of opdrachten in een bestaande module bevat, worden waarschuwingsberichten weergegeven. Nadat u hebt bevestigd dat u de module wilt installeren en de waarschuwingen wilt overschrijven, gebruikt u de -Force
en -AllowClobber
parameters. Afhankelijk van de instellingen van uw opslagplaats moet u mogelijk een prompt beantwoorden om door te gaan met de installatie van de module.
In deze voorbeelden wordt de PowerShell Gallery gebruikt als de enige geregistreerde opslagplaats. Get-PSRepository
geeft de geregistreerde opslagplaatsen weer. Als u meerdere geregistreerde opslagplaatsen hebt, gebruikt u de -Repository
parameter om de naam van de opslagplaats op te geven.
Voorbeelden
Voorbeeld 1: Een module zoeken en installeren
In dit voorbeeld wordt een module in de opslagplaats gevonden 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 Install-Module
cmdlet. Install-Module
installeert de module voor alle gebruikers in $env:ProgramFiles\PowerShell\Modules
.
Voorbeeld 2: Een module installeren op naam
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.
Voorbeeld 3: Een module installeren met de minimale versie
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 gedownload en geïnstalleerd voor alle gebruikers.
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.
Voorbeeld 4: Een specifieke versie van een module installeren
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.
Voorbeeld 5: Een module alleen installeren voor de huidige gebruiker
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-Module
downloadt en installeert de nieuwste versie van PowerShellGet in de map van de huidige gebruiker. $home\Documents\PowerShell\Modules
Parameters
Voor modules waarvoor een licentie is vereist, accepteert AcceptLicense automatisch de gebruiksrechtovereenkomst tijdens de installatie. Zie Modules waarvoor licentieacceptatie is vereist voor meer informatie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Overschrijft waarschuwingsberichten over installatieconflicten over bestaande opdrachten op een computer.
Overschrijft bestaande opdrachten met dezelfde naam als opdrachten die door een module worden geïnstalleerd.
AllowClobber en Force kunnen samen worden gebruikt in een Install-Module
opdracht.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hiermee kunt u een module installeren die is gemarkeerd als een voorlopige versie.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Vraagt u om bevestiging voordat u de Install-Module
cmdlet uitvoert.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hiermee geeft u een gebruikersaccount met rechten voor het installeren van een module voor een opgegeven pakketprovider of bron.
Type: | PSCredential |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Installeert een module en overschrijft waarschuwingsberichten over module-installatieconflicten. Als er al een module met dezelfde naam op de computer bestaat, kan Force meerdere versies installeren. Als er een bestaande module met dezelfde naam en versie is, overschrijft Force die versie. Force en AllowClobber kunnen samen worden gebruikt in een Install-Module
opdracht.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Wordt gebruikt voor pijplijninvoer. Er wordt een fout gegenereerd als er een waarde rechtstreeks aan InputObject wordt opgegeven. Gebruik de pijplijn om objecten door te geven met de parameter InputObject .
Type: | PSObject[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Hiermee geeft u de maximale versie van één module die moet worden geïnstalleerd. De geïnstalleerde versie moet kleiner zijn dan of gelijk zijn aan MaximumVersion. Als u meerdere modules wilt installeren, kunt u MaximumVersion niet gebruiken. MaximumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde Install-Module
opdracht.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Hiermee geeft u de minimale versie van één module die moet worden geïnstalleerd. De geïnstalleerde versie moet groter zijn dan of gelijk zijn aan MinimumVersion. Als er een nieuwere versie van de module beschikbaar is, wordt de nieuwere versie geïnstalleerd. Als u meerdere modules wilt installeren, kunt u MinimumVersion niet gebruiken.
MinimumVersion en RequiredVersion kunnen niet worden gebruikt in dezelfde Install-Module
opdracht.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Hiermee geeft u de exacte namen van modules die moeten worden geïnstalleerd vanuit de onlinegalerie. Er wordt een door komma's gescheiden lijst met modulenamen geaccepteerd. De modulenaam moet overeenkomen met de modulenaam in de opslagplaats. Hiermee Find-Module
haalt u een lijst met modulenamen op.
Type: | String[] |
Position: | 0 |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Type: | SwitchParameter |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hiermee geeft u een proxyserver voor de aanvraag, in plaats van rechtstreeks verbinding te maken met de internetresource.
Type: | Uri |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Hiermee geeft u een gebruikersaccount met machtigingen voor het gebruik van de proxyserver die is opgegeven door de proxyparameter .
Type: | PSCredential |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Gebruik de parameter Opslagplaats om op te geven welke opslagplaats wordt gebruikt om een module te downloaden en te installeren. Wordt gebruikt wanneer meerdere opslagplaatsen worden geregistreerd. Hiermee geeft u de naam van een geregistreerde opslagplaats in de Install-Module
opdracht. Als u een opslagplaats wilt registreren, gebruikt u Register-PSRepository
.
Als u geregistreerde opslagplaatsen wilt weergeven, gebruikt u Get-PSRepository
.
Type: | String[] |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hiermee geeft u de exacte versie van één module die moet worden geïnstalleerd. Als er geen overeenkomst is in de opslagplaats voor de opgegeven versie, wordt er een fout weergegeven. Als u meerdere modules wilt installeren, kunt u RequiredVersion niet gebruiken. RequiredVersion kan niet worden gebruikt in dezelfde Install-Module
opdracht als MinimumVersion of MaximumVersion.
Type: | String |
Position: | Named |
Default value: | None |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Hiermee geeft u het installatiebereik van de module. De acceptabele waarden voor deze parameter zijn AllUsers en CurrentUser.
Het bereik AllUsers installeert modules op een locatie die toegankelijk is voor alle gebruikers van de computer:
$env:ProgramFiles\PowerShell\Modules
CurrentUser installeert modules op een locatie die alleen toegankelijk is voor de huidige gebruiker van de computer. Bijvoorbeeld:
$home\Documents\PowerShell\Modules
Als er geen bereik is gedefinieerd, wordt de standaardwaarde ingesteld op basis van de PowerShellGet-versie.
- In PowerShellGet-versies 2.0.0 en hoger is de standaardinstelling CurrentUser, waarvoor geen uitbreiding van de installatie is vereist.
- In PowerShellGet 1.x-versies is de standaardinstelling AllUsers, waarvoor uitbreiding van de installatie is vereist.
Type: | String |
Accepted values: | CurrentUser, AllUsers |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Hiermee kunt u een nieuwere versie van een module installeren die al op uw computer bestaat. Als een bestaande module bijvoorbeeld digitaal wordt ondertekend door een vertrouwde uitgever, maar de nieuwe versie niet digitaal is ondertekend door een vertrouwde uitgever.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Laat zien wat er zou gebeuren als een Install-Module
opdracht werd uitgevoerd. De cmdlet wordt niet uitgevoerd.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Invoerwaarden
PSRepositoryItemInfo
Find-Module
maakt PSRepositoryItemInfo-objecten die naar de pijplijn Install-Module
kunnen worden verzonden.
String[]
PSObject[]
Uitvoerwaarden
Microsoft.PowerShell.Commands.PSRepositoryItemInfo
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.
Notities
Install-Module
wordt uitgevoerd in PowerShell 5.0 of hoger, in Windows 7 of Windows 2008 R2 en latere versies van Windows.
Belangrijk
Vanaf april 2020 biedt de PowerShell Gallery geen ondersteuning meer voor TLS-versies (Transport Layer Security) 1.0 en 1.1. Als u TLS 1.2 of hoger niet gebruikt, krijgt u een foutmelding wanneer u toegang probeert te krijgen tot de PowerShell Gallery. Gebruik de volgende opdracht om ervoor te zorgen dat u TLS 1.2 gebruikt:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
Zie de aankondiging in het PowerShell-blog voor meer informatie.
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 niet automatisch geïmporteerd na de installatie.
Als de modulenaam die is opgegeven door de parameter Name niet bestaat in de opslagplaats, Install-Module
retourneert u een fout.
Als u meerdere modules wilt installeren, gebruikt u de parameter Name 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-Module
kunnen worden verzonden. De pijplijn is een andere manier om meerdere modules op te geven die in één opdracht moeten worden geïnstalleerd.
Standaard worden modules voor het bereik van AllUsers 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 , .psd1
of .dll
dezelfde naam in de map heeft.psm1
. 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, gaat u op de achtergrond door, Install-Module
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 door, 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 MinimumVersion-waarde of niet gelijk is aan de waarde RequiredVersion .
Een module-installatie installeert ook afhankelijke modules die zijn opgegeven zoals vereist door de uitgever van de module. De uitgever geeft de vereiste modules en de bijbehorende versies op in het modulemanifest.
Verwante koppelingen
Feedback
Feedback verzenden en weergeven voor