Freigeben über

Install-PSResource

  • Referenz
Modul:
Microsoft.PowerShell.PSResourceGet

Installiert Ressourcen aus einem registrierten Repository.

Syntax

Install-PSResource
       [-Name] <String[]>
       [-Version <String>]
       [-Prerelease]
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Repository <String[]>]
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       [-InputObject] <PSResourceInfo[]>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResourceFile <String>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]
Install-PSResource
       [-Credential <PSCredential>]
       [-Scope <ScopeType>]
       [-TemporaryPath <String>]
       [-TrustRepository]
       [-Reinstall]
       [-Quiet]
       [-AcceptLicense]
       [-NoClobber]
       [-SkipDependencyCheck]
       [-AuthenticodeCheck]
       [-PassThru]
       -RequiredResource <Object>
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Beschreibung

Dieses Cmdlet installiert Ressourcen aus einem registrierten Repository in einem Installationspfad auf einem Computer. Standardmäßig gibt das Cmdlet kein Objekt zurück. Mit anderen Parametern können Sie das Repository, den Bereich und die Version für eine Ressource angeben und Lizenzaufforderungen unterdrücken.

Dieses Cmdlet kombiniert die Funktionen der Install-Module Und Install-Script Cmdlets aus PowerShellGet v2.

Install-PSResource lädt das neu installierte Modul nicht in die aktuelle Sitzung. Sie müssen die neue Version importieren oder eine neue Sitzung starten, um das aktualisierte Modul zu verwenden. Weitere Informationen finden Sie unter Import-Module.

Beispiele

Beispiel 1

Installiert die neueste stabile Version (nicht vorabversion) des Az-Moduls .

Install-PSResource Az

Beispiel 2

Installiert das neueste stabile Az-Modul innerhalb der Versionen 7.3.0 und 8.3.0.

Install-PSResource Az -Version '[7.3.0, 8.3.0]'

Beispiel 3

Installiert die neueste stabile Version des Az-Moduls . Wenn der Parameter "Neu installieren" verwendet wird, schreibt das Cmdlet über jede zuvor installierte Version.

Install-PSResource Az -Reinstall

Beispiel 4

Installiert die in der psd1-Datei angegebenen PSResources.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Beispiel 5

Installiert die in der Hashtable angegebenen PSResources.

Install-PSResource -RequiredResource  @{
    TestModule = @{
        version = '[0.0.1,1.3.0]'
        repository = 'PSGallery'
      }
    TestModulePrerelease = @{
        version = '[0.0.0,0.0.5]'
        repository = 'PSGallery'
        prerelease = 'true'
    }
    TestModule99 = @{}
}

Parameter

-AcceptLicense

Gibt an, dass die Ressource jede Anforderung zur Annahme des Lizenzvertrags akzeptieren soll. Dadurch wird die Aufforderung unterdrückt, wenn das Modul den Lizenzvertrag akzeptiert.

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

-AuthenticodeCheck

Überprüft Authenticode-Signaturen und Katalogdateien 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

-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

-NoClobber

Verhindert die Installation eines Pakets, das Cmdlets enthält, die bereits auf dem Computer vorhanden sind.

Typ:SwitchParameter
Position:Named
Standardwert:False
Erforderlich:False
Pipelineeingabe akzeptieren:False
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

-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 Statusanzeige für die Installation.

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

-Reinstall

Installiert die neueste Version eines Moduls, auch wenn die neueste Version bereits installiert ist. Die installierte Version wird überschrieben. Auf diese Weise können Sie eine beschädigte Installation des Moduls reparieren.

Wenn eine ältere Version des Moduls installiert ist, wird die neue Version nebeneinander in einem neuen versionsspezifischen Ordner installiert.

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ätswerte haben eine höhere Priorität.

Beim Suchen nach Ressourcen in mehreren Repositorys durchsuchen die PSResourceGet-Cmdlets die Repositorys mithilfe dieser Sortierreihenfolge. Install-PSResource installiert 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

-RequiredResource

Eine Hashtable- oder JSON-Zeichenfolge, die Ressourcen angibt, die installiert werden sollen. Wildcardzeichen sind nicht zulässig. Eine Beschreibung der Dateiformate finden Sie im Abschnitt "NOTES ".

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

-RequiredResourceFile

Pfad zu einer .psd1 oder .json der Ressourcen angibt, die installiert werden sollen. Wildcardzeichen sind nicht zulässig. Eine Beschreibung der Dateiformate finden Sie im Abschnitt "NOTES ".

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

-Scope

Gibt den Installationsbereich an. Dies sind die zulässigen Werte:

  • CurrentUser
  • AllUsers

Der Standardbereich ist CurrentUser, was keine Erhöhung für die Installation erfordert.

Der AllUsers Bereich installiert Module an einem Speicherort, auf den alle Benutzer des Computers zugreifen können. Zum Beispiel:

  • $env:ProgramFiles\PowerShell\Modules

Die CurrentUser Module werden an einem Speicherort installiert, auf den nur der aktuelle Benutzer des Computers zugreifen kann. Zum Beispiel:

  • $home\Documents\PowerShell\Modules
Typ:Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Zulässige Werte:CurrentUser, AllUsers
Position:Named
Standardwert:None
Erforderlich:False
Pipelineeingabe akzeptieren:False
Platzhalterzeichen akzeptieren:False

-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, mit dem die Ressource vorübergehend vor der tatsächlichen Installation 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, aber die mindestens inklusive Version, die in der NuGet-Versionsbereichsdokumentation aufgeführt ist. Die Verwendung 1.0.0.0 als Version führt nicht zu Versionen 1.0.0.0 und höher (minimaler inklusiver Bereich). Stattdessen wird der Wert als erforderliche Version betrachtet. Verwenden Sie zum Suchen nach einem minimalen inklusiven Bereich [1.0.0.0, ] als Versionsbereich.

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

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.

Hinweise

Das Modul definiert isres als Alias für Install-PSResource.

Die Parameter "RequiredResource" und "RequiredResourceFile" werden verwendet, um PSResource-Objekte zu finden, die bestimmten Kriterien entsprechen. Sie können die Suchkriterien mithilfe einer Hashtable oder eines JSON-Objekts angeben. Für den Parameter RequiredResourceFile wird die Hashtable in einer .psd1 Datei gespeichert, und das JSON-Objekt wird in einer .json Datei gespeichert. Weitere Informationen finden Sie unter about_PSResourceGet.