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.

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

-AuthenticodeCheck

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

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

-Confirm

Hiermit werden Sie vor der Ausführung des Cmdlets zur Bestätigung aufgefordert.

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

-Credential

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

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

-IncludeXml

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

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

-InputObject

Wird für die Pipelineeingabe verwendet.

Type:Microsoft.PowerShell.PSResourceGet.UtilClasses.PSResourceInfo[]
Aliases:ParentResource
Position:0
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-Name

Der Name einer oder mehrerer zu installierenden Ressourcen.

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

-PassThru

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:current directory
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Prerelease

Wenn angegeben, schließt Vorabversionen in zurückgegebene Suchergebnisse ein.

Type:SwitchParameter
Aliases:IsPrerelease
Position:Named
Default value:False
Required:False
Accept pipeline input:True
Accept wildcard characters: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.

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

-SkipDependencyCheck

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

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

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters: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.