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 Cmdlets und Install-Script von PowerShellGet v2.

Beispiele

Beispiel 1

Installiert die neueste stabile Version (ohne Vorabversion) des Az-Moduls.

Install-PSResource Az

Beispiel 2

Installiert das neueste stabile Az-Modul zwischen den 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 alle zuvor installierten Versionen.

Install-PSResource Az -Reinstall

Beispiel 4

Installiert die in der psd1-Datei angegebenen PSResources.

Install-PSResource -RequiredResourceFile myRequiredModules.psd1

Beispiel 5

Installiert die psResources, die in der Hashtabelle angegeben sind.

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 verlangt, dass ein Benutzer die Lizenzvereinbarung akzeptiert.

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

-AuthenticodeCheck

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

-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

-NoClobber

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

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

-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

-Quiet

Unterdrückt die Installationsstatusanzeige.

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

-Reinstall

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

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

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

-RequiredResource

Eine Hashtabelle oder JSON-Zeichenfolge, die zu installierende Ressourcen angibt. Wildcardzeichen sind nicht zulässig. Eine Beschreibung der Dateiformate finden Sie im Abschnitt NOTES .

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

-RequiredResourceFile

Pfad zu einem .psd1 oder .json , der die zu installierenden Ressourcen angibt. Wildcardzeichen sind nicht zulässig. Eine Beschreibung der Dateiformate finden Sie im Abschnitt NOTES .

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

-Scope

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

CurrentUser
AllUsers

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

Der AllUsers Bereich installiert Module an einem Speicherort, der für alle Benutzer des Computers zugänglich ist. Beispiel:

$env:ProgramFiles\PowerShell\Modules

Installiert CurrentUser Module an einem Speicherort, auf den nur der aktuelle Benutzer des Computers zugreifen kann. Beispiel:

$home\Documents\PowerShell\Modules

Type:	Microsoft.PowerShell.PSResourceGet.UtilClasses.ScopeType
Accepted values:	CurrentUser, AllUsers
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-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 der eigentlichen Installation 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.

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 Hashtabelle oder eines JSON-Objekts angeben. Für den Parameter RequiredResourceFile wird die Hashtabelle in einer .psd1 Datei und das JSON-Objekt in einer .json Datei gespeichert. Weitere Informationen finden Sie unter about_PSResourceGet.

Install-PSResource

Syntax

Beschreibung

Beispiele

Beispiel 1

Beispiel 2

Beispiel 3

Beispiel 4

Beispiel 5

Parameter

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Eingaben

Ausgaben

Hinweise

Feedback

Zusätzliche Ressourcen

Install-PSResource

Syntax

Beschreibung

Beispiele

Beispiel 1

Beispiel 2

Beispiel 3

Beispiel 4

Beispiel 5

Parameter

-AcceptLicense

-AuthenticodeCheck

-Confirm

-Credential

-InputObject

-Name

-NoClobber

-PassThru

-Prerelease

-Quiet

-Reinstall

-Repository

-RequiredResource

-RequiredResourceFile

-Scope

-SkipDependencyCheck

-TemporaryPath

-TrustRepository

-Version

-WhatIf

Eingaben

Ausgaben

Hinweise

Ähnliche Themen

Feedback

Zusätzliche Ressourcen