Freigeben über


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-ModuleDatei 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-PSResourcezu 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-PSResourcezu 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-PSRepositoryregistriert 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-PSResourcezu 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[]

String

Uri

PSCredential

Ausgaben

Object

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