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

Cmdleten Install-Module hämtar en eller flera moduler som uppfyller angivna kriterier från en onlinelagringsplats. Cmdleten verifierar att sökresultaten är giltiga moduler och kopierar modulmapparna till installationsplatsen. Installerade moduler importeras inte automatiskt efter installationen. Du kan filtrera vilken modul som är installerad baserat på de lägsta, högsta och exakta versionerna av angivna moduler.

Det här är en proxy-cmdlet för cmdleten Get-InstalledPSResource i Microsoft.PowerShell.PSResourceGet. Mer information finns i Install-PSResource.

Det här exemplet hittar en modul på lagringsplatsen och installerar modulen.

Find-Module -Name PowerShellGet | Install-Module

Find-Module Använder parametern Namn för att ange PowerShellGet-modulen. Som standard laddas den senaste versionen av modulen ned från lagringsplatsen. Objektet skickas ned i pipelinen till cmdleten Install-Module. Install-Module installerar modulen för alla användare i $env:ProgramFiles\PowerShell\Modules.

I det här exemplet installeras den senaste versionen av PowerShellGet-modulen .

Install-Module -Name PowerShellGet

Install-Module Använder parametern Namn för att ange PowerShellGet-modulen. Som standard laddas den senaste versionen av modulen ned från lagringsplatsen och installeras.

I det här exemplet installeras den lägsta versionen av PowerShellGet-modulen . Parametern MinimumVersion anger den lägsta versionen av modulen som ska installeras. Om en nyare version av modulen är tillgänglig laddas den versionen ned och installeras för alla användare.

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

Install-Module Använder parametern Namn för att ange PowerShellGet-modulen. Parametern MinimumVersion anger att version 2.0.1 laddas ned från lagringsplatsen och installeras. Eftersom version 2.0.4 är tillgänglig laddas den versionen ned och installeras för alla användare.

I det här exemplet installeras en specifik version av PowerShellGet-modulen .

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

Install-Module Använder parametern Namn för att ange PowerShellGet-modulen. Parametern RequiredVersion anger att version 2.0.0 laddas ned och installeras för alla användare.

Det här exemplet laddar ned och installerar den senaste versionen av en modul, endast för den aktuella användaren.

Install-Module -Name PowerShellGet -Scope CurrentUser

Install-Module Använder parametern Namn för att ange PowerShellGet-modulen. Install-Module laddar ned och installerar den senaste versionen av PowerShellGet i den aktuella användarens katalog, $HOME\Documents\PowerShell\Modules.

Det här exemplet visar hur du installerar den senaste versionen av en modul när den versionen är en förhandsversion. För att installera en förhandsversion krävs parametern AllowPrerelease .

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

Med den här metoden får du den senaste tillgängliga versionen. Om den senaste versionen inte är en förhandsversion får du den senaste stabila versionen av modulen.

Det här exemplet visar hur du installerar en specifik förhandsversion av en modul. Cmdleten Find-Module kan användas för att hitta förhandsversioner av moduler i PowerShell-galleriet.

Förhandsversioner har formatet <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

Använd den version som visas i PowerShell-galleriet för värdet för parametern RequiredVersion .

Den här cmdleten stöder vanliga parametrar: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction och -WarningVariable. Mer information finns i about_CommonParameters.

Find-Module skapar PSRepositoryItemInfo-objekt som kan skickas ned i pipelinen till Install-Module.

När du använder parametern Install-Module matar ut ett PSRepositoryItemInfo-objekt för modulen. Det här är samma information som du får från cmdleten Find-Module .

PowerShell innehåller följande alias för Install-Module:

• Alla plattformar:
  • inmo

Install-Module körs på PowerShell 5.0 eller senare versioner, på Windows 7 eller Windows 2008 R2 och senare versioner av Windows.

Vi rekommenderar att du utvärderar en moduls kod innan du kör några cmdletar eller funktioner för första gången. För att förhindra att moduler som innehåller skadlig kod körs importeras inte installerade moduler automatiskt efter installationen.

Om modulnamnet som anges av parametern Namn inte finns på lagringsplatsen Install-Module returnerar ett fel.

Om du vill installera flera moduler använder du parametern Namn och anger en kommaavgränsad matris med modulnamn. Om du anger flera modulnamn kan du inte använda MinimumVersion, MaximumVersion eller RequiredVersion. Find-Module skapar PSRepositoryItemInfo-objekt som kan skickas ned i pipelinen till Install-Module. Pipelinen är ett annat sätt att ange flera moduler som ska installeras i ett enda kommando.

Som standard installeras moduler för omfånget för Allaanvändare i $env:ProgramFiles\PowerShell\Modules. Standardinställningen förhindrar förvirring när du installerar DSC-resurser (Desired State Configuration).

En modulinstallation misslyckas och kan inte importeras om den inte har ett .psm1, .psd1eller .dll samma namn i mappen. Använd force-parametern för att installera modulen.

Om en befintlig moduls version matchar namnet som anges av parametern Namn och parametern MinimumVersion eller RequiredVersion inte används Install-Module , fortsätter tyst men installerar inte modulen.

Om en befintlig moduls version är större än värdet för parametern MinimumVersion , eller lika med värdet för parametern RequiredVersion , Install-Module fortsätter tyst men installerar inte modulen.

Om den befintliga modulen inte matchar de värden som anges av parametrarna MinimumVersion eller RequiredVersion uppstår ett fel i Install-Module kommandot. Om till exempel versionen av den befintliga installerade modulen är lägre än värdet MinimumVersion eller inte är lika med värdet RequiredVersion .

Install-Module installerar även de beroende moduler som anges som krävs av modulutgivaren. Utgivaren visar de moduler som krävs och deras versioner i modulmanifestet.