Save-Package

Referenz

Modul:: PackageManagement

Speichert Pakete auf dem lokalen Computer, ohne sie zu installieren.

Syntax

Save-Package
    [-Name] <String[]>
    [-RequiredVersion <String>]
    [-MinimumVersion <String>]
    [-MaximumVersion <String>]
    [-Source <String[]>]
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ProviderName <String[]>]
    [<CommonParameters>]

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    -InputObject <SoftwareIdentity>
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-ConfigFile <String>]
    [-SkipValidate]
    [-Headers <String[]>]
    [-FilterOnTag <String[]>]
    [-Contains <String>]
    [-AllowPrereleaseVersions]
    [<CommonParameters>]

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

Save-Package
    [-Path <String>]
    [-LiteralPath <String>]
    [-Credential <PSCredential>]
    [-Proxy <Uri>]
    [-ProxyCredential <PSCredential>]
    [-AllVersions]
    [-Force]
    [-ForceBootstrap]
    [-WhatIf]
    [-Confirm]
    [-AllowPrereleaseVersions]
    [-PackageManagementProvider <String>]
    [-PublishLocation <String>]
    [-ScriptSourceLocation <String>]
    [-ScriptPublishLocation <String>]
    [-Type <String>]
    [-Filter <String>]
    [-Tag <String[]>]
    [-Includes <String[]>]
    [-DscResource <String[]>]
    [-RoleCapability <String[]>]
    [-Command <String[]>]
    [-AcceptLicense]
    [<CommonParameters>]

Beschreibung

Das Save-Package Cmdlet speichert Pakete auf dem lokalen Computer, installiert aber nicht die Pakete. Dieses Cmdlet speichert die neueste Version eines Pakets, es sei denn, Sie geben einen RequiredVerion an. Die Parameter Path und LiteralPath schließen sich gegenseitig aus und können demselben Befehl nicht hinzugefügt werden.

Beispiele

Beispiel 1: Speichern eines Pakets auf dem lokalen Computer

In diesem Beispiel wird die neueste Version des Pakets in einem Verzeichnis auf dem lokalen Computer gespeichert. Die Abhängigkeiten des Pakets werden mit dem Paket heruntergeladen.

PS> Save-Package -Name NuGet.Core -ProviderName NuGet -Path C:\LocalPkg

Name                    Version    Source    Summary
----                    -------    ------    -------
Microsoft.Web.Xdt       3.0.0      Nuget     Microsoft Xml Document Transformation (XDT) enables...
NuGet.Core              2.14.0     Nuget     NuGet.Core is the core framework assembly for NuGet...

Save-Package verwendet den Parameter Name , um das Paket anzugeben. Das Paket wird aus dem repository heruntergeladen, das durch den ProviderName-Parameter angegeben wird. Der Path-Parameter bestimmt, wo das Paket gespeichert wird.

Beispiel 2: Speichern einer bestimmten Paketversion

In diesem Beispiel wird die Paketversion angegeben und in einem Verzeichnis auf dem lokalen Computer gespeichert.

PS> Save-Package -Name NuGet.Core -RequiredVersion 2.9.0 -ProviderName NuGet -Path C:\LocalPkg

Name                    Version    Source    Summary
----                    -------    ------    -------
Microsoft.Web.Xdt       3.0.0      Nuget     Microsoft Xml Document Transformation (XDT) enables...
NuGet.Core              2.9.0      Nuget     NuGet.Core is the core framework assembly for NuGet...

Save-Package verwendet den Parameter Name , um das Paket anzugeben. RequiredVersion gibt eine bestimmte Paketversion an. Das Paket wird aus dem repository heruntergeladen, das durch den ProviderName-Parameter angegeben wird. Der Path-Parameter bestimmt, wo das Paket gespeichert wird.

Beispiel 3: Verwenden von Find-Package zum Speichern eines Pakets

Dieser Befehl verwendet Find-Package , um die neueste Version des Pakets zu suchen und das Objekt an Save-Package.

PS> Find-Package -Name NuGet.Core -ProviderName NuGet | Save-Package -Path C:\LocalPkg

Find-Package verwendet den Parameter Name , um das Paket anzugeben. Das Paket wird aus dem repository heruntergeladen, das durch den ProviderName-Parameter angegeben wird. Das Objekt wird in der Pipeline an Save-Package gesendet. Der Path-Parameter bestimmt, wo das Paket gespeichert wird.

Beispiel 4: Speichern und Installieren des Pakets

Die neueste Version des Pakets und dessen Abhängigkeiten werden heruntergeladen und auf dem lokalen Computer installiert.

PS> Save-Package -Name NuGet.Core -ProviderName NuGet -Path C:\LocalPkg
PS> Install-Package C:\LocalPkg\NuGet.Core.2.14.0.nupkg

Save-Package lädt die Paketdatei und deren Abhängigkeiten auf den lokalen Computer herunter. Install-Package installiert das Paket und die Abhängigkeiten aus dem angegebenen Verzeichnis.

Parameter

-AcceptLicense

Akzeptieren Sie den Lizenzvertrag während der Installation automatisch, wenn das Paket dies erfordert.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AllowPrereleaseVersions

Ermöglicht das Speichern von Paketen, die als Vorabversion gekennzeichnet sind.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-AllVersions

Gibt an, dass dieses Cmdlet alle verfügbaren Versionen des Pakets speichert.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Command

Gibt einen oder mehrere Befehle an, die im Paket enthalten sind.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ConfigFile

Gibt eine Konfigurationsdatei an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Confirm

Fordert Sie zur Bestätigung auf, bevor Sie das Cmdlet ausführen.

Typ:	SwitchParameter
Aliase:	cf
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Contains

Save-Package ruft Objekte ab, wenn ein Element in den Eigenschaftswerten des Objekts eine genaue Übereinstimmung für den angegebenen Wert ist.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Credential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Speichern eines Pakets von einem angegebenen Paketanbieter oder einer angegebenen Quelle verfügt.

Typ:	PSCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-DscResource

Gibt eine oder mehrere DSC-Ressourcen (Desired State Configuration) für das Paket an.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Filter

Gibt einen Filter für das Paket an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-FilterOnTag

Gibt das Tag an, das die Ergebnisse filtert. Ergebnisse, die das angegebene Tag nicht enthalten, werden ausgeschlossen.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Force

Erzwingt die Ausführung des Befehls, ohne eine Benutzerbestätigung zu verlangen.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ForceBootstrap

Gibt an, dass Save-PackagePackageManagement die automatische Installation des Paketanbieters für das angegebene Paket erzwingt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Headers

Gibt die Header für das Paket an.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Includes

Gibt die Ressourcen an, die das Paket enthält.

Typ:	String[]
Zulässige Werte:	DscResource, Cmdlet, Function, Workflow, RoleCapability
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-InputObject

Ein Software-ID-Objekt, das das Paket darstellt, das Sie speichern möchten. Software-IDs sind Teil der Ergebnisse des Find-Package Cmdlets.

Typ:	Microsoft.PackageManagement.Packaging.SoftwareIdentity
Position:	Named
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-LiteralPath

Gibt den Literalpfad an, in dem Sie das Paket speichern möchten. Sie können diesen Parameter und den Path-Parameter nicht demselben Befehl hinzufügen.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MaximumVersion

Gibt die maximale Version des Pakets an, das Sie speichern möchten.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-MinimumVersion

Gibt die Mindestversion des Pakets an, das Sie suchen möchten.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Name

Gibt einen oder mehrere Paketnamen an.

Typ:	String[]
Position:	0
Standardwert:	None
Erforderlich:	True
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-PackageManagementProvider

Gibt einen Paketverwaltungsanbieter an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Path

Gibt den Speicherort auf dem lokalen Computer an, an dem das Paket gespeichert werden soll.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProviderName

Gibt einen oder mehrere Anbieternamen an.

Typ:	String[]
Aliase:	Provider
Zulässige Werte:	Bootstrap, NuGet, PowerShellGet
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Proxy

Gibt einen Proxyserver für die Anforderung anstelle einer direkten Verbindung mit der Internetressource an.

Typ:	Uri
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ProxyCredential

Gibt ein Benutzerkonto an, das über die Berechtigung zum Verwenden des Proxyservers verfügt, der durch den Proxyparameter angegeben wird.

Typ:	PSCredential
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-PublishLocation

Gibt den Veröffentlichungsspeicherort an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RequiredVersion

Gibt die genaue Version des zu speichernden Pakets an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-RoleCapability

Gibt ein Array von Rollenfunktionen an.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ScriptPublishLocation

Gibt den Speicherort für die Skriptveröffentlichung an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-ScriptSourceLocation

Gibt den Speicherort der Skriptquelle an.

Typ:	String
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-SkipValidate

Wechseln, der die Überprüfung der Anmeldeinformationen eines Pakets überspringt.

Typ:	SwitchParameter
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Source

Gibt eine oder mehrere Paketquellen an.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	True
Platzhalterzeichen akzeptieren:	False

-Tag

Gibt ein Tag an, nach dem innerhalb der Paketmetadaten gesucht werden soll.

Typ:	String[]
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-Type

Gibt an, ob nach Paketen mit einem Modul, einem Skript oder einem anderen gesucht werden soll.

Typ:	String
Zulässige Werte:	Module, Script, All
Position:	Named
Standardwert:	None
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

-WhatIf

Zeigt, was passiert, wenn das Cmdlet ausgeführt wird. Das Cmdlet wird nicht ausgeführt.

Typ:	SwitchParameter
Aliase:	wi
Position:	Named
Standardwert:	False
Erforderlich:	False
Pipelineeingabe akzeptieren:	False
Platzhalterzeichen akzeptieren:	False

Eingaben

Microsoft.PackageManagement.Packaging.SoftwareIdentity

Sie können ein SoftwareIdentity-Objekt an dieses Cmdlet weiterleiten.

Ausgaben

None

Dieses Cmdlet gibt keine Ausgabe zurück.

Hinweise

Wichtig

Ab April 2020 unterstützt der PowerShell-Katalog die Tls-Versionen 1.0 und 1.1 nicht mehr. Wenn Sie TLS 1.2 oder höher nicht verwenden, wird beim Versuch, auf den PowerShell-Katalog zuzugreifen, eine Fehlermeldung angezeigt. Verwenden Sie den folgenden Befehl, um sicherzustellen, dass Sie TLS 1.2 verwenden:

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

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