Freigeben über


Save-PSResource

Speichert Ressourcen (Module und Skripts) aus einem registrierten Repository auf dem Computer.

Syntax

Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-PSResource
    [-Name] <String[]>
    [-Version <String>]
    [-Prerelease]
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]
Save-PSResource
    [-Repository <String[]>]
    [-Credential <PSCredential>]
    [-AsNupkg]
    [-IncludeXml]
    [-Path <String>]
    [-TemporaryPath <String>]
    [-TrustRepository]
    [-PassThru]
    [-InputObject] <PSResourceInfo[]>
    [-SkipDependencyCheck]
    [-AuthenticodeCheck]
    [-AcceptLicense]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Beschreibung

Dieses Cmdlet kombiniert die Funktionalität der cmdlets Save-Module und Save-Script cmdlets aus PowerShellGet- v2. Save-PSResource lädt eine Ressource aus einem registrierten Repository auf einen bestimmten Pfad auf dem lokalen Computer herunter. Standardmäßig wird die Ressource im entpackten oder installierten Format gespeichert. Die Skripts oder Module können vom gespeicherten Speicherort ausgeführt werden. Es gibt auch eine Option zum Herunterladen der Ressource im .nupkg Format.

Beispiele

Beispiel 1

Lädt das Az Modul aus dem Repository mit der höchsten Priorität herunter und speichert es am aktuellen Speicherort.

Save-PSResource -Name Az

Beispiel 2

Lädt das Az Modul aus dem PowerShell-Katalog herunter und speichert es an dem aktuellen Speicherort.

Save-PSResource -Name Az -Repository PSGallery

Beispiel 3

Lädt das Az Modul aus dem Repository mit der höchsten Priorität herunter und speichert es im .nupkg Format am aktuellen Speicherort.

Save-PSResource Az -AsNupkg

Beispiel 4

Lädt das Az Modul aus dem Repository mit der höchsten Priorität herunter und enthält die PowerShellGet- XML-Metadatendatei.

Save-PSResource Az -IncludeXML

Parameter

-AcceptLicense

Für Module, die eine Lizenz erfordern, akzeptiert der Lizenzvertrag während der Installation automatisch.

Dieser Parameter wurde in PSResourceGet 1.1.0-rc1 hinzugefügt.

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

-AsNupkg

Speichert die Ressource als .nupkg Datei.

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

-AuthenticodeCheck

Überprüft die signierten Dateien und Katalogdateien der Ressource unter Windows.

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

-Confirm

Fordert Sie vor dem Ausführen des Cmdlets zur Bestätigung auf.

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

-Credential

Optionale Anmeldeinformationen, die beim Zugriff auf ein Repository verwendet werden.

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

-IncludeXml

Enthält die PowerShellGet-Metadaten-XML, die verwendet wird, um zu überprüfen, ob PowerShellGet ein Modul installiert hat.

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

-InputObject

Wird für Pipelineeingaben verwendet.

Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliase:ParentResource
Position:0
Standardwert:None
Erforderlich:True
Pipelineeingabe akzeptieren:True
Platzhalterzeichen akzeptieren:False

-Name

Der Name einer oder mehrerer zu installierenden Ressourcen.

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

-PassThru

Wenn angegeben, gibt ein PSResourceInfo- -Objekt für die gespeicherte Ressource aus.

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

-Path

Gibt den Pfad zum Speichern der Ressource an. Wenn kein Pfad angegeben wird, wird die Ressource im aktuellen Verzeichnis gespeichert.

Typ:String
Position:Named
Standardwert:current directory
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-Prerelease

Wenn angegeben, enthält Vorabversionen in den zurückgegebenen Suchergebnissen.

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

-Quiet

Unterdrückt die Statusanzeigenausgabe.

Dieser Parameter wurde in PSResourceGet 1.1.0-rc1 hinzugefügt.

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

-Repository

Gibt einen oder mehrere Repositorynamen an, die durchsucht werden sollen. Wenn nicht angegeben, enthält die Suche alle registrierten Repositorys in der Prioritätsreihenfolge (zuerst) bis ein Repository gefunden wird, das das Paket enthält. Repositorys werden nach Priorität und dann nach Namen sortiert. Niedrigere Priorität Werte haben eine höhere Priorität.

Beim Suchen nach Ressourcen über mehrere Repositorys hinweg durchsuchen die PSResourceGet- Cmdlets die Repositorys mithilfe dieser Sortierreihenfolge. Save-PSResource speichert das erste übereinstimmende Paket aus der sortierten Liste der Repositorys.

Der Parameter unterstützt das * Wildcardzeichen. Wenn Sie mehrere Repositorys angeben, müssen alle Namen das Wildcardzeichen enthalten oder weglassen. Sie können keine Kombination aus Namen mit und ohne Wildcards angeben.

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

-SkipDependencyCheck

Überspringt die Überprüfung auf Ressourcenabhängigkeiten. Nur gefundene Ressourcen werden installiert. Es werden keine Ressourcen der gefundenen Ressource installiert.

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

-TemporaryPath

Gibt den Pfad an, der vor dem Speichern vorübergehend installiert werden soll. Wenn kein temporärer Pfad angegeben wird, wird die Ressource vorübergehend im temporären Ordner des aktuellen Benutzers installiert.

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

-TrustRepository

Unterdrücken Von Eingabeaufforderungen zum Vertrauenswürdigen Repository. Die Aufforderung zum Vertrauenswürdigen Repository tritt nur auf, wenn das Repository nicht als vertrauenswürdig konfiguriert ist.

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

-Version

Gibt die Version der zurückzugebenden Ressource an. Der Wert kann eine genaue Version oder ein Versionsbereich mit der NuGet-Versionsverwaltungssyntax sein.

Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.

PowerShellGet unterstützt alle mindestens inklusive Version in der NuGet-Versionsbereichsdokumentation aufgeführt. Die Verwendung von 1.0.0.0, da die Version die Versionen 1.0.0.0.0 und höher (minimaler inklusiver Bereich) nicht liefert. Stattdessen wird der Wert als erforderliche Version betrachtet. Verwenden Sie [1.0.0.0, ] als Versionsbereich, um nach einem minimal inklusiven Bereich zu suchen.

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

-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

String[]

String

SwitchParameter

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]

Ausgaben

Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo

Standardmäßig gibt das Cmdlet keine Objekte zurück. Wenn der PassThru Parameter verwendet wird, gibt das Cmdlet ein PSResourceInfo--Objekt für die gespeicherte Ressource aus.