Install-Module
Downloadt een of meer modules uit een opslagplaats en installeert deze op de lokale computer.
Syntax
NameParameterSet (Standaard)
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
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 niet automatisch geïmporteerd na installatie.
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 bevat in een bestaande module, worden waarschuwingsberichten weergegeven. Nadat u hebt bevestigd dat u de module wilt installeren en de waarschuwingen wilt overschrijven, gebruikt u de -Force parameter. 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 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\WindowsPowerShell\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 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.
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-Moduledownloadt en installeert de nieuwste versie van PowerShellGet in de map van de huidige gebruiker. $home\Documents\WindowsPowerShell\Modules
Parameters
-Confirm
U wordt gevraagd om bevestiging voordat u de cmdlet Install-Module uitvoert.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Cf |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-Force
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.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-InputObject
Wordt gebruikt voor pijplijninvoer.
Parametereigenschappen
| Type: | PSObject[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
InputObject
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | True |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-MaximumVersion
Hiermee geeft u de maximale versie van één module die moet worden geïnstalleerd. Als u meerdere modules wilt installeren, kunt u MaximumVersion niet gebruiken.
MaximumVersion en RequiredVersion kunnen niet in dezelfde Install-Module opdracht worden gebruikt.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-MinimumVersion
Hiermee geeft u de minimale versie van één module die moet worden geïnstalleerd. Als er een nieuwere versie van de module beschikbaar is, wordt de nieuwere versie geïnstalleerd. Als u meerdere modules wilt installeren, kunt u geen MinimumVersion gebruiken.
MinimumVersion en RequiredVersion kunnen niet in dezelfde Install-Module opdracht worden gebruikt.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Versie |
Parametersets
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Name
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.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | 0 |
| Verplicht: | True |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Repository
Gebruik de parameter Repository om op te geven welke repository wordt gebruikt om een module te downloaden en te installeren. Wordt gebruikt wanneer meerdere opslagplaatsen zijn 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.
Parametereigenschappen
| Type: | String[] |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-RequiredVersion
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.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
NameParameterSet
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | True |
| Waarde van resterende argumenten: | False |
-Scope
Hiermee geeft u het installatiebereik van de module. De acceptabele waarden voor deze parameter zijn AllUsers en CurrentUser.
Met het bereik AllUsers worden modules geïnstalleerd op een locatie die toegankelijk is voor alle gebruikers van de computer:
$env:ProgramFiles\WindowsPowerShell\Modules
De CurrentUser installeert modules op een locatie die alleen toegankelijk is voor de huidige gebruiker van de computer:
$home\Documents\WindowsPowerShell\Modules
Als er geen bereik is gedefinieerd, wordt de standaardinstelling ingesteld op basis van de huidige sessie:
- Voor een verhoogde PowerShell-sessie is Scope standaard ingesteld op AllUsers.
- Voor niet-verhoogde PowerShell-sessies in PowerShellGet versies 2.0.0 en hoger is het bereik CurrentUser.
- Voor niet-verhoogde PowerShell-sessies in PowerShellGet-versies 1.6.7 en eerder is Bereik niet gedefinieerd en
Install-Modulemislukt.
Parametereigenschappen
| Type: | String |
| Default value: | None |
| Geaccepteerde waarden: | AllUsers, CurrentUser |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
-WhatIf
Laat zien wat er zou gebeuren als een Install-Module opdracht werd uitgevoerd. De cmdlet wordt niet uitgevoerd.
Parametereigenschappen
| Type: | SwitchParameter |
| Default value: | False |
| Ondersteunt jokertekens: | False |
| DontShow: | False |
| Aliassen: | Wi |
Parametersets
(All)
| Position: | Named |
| Verplicht: | False |
| Waarde uit pijplijn: | False |
| Waarde uit pijplijn op eigenschapsnaam: | False |
| Waarde van resterende argumenten: | False |
CommonParameters
Deze cmdlet ondersteunt de algemene parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction en -WarningVariable. Zie about_CommonParametersvoor meer informatie.
Invoerwaarden
PSRepositoryItemInfo
Find-Module maakt PSRepositoryItemInfo-objecten die naar de pijplijn Install-Modulekunnen worden verzonden.
Notities
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 niet automatisch geïmporteerd na de installatie.
Als de modulenaam die is opgegeven door de parameter Name niet bestaat in de repository, Install-Module wordt er 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\WindowsPowerShell\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 de map geen , .psm1of .psd1 dezelfde naam bevat.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, wordt de module op de achtergrond voortgezet, Install-Module maar wordt de module niet geïnstalleerd.
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 wordt de module op de achtergrond voortgezet, maar wordt de module niet geïnstalleerd.
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 .