Save-Module
Speichert ein Modul und seine Abhängigkeiten vom lokalen Computer, installiert aber nicht das Modul.
Syntax
Save-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-Module
[-Name] <String[]>
[-MinimumVersion <String>]
[-MaximumVersion <String>]
[-RequiredVersion <String>]
[-Repository <String[]>]
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AllowPrerelease]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-Module
[-InputObject] <PSObject[]>
-LiteralPath <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-Module
[-InputObject] <PSObject[]>
[-Path] <String>
[-Proxy <Uri>]
[-ProxyCredential <PSCredential>]
[-Credential <PSCredential>]
[-Force]
[-AcceptLicense]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Das Save-Module
Cmdlet lädt ein Modul und alle Abhängigkeiten aus einem registrierten Repository herunter.
Save-Module
lädt die neueste Version eines Moduls herunter und speichert sie. Die Dateien werden auf einem angegebenen Pfad auf dem lokalen Computer gespeichert. Das Modul ist nicht installiert, aber der Inhalt ist für die Überprüfung durch einen Administrator verfügbar. Das gespeicherte Modul kann dann an den entsprechenden $env:PSModulePath
Speicherort des Offlinecomputers kopiert werden.
Dies ist ein Proxy-Cmdlet für das Save-PSResource
Cmdlet in microsoft.PowerShell.PSResourceGet. Weitere Informationen finden Sie unter Save-PSResource
Beispiele
Beispiel 1: Speichern eines Moduls
In diesem Beispiel werden ein Modul und seine Abhängigkeiten auf dem lokalen Computer gespeichert.
Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery
Get-ChildItem -Path C:\Test\Modules
Directory: C:\Test\Modules
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 7/1/2019 13:31 PackageManagement
d----- 7/1/2019 13:31 PowerShellGet
Save-Module
verwendet den Parameter "Name ", um das Modul "PowerShellGet" anzugeben. Der Parameter Path gibt an, wo das heruntergeladene Modul gespeichert werden soll. Der Parameter "Repository " gibt ein registriertes Repository , PSGallery, an. Nachdem der Download abgeschlossen ist, wird der Inhalt des Pfads angezeigt, Get-ChildItem
in dem die Dateien gespeichert sind.
Beispiel 2: Speichern einer bestimmten Version eines Moduls
In diesem Beispiel wird gezeigt, wie Sie einen Parameter wie MaximumVersion oder RequiredVersion verwenden, um eine Modulversion anzugeben.
Save-Module -Name PowerShellGet -Path C:\Test\Modules -Repository PSGallery -MaximumVersion 2.1.0
Get-ChildItem -Path C:\Test\Modules\PowerShellGet\
Directory: C:\Test\Modules\PowerShellGet
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 7/1/2019 13:40 2.1.0
Save-Module
verwendet den Parameter "Name ", um das Modul "PowerShellGet" anzugeben. Der Parameter Path gibt an, wo das heruntergeladene Modul gespeichert werden soll. Der Parameter "Repository " gibt ein registriertes Repository , PSGallery, an.
MaximumVersion gibt an, dass Version 2.1.0 heruntergeladen und gespeichert wird. Nachdem der Download abgeschlossen ist, wird der Inhalt des Pfads angezeigt, Get-ChildItem
in dem die Dateien gespeichert sind.
Beispiel 3: Suchen und Speichern einer bestimmten Version eines Moduls
In diesem Beispiel wird eine erforderliche Modulversion im Repository gefunden und auf dem lokalen Computer gespeichert.
Find-Module -Name PowerShellGet -Repository PSGallery -RequiredVersion 1.6.5 |
Save-Module -Path C:\Test\Modules
Get-ChildItem -Path C:\Test\Modules\PowerShellGet
Directory: C:\Test\Modules\PowerShellGet
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 7/1/2019 14:04 1.6.5
Find-Module
verwendet den Parameter "Name ", um das Modul "PowerShellGet" anzugeben. Der Parameter "Repository " gibt ein registriertes Repository , PSGallery, an.
RequiredVersion gibt Version 1.6.5 an.
Das Objekt wird in der Pipeline an Save-Module
gesendet. Der Parameter Path gibt an, wo das heruntergeladene Modul gespeichert werden soll. Nachdem der Download abgeschlossen ist, wird der Inhalt des Pfads angezeigt, Get-ChildItem
in dem die Dateien gespeichert sind.
Parameter
-AcceptLicense
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Save-PSResource
.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-AllowPrerelease
Ermöglicht das Speichern eines Moduls, das als Vorabrelease gekennzeichnet ist.
Das Proxy-Cmdlet ordnet diesen Parameter dem Parameter Prerelease von Save-PSResource
.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Confirm
Fordert Sie zur Bestätigung auf, bevor Sie die Save-Module
Datei ausführen.
Typ: | SwitchParameter |
Aliase: | cf |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-Credential
Gibt ein Benutzerkonto an, das über Berechtigungen zum Speichern eines Moduls verfügt.
Typ: | PSCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Force
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Save-PSResource
.
Typ: | SwitchParameter |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
-InputObject
Akzeptiert ein PSRepositoryItemInfo - Objekt. Geben Find-Module
Sie beispielsweise eine Variable aus, und verwenden Sie diese Variable als InputObject-Argument .
Typ: | PSObject[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-LiteralPath
Gibt einen Pfad zu einem oder mehreren Speicherorten an. Der Wert des LiteralPath-Parameters wird genau wie eingegeben verwendet. Es werden keine Zeichen als Wildcards interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie sie in einfache Anführungszeichen ein. PowerShell interpretiert keine Zeichen, die in einfache Anführungszeichen eingeschlossen sind, als Escapesequenzen.
Das Proxy-Cmdlet ordnet diesen Parameter dem Path-Parameter von Save-PSResource
.
Typ: | String |
Aliase: | PSPath |
Position: | Named |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-MaximumVersion
Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Save-PSResource
zu erstellen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-MinimumVersion
Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Save-PSResource
zu erstellen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Name
Gibt ein Array von Namen von Modulen an, die gespeichert werden sollen.
Typ: | String[] |
Position: | 0 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Path
Gibt den Speicherort auf dem lokalen Computer an, an dem ein gespeichertes Modul gespeichert werden soll. Akzeptiert Wildcardzeichen.
Typ: | String |
Position: | 1 |
Standardwert: | None |
Erforderlich: | True |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | True |
-Proxy
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Save-PSResource
.
Typ: | Uri |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-ProxyCredential
Das Proxy-Cmdlet ignoriert diesen Parameter, da er nicht unterstützt wird Save-PSResource
.
Typ: | PSCredential |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Repository
Gibt den Anzeigenamen eines Repositorys an, das durch Ausführen Register-PSRepository
registriert wurde. Dient Get-PSRepository
zum Anzeigen registrierter Repositorys.
Typ: | String[] |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-RequiredVersion
Das Proxy-Cmdlet verwendet den Wert dieses Parameters, um eine NuGet-Versionssuchzeichenfolge für die Verwendung mit dem Parameter "Version " Save-PSResource
zu erstellen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-WhatIf
Zeigt, was passieren würde, wenn Save-Module
läuft. Das Cmdlet wird nicht ausgeführt.
Typ: | SwitchParameter |
Aliase: | wi |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | False |
Platzhalterzeichen akzeptieren: | False |
Eingaben
String[]
PSObject[]
Ausgaben
Hinweise
Der PowerShell-Katalog unterstützt die Tls-Versionen 1.0 und 1.1 nicht mehr. Sie müssen TLS 1.2 oder höher verwenden. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:
[Net.ServicePointManager]::SecurityProtocol = [Net.ServicePointManager]::SecurityProtocol -bor [Net.SecurityProtocolType]::Tls12