Install-Module
Lädt mindestens ein Modul aus einem Repository herunter und installiert sie auf dem lokalen 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>]Beschreibung
Das Install-Module Cmdlet ruft ein oder mehrere Module ab, die die angegebenen Kriterien erfüllen, aus einem Onlinerepository. Das Cmdlet überprüft, ob die 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 installiert ist, basierend auf den minimalen, maximalen und genauen Versionen der angegebenen Module.
Wenn das zu installierende Modul denselben Namen oder dieselbe Version hat oder Befehle in einem vorhandenen Modul enthält, werden Warnmeldungen angezeigt. Nachdem Sie bestätigt haben, dass Sie das Modul installieren und die Warnungen überschreiben möchten, verwenden Sie die -Force Parameter und -AllowClobber . Abhängig von Ihren Repositoryeinstellungen müssen Sie möglicherweise eine Eingabeaufforderung beantworten, damit die Installation des Moduls fortgesetzt werden kann.
In diesen Beispielen wird das PowerShell-Katalog als einziges registriertes Repository verwendet. Get-PSRepository zeigt die registrierten Repositorys an. Wenn Sie über mehrere registrierte Repositorys verfügen, verwenden Sie den -Repository Parameter, um den Namen des Repositorys anzugeben.
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-ModuleDer 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 in der Pipeline an das Install-Module Cmdlet gesendet. Install-Module installiert das Modul für alle Benutzer in $env:ProgramFiles\PowerShell\Modules.
Beispiel 2: Installieren eines Moduls nach Name
In diesem Beispiel wird die neueste Version des PowerShellGet-Moduls installiert.
Install-Module -Name PowerShellGetDer 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 MinimumVersion-Parameter gibt die niedrigste Version des Moduls an, die installiert werden soll. Wenn eine neuere Version des Moduls verfügbar ist, wird diese Version heruntergeladen und für alle Benutzer installiert.
Install-Module -Name PowerShellGet -MinimumVersion 2.0.1Der Install-Module verwendet den Parameter Name , um das PowerShellGet-Modul anzugeben. Der MinimumVersion-Parameter 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 heruntergeladen und für alle Benutzer 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.0Der 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 heruntergeladen und nur für den aktuellen Benutzer installiert.
Install-Module -Name PowerShellGet -Scope CurrentUserDer Install-Module verwendet den Parameter Name , um das PowerShellGet-Modul anzugeben.
Install-Module lädt die neueste Version von PowerShellGet herunter und installiert sie in das Verzeichnis des aktuellen Benutzers, $home\Documents\PowerShell\Modules.
Parameter
-AcceptLicense
Für Module, die eine Lizenz erfordern, akzeptiert AcceptLicense die Lizenzvereinbarung automatisch während der Installation. Weitere Informationen finden Sie unter Module, für die die Lizenzakzeptanz erforderlich ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowClobber
Überschreibt Warnmeldungen zu Installationskonflikten zu vorhandenen Befehlen auf einem Computer.
Überschreibt vorhandene Befehle, die denselben Namen wie Befehle haben, die von einem Modul installiert werden.
AllowClobber und Force können zusammen in einem Install-Module Befehl verwendet werden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-AllowPrerelease
Ermöglicht die Installation eines Moduls, das als Vorabversion gekennzeichnet ist.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie das Install-Module Cmdlet ausführen.
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Credential
Gibt ein Benutzerkonto an, das über Berechtigungen zum Installieren eines Moduls für einen angegebenen Paketanbieter oder eine angegebene Quelle verfügt.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Force
Installiert ein Modul und überschreibt Warnmeldungen zu Modulinstallationskonflikten. Wenn bereits ein Modul mit demselben Namen auf dem Computer vorhanden ist, ermöglicht Force die Installation mehrerer Versionen. Wenn ein Modul mit demselben Namen und derselben Version vorhanden ist, überschreibt Force diese Version. Force und AllowClobber können zusammen in einem Install-Module Befehl verwendet werden.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-InputObject
Wird für die Pipelineeingabe verwendet.
| Type: | PSObject[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MaximumVersion
Gibt die maximal zu installierende Version eines einzelnen Moduls an. Die installierte Version muss kleiner oder gleich MaximumVersion sein. Wenn Sie mehrere Module installieren möchten, können Sie MaximumVersion nicht verwenden. MaximumVersion und RequiredVersion können nicht im gleichen Install-Module Befehl verwendet werden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-MinimumVersion
Gibt die Mindestversion eines einzelnen Moduls an, das installiert werden soll. Die installierte Version muss größer oder gleich MinimumVersion sein. Wenn eine neuere Version des Moduls verfügbar ist, wird die neuere Version installiert. Wenn Sie mehrere Module installieren möchten, können Sie MinimumVersion nicht verwenden.
MinimumVersion und RequiredVersion können nicht im gleichen Install-Module Befehl verwendet werden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Name
Gibt die genauen Namen der Module an, die aus dem Onlinekatalog installiert werden sollen. Eine durch Trennzeichen getrennte Liste von Modulnamen wird akzeptiert. Der Modulname muss mit dem Modulnamen im Repository übereinstimmen. Verwenden Sie Find-Module , um eine Liste mit Modulnamen abzurufen.
| Type: | String[] |
| Position: | 0 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-PassThru
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Proxy
Gibt einen Proxyserver für die Anforderung an, anstatt eine direkte Verbindung mit der Internetressource herzustellen.
| Type: | Uri |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-ProxyCredential
Gibt ein Benutzerkonto an, das über die Berechtigung zur Verwendung des Proxyservers verfügt, der durch den Proxy-Parameter angegeben wird.
| Type: | PSCredential |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Repository
Verwenden Sie den Repository-Parameter , um anzugeben, welches Repository zum Herunterladen und Installieren eines Moduls verwendet wird. Wird verwendet, wenn mehrere Repositorys registriert werden. Gibt den Namen eines registrierten Repositorys im Befehl an Install-Module . Verwenden Register-PSRepositorySie zum Registrieren eines Repositorys .
Verwenden Get-PSRepositorySie zum Anzeigen registrierter Repositorys .
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-RequiredVersion
Gibt die genaue Version eines einzelnen moduls an, das installiert werden soll. Wenn im Repository für die angegebene Version keine Übereinstimmung vorhanden ist, wird ein Fehler angezeigt. Wenn Sie mehrere Module installieren möchten, können Sie RequiredVersion nicht verwenden. RequiredVersion kann nicht im selben Install-Module Befehl wie MinimumVersion oder MaximumVersion verwendet werden.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
-Scope
Gibt den Bereich der Installation des Moduls an. Die zulässigen Werte für diesen Parameter sind AllUsers und CurrentUser.
Der AllUsers-Bereich installiert Module an einem Speicherort, auf den alle Benutzer des Computers zugreifen können:
$env:ProgramFiles\PowerShell\Modules
Der CurrentUser installiert Module an einem Speicherort, auf den nur der aktuelle Benutzer des Computers zugreifen kann. Beispiel:
$home\Documents\PowerShell\Modules
Wenn kein Bereich definiert ist, wird der Standardwert basierend auf der PowerShellGet-Version festgelegt.
- In PowerShellGet-Versionen 2.0.0 und höher ist der Standardwert CurrentUser, was für die Installation keine Erhöhung erfordert.
- In PowerShellGet 1.x-Versionen ist der Standardwert AllUsers, was für die Installation eine Erhöhung erfordert.
| Type: | String |
| Accepted values: | CurrentUser, AllUsers |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-SkipPublisherCheck
Ermöglicht die Installation einer neueren Version eines Moduls, das bereits auf Ihrem Computer vorhanden ist. Beispielsweise, wenn ein vorhandenes Modul von einem vertrauenswürdigen Herausgeber digital signiert wird, die neue Version jedoch nicht von einem vertrauenswürdigen Herausgeber digital signiert wird.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-WhatIf
Zeigt an, was passieren würde, wenn ein Install-Module Befehl ausgeführt würde. Das Cmdlet wird nicht ausgeführt.
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | False |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
Eingaben
PSRepositoryItemInfo
Find-Module erstellt PSRepositoryItemInfo-Objekte , die an die Pipeline Install-Modulegesendet werden können.
String[]
PSObject[]
Ausgaben
Microsoft.PowerShell.Commands.PSRepositoryItemInfo
Wenn Sie den PassThru-Parameter verwenden, Install-Module gibt ein PSRepositoryItemInfo-Objekt für das Modul aus. Dies sind dieselben Informationen, die Sie aus dem Find-Module Cmdlet erhalten.
Hinweise
Install-Module wird unter PowerShell 5.0 oder höher, unter Windows 7 oder Windows 2008 R2 und höheren Versionen von Windows ausgeführt.
Als bewährte Sicherheitsmethode 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 angegebene Modulname im Repository nicht vorhanden ist, Install-Module wird ein Fehler zurückgegeben.
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, MaximumVersion oder RequiredVersion nicht verwenden. Find-Module erstellt PSRepositoryItemInfo-Objekte , die an die Pipeline 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 von AllUsers in $env:ProgramFiles\PowerShell\Modulesinstalliert. Die Standardeinstellung verhindert Verwirrung beim Installieren von PowerShell Desired State Configuration (DSC)-Ressourcen.
Eine Modulinstallation schlägt fehl und kann nicht importiert werden, wenn sie nicht über einen .psm1, .psd1oder .dll denselben Namen im Ordner verfügt. Verwenden Sie den Force-Parameter , um das Modul zu installieren.
Wenn die Version eines vorhandenen Moduls mit dem im Parameter Name angegebenen Namen übereinstimmt und der Parameter MinimumVersion oder RequiredVersion nicht verwendet wird, wird das Modul automatisch fortgesetzt, Install-Module aber nicht installiert.
Wenn die Version eines vorhandenen Moduls größer als der Wert des MinimumVersion-Parameters oder gleich dem Wert des Parameters RequiredVersion ist, wird das Modul automatisch fortgesetzt, Install-Module aber nicht installiert.
Wenn das vorhandene Modul nicht mit den im Parameter MinimumVersion oder RequiredVersion angegebenen Werten übereinstimmt, tritt im Install-Module Befehl ein Fehler auf. Beispielsweise, wenn die Version des vorhandenen installierten Moduls niedriger als der MinimumVersion-Wert oder nicht gleich dem Wert RequiredVersion ist.
Bei einer Modulinstallation werden auch alle abhängigen Module installiert, die vom Modulherausgeber angegeben werden. Der Herausgeber gibt die erforderlichen Module und deren Versionen im Modulmanifest an.