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

Beschreibung

Das Cmdlet Install-Module ruft ein oder mehrere Module ab, die bestimmte Kriterien aus einem Onlinerepository erfüllen. Das Cmdlet überprüft, ob Suchergebnisse gültige Module sind, und kopiert die Modulordner an den Installationsspeicherort. Installierte Module werden nach der Installation nicht automatisch importiert. Sie können filtern, welches Modul basierend auf den minimalen, maximalen und exakten Versionen der angegebenen Module installiert ist.

Dies ist ein Proxy-Cmdlet für das Cmdlet Get-InstalledPSResource im Microsoft.PowerShell.PSResourceGet-. Weitere Informationen finden Sie unter Install-PSResource.

Beispiele

Beispiel 1: Suchen und Installieren eines Moduls

In diesem Beispiel wird ein Modul im Repository gefunden und das Modul installiert.

Find-Module -Name PowerShellGet | Install-Module

Die Find-Module verwendet den Parameter Name, um das PowerShellGet Modul anzugeben. Standardmäßig wird die neueste Version des Moduls aus dem Repository heruntergeladen. Das Objekt wird an das Cmdlet Install-Module weitergeleitet. Install-Module installiert das Modul für alle Benutzer in $env:ProgramFiles\PowerShell\Modules.

Beispiel 2: Installieren eines Moduls anhand des Namens

In diesem Beispiel wird die neueste Version des PowerShellGet Moduls installiert.

Install-Module -Name PowerShellGet

Die Install-Module verwendet den Parameter Name, um das PowerShellGet Modul anzugeben. Standardmäßig wird die neueste Version des Moduls aus dem Repository heruntergeladen und installiert.

Beispiel 3: Installieren eines Moduls mit seiner Mindestversion

In diesem Beispiel wird die Mindestversion des PowerShellGet Moduls installiert. Der parameter MinimumVersion gibt die niedrigste Version des Moduls an, das installiert werden soll. Wenn eine neuere Version des Moduls verfügbar ist, wird diese Version für alle Benutzer heruntergeladen und installiert.

Install-Module -Name PowerShellGet -MinimumVersion 2.0.1

Die Install-Module verwendet den Parameter Name, um das PowerShellGet Modul anzugeben. Der parameter MinimumVersion gibt an, dass version 2.0.1 aus dem Repository heruntergeladen und installiert wird. Da version 2.0.4 verfügbar ist, wird diese Version für alle Benutzer heruntergeladen und installiert.

Beispiel 4: Installieren einer bestimmten Version eines Moduls

In diesem Beispiel wird eine bestimmte Version des PowerShellGet- Moduls installiert.

Install-Module -Name PowerShellGet -RequiredVersion 2.0.0

Die Install-Module verwendet den Parameter Name, um das PowerShellGet Modul anzugeben. Der parameter RequiredVersion gibt an, dass version 2.0.0 für alle Benutzer heruntergeladen und installiert wird.

Beispiel 5: Installieren eines Moduls nur für den aktuellen Benutzer

In diesem Beispiel wird die neueste Version eines Moduls nur für den aktuellen Benutzer heruntergeladen und installiert.

Install-Module -Name PowerShellGet -Scope CurrentUser

Die Install-Module verwendet den Parameter Name, um das PowerShellGet Modul anzugeben. Install-Module lädt die neueste Version von PowerShellGet in das Verzeichnis des aktuellen Benutzers $HOME\Documents\PowerShell\Modulesherunter und installiert sie.

Beispiel 6: Installieren der neuesten Vorabversion eines Moduls

In diesem Beispiel wird gezeigt, wie Sie die neueste Version eines Moduls installieren, wenn diese Version eine Vorabversion ist. Für die Installation einer Vorabversion ist der parameter AllowPrerelease erforderlich.

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

Mit dieser Methode erhalten Sie die neueste verfügbare Version. Wenn die neueste Version keine Vorabversion ist, erhalten Sie die neueste stabile Version des Moduls.

Beispiel 7: Installieren einer bestimmten Vorabversion eines Moduls

In diesem Beispiel wird gezeigt, wie Sie eine bestimmte Vorabversion eines Moduls installieren. Das cmdlet Find-Module kann verwendet werden, um Vorabversionen von Modulen im PowerShell-Katalog zu finden.

Vorabversionen weisen ein Format von <version_number>-<prerelease_label>auf.

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

Verwenden Sie die im PowerShell-Katalog angezeigte Version für den Wert des parameters RequiredVersion.

Parameter

-AcceptLicense

-AllowClobber

-AllowPrerelease

-Confirm

-Credential

-Force

-InputObject

-MaximumVersion

-MinimumVersion

-Name

-PassThru

-Proxy

-ProxyCredential

-Repository

-RequiredVersion

-Scope

-SkipPublisherCheck

-WhatIf

Eingaben

PSRepositoryItemInfo

Find-Module erstellt PSRepositoryItemInfo Objekte, die an Install-Modulegesendet werden können.

String[]

PSObject[]

String

PSCredential

Uri

Ausgaben

Microsoft.PowerShell.Commands.PSRepositoryItemInfo

Bei Verwendung des PassThru--Parameters gibt Install-Module ein PSRepositoryItemInfo-Objekt für das Modul aus. Dies sind die gleichen Informationen, die Sie aus dem Cmdlet Find-Module abrufen.

Hinweise

PowerShell enthält die folgenden Aliase für Install-Module:

• Alle Plattformen:
  • inmo

Install-Module unter PowerShell 5.0 oder höher, unter Windows 7 oder Windows 2008 R2 und höheren Versionen von Windows ausgeführt wird.

Als bewährte Methode für die Sicherheit sollten Sie den Code eines Moduls auswerten, bevor Sie cmdlets oder Funktionen zum ersten Mal ausführen. Um die Ausführung von Modulen zu verhindern, die schädlichen Code enthalten, werden installierte Module nach der Installation nicht automatisch importiert.

Wenn der durch den parameter Name Parameter angegebene Modulname im Repository nicht vorhanden ist, gibt Install-Module einen Fehler zurück.

Verwenden Sie zum Installieren mehrerer Module den parameter Name und geben Sie ein durch Trennzeichen getrenntes Array von Modulnamen an. Wenn Sie mehrere Modulnamen angeben, können Sie MinimumVersion, MaximumVersionoder RequiredVersionnicht verwenden. Find-Module erstellt PSRepositoryItemInfo Objekte, die an Install-Modulegesendet werden können. Die Pipeline ist eine weitere Möglichkeit, mehrere Module anzugeben, die in einem einzigen Befehl installiert werden sollen.

Standardmäßig werden Module für den Bereich AllUsers in $env:ProgramFiles\PowerShell\Modulesinstalliert. Die Standardeinstellung verhindert Verwirrung, wenn Sie PowerShell Desired State Configuration (DSC)-Ressourcen installieren.

Eine Modulinstallation schlägt fehl und kann nicht importiert werden, wenn keine .psm1, .psd1oder .dll desselben Namens innerhalb des Ordners vorhanden ist. Verwenden Sie den parameter Force, um das Modul zu installieren.

Wenn die Version eines vorhandenen Moduls mit dem namen übereinstimmt, der durch den Parameter Name angegeben wird, und die MinimumVersion oder RequiredVersion Parameter nicht verwendet werden, wird Install-Module im Hintergrund fortgesetzt, das Modul wird jedoch nicht installiert.

Wenn die Version eines vorhandenen Moduls größer als der Wert des MinimumVersion-Parameters oder gleich dem Wert des RequiredVersion-Parameters ist, wird Install-Module im Hintergrund fortgesetzt, das Modul wird jedoch nicht installiert.

Wenn das vorhandene Modul nicht mit den werten übereinstimmt, die durch die parameter MinimumVersion oder RequiredVersion angegeben werden, tritt im Befehl Install-Module ein Fehler auf. Wenn die Version des vorhandenen installierten Moduls z. B. niedriger als der wert MinimumVersion oder nicht gleich dem wert RequiredVersion ist.

Install-Module installiert auch alle abhängigen Module, die vom Modulherausgeber benötigt werden. Der Herausgeber listet die erforderlichen Module und deren Versionen im Modulmanifest auf.

Ähnliche Themen

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