Save-Module

Referenz

Modul:: PowerShellGet

Speichert ein Modul und seine Abhängigkeiten auf dem lokalen Computer, installiert das Modul jedoch nicht.

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 aktuelle 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 steht für die Überprüfung durch einen Administrator zur Verfügung. Das gespeicherte Modul kann dann an den entsprechenden $env:PSModulePath Speicherort des Offlinecomputers kopiert werden.

Get-PSRepository zeigt die registrierten Repositorys des lokalen Computers an. Sie können das Find-Module Cmdlet verwenden, um registrierte Repositorys zu durchsuchen.

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 " zum Angeben des Moduls, PowerShellGet. Der Parameter Path gibt an, wo das heruntergeladene Modul gespeichert werden soll. Der Repositoryparameter gibt ein registriertes Repository an, PSGallery. Nachdem der Download abgeschlossen ist, wird der Inhalt des Pfads angezeigt, Get-ChildItem in dem die Dateien gespeichert werden.

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 " zum Angeben des Moduls, PowerShellGet. Der Parameter Path gibt an, wo das heruntergeladene Modul gespeichert werden soll. Der Repositoryparameter gibt ein registriertes Repository an, PSGallery. 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 werden.

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 " zum Angeben des Moduls, PowerShellGet. Der Repositoryparameter gibt ein registriertes Repository an, PSGallery. RequiredVersion gibt Version 1.6.5 an.

Das Objekt wird an die Pipeline gesendet.Save-Module 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 werden.

Parameter

-AcceptLicense

Akzeptieren Sie automatisch die Lizenzvereinbarung, wenn das Paket sie benötigt.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-AllowPrerelease

Ermöglicht Ihnen das Speichern eines Moduls, das als Vorabrelease gekennzeichnet ist.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie die Ausführung des Save-ModuleVorgangs ausführen.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Credential

Gibt ein Benutzerkonto an, das über Rechte zum Speichern eines Moduls verfügt.

Type:	PSCredential
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Force

Erzwingt Save-Module die Ausführung, ohne die Bestätigung des Benutzers zu bitten.

Type:	SwitchParameter
Position:	Named
Default value:	None
Accept pipeline input:	False
Accept wildcard characters:	False

-InputObject

Akzeptiert ein PSRepositoryItemInfo-Objekt . Geben Find-Module Sie beispielsweise eine Variable aus, und verwenden Sie diese Variable als InputObject-Argument .

Type:	PSObject[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	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 Platzhalter interpretiert. Wenn der Pfad Escapezeichen enthält, schließen Sie sie in einzelne Anführungszeichen ein. PowerShell interpretiert keine Zeichen, die in einzelne Anführungszeichen eingeschlossen sind, als Escapesequenzen.

Type:	String
Aliases:	PSPath
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MaximumVersion

Gibt die maximale oder neueste Version des Moduls an, die gespeichert werden soll. Die Parameter "MaximumVersion " und "RequiredVersion " können nicht im gleichen Befehl verwendet werden.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-MinimumVersion

Gibt die Mindestversion eines einzelnen Moduls an, das gespeichert werden soll. Sie können diesen Parameter nicht hinzufügen, wenn Sie versuchen, mehrere Module zu installieren. Die Parameter MinimumVersion und RequiredVersion können nicht im gleichen Befehl verwendet werden.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Name

Gibt ein Array von Namen von Modulen an, die gespeichert werden sollen.

Type:	String[]
Position:	0
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-Path

Gibt den Speicherort auf dem lokalen Computer an, um ein gespeichertes Modul zu speichern. Akzeptiert Wildcardzeichen.

Type:	String
Position:	1
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	True

-Proxy

Gibt einen Proxyserver für die Anforderung an, anstatt direkt mit der Internetressource zu verbinden.

Type:	Uri
Position:	Named
Default value:	None
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
Accept pipeline input:	True
Accept wildcard characters:	False

-Repository

Gibt den Anzeigenamen eines Repositorys an, das durch Ausführen Register-PSRepositoryregistriert wurde. Verwenden Sie Get-PSRepository zum Anzeigen registrierter Repositorys.

Type:	String[]
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-RequiredVersion

Gibt die genaue Versionsnummer des Zu speichernden Moduls an.

Type:	String
Position:	Named
Default value:	None
Accept pipeline input:	True
Accept wildcard characters:	False

-WhatIf

Zeigt an, was geschehen würde, wenn die Save-Module Ausführung ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Hinweise

Wichtig

Ab April 2020 unterstützt der PowerShell-Katalog die TLS-Versionen (Transport Layer Security) 1.0 und 1.1 nicht mehr. Wenn Sie nicht TLS 1.2 oder höher verwenden, erhalten Sie beim Versuch des Zugriffs auf den PowerShell-Katalog eine Fehlermeldung. Mit dem folgenden Befehl können Sie sicherstellen, dass Sie TLS 1.2 verwenden:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12

Weitere Informationen finden Sie im PowerShell-Blog in der Ankündigung.