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[]
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.