Install-Module

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

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.

Om modulen som installeras har samma namn eller version, eller innehåller kommandon i en befintlig modul, visas varningsmeddelanden. När du har bekräftat att du vill installera modulen och åsidosätta varningarna använder du parametrarna -Force och -AllowClobber. Beroende på lagringsplatsens inställningar kan du behöva svara på en uppmaning om att modulinstallationen ska fortsätta.

I de här exemplen används PowerShell-galleriet som den enda registrerade lagringsplatsen. Get-PSRepository visar de registrerade lagringsplatserna. Om du har flera registrerade lagringsplatser använder du parametern -Repository för att ange lagringsplatsens namn.

Exempel

Exempel 1: Hitta och installera en modul

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

Find-Module -Name PowerShellGet | Install-Module

Find-Module använder parametern Name för att ange modulen PowerShellGet. 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.

Exempel 2: Installera en modul efter namn

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

Install-Module -Name PowerShellGet

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

Exempel 3: Installera en modul med dess lägsta version

I det här exemplet installeras den lägsta versionen av modulen PowerShellGet. 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 Name för att ange modulen PowerShellGet. 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.

Exempel 4: Installera en specifik version av en modul

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

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

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

Exempel 5: Installera endast en modul för den aktuella användaren

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 Name för att ange modulen PowerShellGet. Install-Module laddar ned och installerar den senaste versionen av PowerShellGet- till den aktuella användarens katalog $home\Documents\PowerShell\Modules.

Parametrar

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Indata

PSRepositoryItemInfo

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

String[]

PSObject[]

String

PSCredential

Uri

Utdata

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

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

Kommentarer

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 Name inte finns på lagringsplatsen returnerar Install-Module ett fel.

Om du vill installera flera moduler använder du parametern Name och anger en kommaavgränsad matris med modulnamn. Om du anger flera modulnamn kan du inte använda MinimumVersion, MaximumVersioneller 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 en .psm1, .psd1eller .dll med samma namn i mappen. Använd parametern Force för att installera modulen.

Om en befintlig moduls version matchar det namn som anges av parametern Name och parametern MinimumVersion eller RequiredVersion inte används, fortsätter Install-Module 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, fortsätter Install-Module 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 kommandot Install-Module. Om till exempel versionen av den befintliga installerade modulen är lägre än värdet MinimumVersion eller inte är lika med värdet RequiredVersion.

En modulinstallation installerar även beroende moduler som anges enligt vad som krävs av modulutgivaren. Utgivaren anger de moduler som krävs och deras versioner i modulmanifestet.

Relaterade länkar

• Find-Module
• Get-PSRepository
• Import-Module
• Publish-Module
• Register-PSRepository
• Uninstall-Module
• Update-Module
• about_Module