DotNetCoreInstaller@1 – Aufgabe des .NET Core SDK/Runtime-Installers v1

Verwenden Sie diese Aufgabe, um eine bestimmte Version des .NET Core SDK aus dem Internet oder lokalen Cache zu erhalten und sie dem PFAD hinzuzufügen.

Wichtig

Diese Aufgabe ist veraltet und wird am 31. Januar 2024 eingestellt. Verwenden Sie UseDotNet@2.

Syntax

# .NET Core SDK/runtime installer v1
# Acquire a specific version of the .NET Core SDK from the internet or local cache and add it to the PATH.
- task: DotNetCoreInstaller@1
  inputs:
    packageType: 'sdk' # 'runtime' | 'sdk'. Required. Package to install. Default: sdk.
    version: '2.2.x' # string. Required. Version. Default: 2.2.x.
    #includePreviewVersions: false # boolean. Include Preview Versions. Default: false.
  # Advanced
    #installationPath: '$(Agent.ToolsDirectory)/dotnet' # string. Path To Install .Net Core. Default: $(Agent.ToolsDirectory)/dotnet.
    #performMultiLevelLookup: false # boolean. Perform Multi Level Lookup. Default: false.

Eingaben

packageType - Zu installierende Paket
string. Erforderlich. Zulässige Werte: runtime (Nur Runtime), sdk (SDK (enthält Runtime)). Standardwert. sdk.

Gibt an, ob nur Runtime oder das vollständige SDK installiert werden soll.

version - Version
string. Erforderlich. Standardwert. 2.2.x.

Gibt die zu installierende Version des .NET Core SDK oder der Runtime an.

Verwenden Sie das folgende Format, um die Version anzugeben:

• 2.x: Installiert die neueste Hauptversion.
• 2.2.x: Installiert die neueste Haupt- und Nebenversion.
• 2.2.104: Installiert die genaue Version.

Suchen Sie den Wert von für die Installation von version SDK/Runtime in der Datei releases-index.

includePreviewVersions - Vorschauversionen einschließen
boolean. Standardwert. false.

Gibt an, ob Vorschauversionen bei der Suche nach den neuesten Versionen einbezogen werden sollen. Diese Einstellung wird ignoriert, wenn Sie eine genaue Version angeben, z. B 3.0.100-preview3-010431. .

installationPath - Installationspfad .NET Core
string. Standardwert. $(Agent.ToolsDirectory)/dotnet.

Gibt an, wo .NET Core SDK/Runtime installiert werden soll. Verschiedene Pfade können die folgenden Auswirkungen auf haben. NET-Verhalten:

• $(Agent.ToolsDirectory): Dadurch wird die Version bestimmt, die im Agent zwischengespeichert werden soll, da dieses Verzeichnis nicht pipelineübergreifend bereinigt wird. Alle Pipelines, die auf dem Agent ausgeführt werden, hätten Zugriff auf die Versionen, die zuvor mit dem Agent installiert wurden.
• $(Agent.TempDirectory): Dadurch kann sichergestellt werden, dass eine Pipeline keine zwischengespeicherte Version von .NET Core verwendet, da dieser Ordner nach jeder Pipeline bereinigt wird.
• Jeder andere Pfad: Sie können jeden anderen Pfad konfigurieren, wenn der Agentprozess Zugriff auf den Pfad hat. Dadurch ändert sich der Zustand des Computers und wirkt sich auf alle prozesse aus, die darauf ausgeführt werden.

Sie können auch die Multi-Level-Lookup-Einstellung konfigurieren. Diese Einstellung kann den .NET-Host so konfigurieren, dass er auf eine geeignete Version prüft.

performMultiLevelLookup - Ausführen von Mehrebenensuche
boolean. Standardwert. false.

Diese Eingabe gilt nur für Windows-basierte Agents. Diese Eingabe konfiguriert das Verhalten von .NET-Hostprozessen für die Suche nach einem geeigneten freigegebenen Framework. False bedeutet, dass nur Versionen, die in dem in dieser Aufgabe angegebenen Ordner vorhanden sind, vom Hostprozess gesucht werden. True bedeutet, dass der Host versucht, in vordefinierten globalen Speicherorten mithilfe von Mehrebenensuche nachzuschlagen.

Für Windows sind die globalen Standardspeicherorte:

• C:\Program Files\dotnet (64-Bit-Prozesse)
• C:\Program Files (x86)\dotnet (32-Bit-Prozess)

Weitere Informationen finden Sie unter SharedFX-Lookup mit mehreren Ebenen.

Optionen für die Vorgangskontrolle

Alle Vorgänge verfügen zusätzlich zu ihren Eingaben über Steuerungsoptionen. Weitere Informationen finden Sie unter Steuerungsoptionen und allgemeine Aufgabeneigenschaften.

Ausgabevariablen

Keine.

Hinweise

Diese Aufgabe ist veraltet. Verwenden Sie @UseDotNet2.

Neuerungen in dieser Aufgabenversion.

• Unterstützung für die gleichzeitige Installation mehrerer Versionen.
• Unterstützung für Muster in der Version zum Abrufen der neuesten In-/Hauptversion.
• Beschränken sie die Suche auf mehreren Ebenen.

Anforderungen

Anforderung	BESCHREIBUNG
Pipelinetypen	YAML, Klassischer Build, klassische Version
Wird ausgeführt auf	Agent, DeploymentGroup
Forderungen	Keine
Capabilities	Das Ausführen dieser Aufgabe erfüllt die folgenden Anforderungen für alle nachfolgenden Aufgaben im gleichen Auftrag: DotNetCore
Befehlseinschränkungen	Any
Einstellbare Variablen	Any
Agent-Version	Alle unterstützten Agent-Versionen.
Aufgabenkategorie	Tool