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]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-PSResource
[-Name] <String[]>
[-Version <String>]
[-Prerelease]
[-Repository <String[]>]
[-Credential <PSCredential>]
[-AsNupkg]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Save-PSResource
[-Repository <String[]>]
[-Credential <PSCredential>]
[-AsNupkg]
[-IncludeXml]
[-Path <String>]
[-TemporaryPath <String>]
[-TrustRepository]
[-PassThru]
[-InputObject] <PSResourceInfo[]>
[-SkipDependencyCheck]
[-AuthenticodeCheck]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Beschreibung
Dieses Cmdlet kombiniert die Funktionalität der Save-Module
Cmdlets und Save-Script
von PowerShellGet v2.
Save-PSResource
lädt eine Ressource aus einem registrierten Repository in 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 am 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 von der PowerShell-Katalog herunter und speichert es am 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
-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
Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.
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 die Pipelineeingabe 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 an, in dem die Ressource gespeichert werden soll. 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, schließt Vorabversionen in zurückgegebene Suchergebnisse ein.
Typ: | SwitchParameter |
Aliase: | IsPrerelease |
Position: | Named |
Standardwert: | False |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | False |
-Repository
Gibt einen oder mehrere zu durchsuchende Repositorynamen an. Wenn nicht angegeben, umfasst die Suche alle registrierten Repositorys in der Prioritätsreihenfolge (höchste erste Reihenfolge), bis ein Repository gefunden wird, das das Paket enthält. Repositorys werden nach Priorität und dann nach Name sortiert. Niedrigere Prioritätswerte haben eine höhere Priorität.
Bei der Suche nach Ressourcen in mehreren Repositorys 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 *
Feldhalterzeichen. Wenn Sie mehrere Repositorys angeben, müssen alle Namen das Feldhalterzeichen enthalten oder weglassen. Sie können keine Kombination von 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. Es werden nur gefundene Ressourcen installiert. Es sind 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, in dem die Ressource 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 Aufforderungen zum Vertrauen des Repositorys. Die Aufforderung zum Vertrauen des Repositorys erfolgt nur, 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 Ressource an, die zurückgegeben werden soll. Der Wert kann eine exakte Version oder ein Versionsbereich mit der NuGet-Versionssyntax sein.
Weitere Informationen zu NuGet-Versionsbereichen finden Sie unter Paketversionsverwaltung.
PowerShellGet unterstützt alle Versionen bis auf die mindeste inklusive Version , die in der Dokumentation zum NuGet-Versionsbereich aufgeführt ist. Die Verwendung 1.0.0.0
als Version ergibt keine Versionen 1.0.0.0 und höher (mindestumfang). Stattdessen wird der Wert als die erforderliche Version betrachtet. Verwenden Sie [1.0.0.0, ]
als Versionsbereich, um nach einem inklusiven Mindestbereich zu suchen.
Typ: | String |
Position: | Named |
Standardwert: | None |
Erforderlich: | False |
Pipelineeingabe akzeptieren: | True |
Platzhalterzeichen akzeptieren: | True |
-WhatIf
Zeigt, was geschieht, 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.