Dokumentation zum .NET Core CLI-Tool, Referenz zum Dotnet-Install-Skript

Name

dotnet-install.ps1 |. dotnet-install.sh – Skript und gemeinsame Laufzeit für die Installation von Befehlszeilenschnittstellen-Tools (CLI)

Zusammenfassung

Windows:

dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Debug] [-NoPath] [-SharedRuntime]

OS X/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir] [--debug] [--no-path] [--shared-runtime]

Beschreibung

Das Installationsskript „dotnet-install“ wird verwendet, um eine Nicht-Administrator-Installation der CLI-Toolchain und der freigegebenen Laufzeit durchzuführen. Sie können das Skript von unserem CLI-GitHub-Repo herunterladen.

Es wird hauptsächlich zur Unterstützung bei Automatisierungsszenarien und Nicht-Administrator-Installationen verwendet. Es gibt zwei Skripte: eines ist PowerShell, das unter Windows funktioniert, und ein anderes Bash-Skript, das unter Linux/OS X funktioniert. Beide haben das gleiche Verhalten. Bash-Skripte „verstehen“ auch PowerShell-Schalter, sodass Sie sie flächendeckend verwenden können.

Das Installationsskript wird durch Herunterladen der ZIP-/Tarball-Datei von der CLI generiert und entweder am Standardspeicherort oder an dem durch --install-dir angegebenen Speicherort installiert. Standardmäßig lädt das Installationsskript das SDK herunter und installiert es; wenn Sie nur die freigegebene Laufzeit erhalten möchten, können Sie den Parameter --shared-runtime angeben.

Standardmäßig fügt das Installationsskript den Installationsort zum $PATH der aktuellen Sitzung hinzu. Dies kann überschrieben werden, wenn der Parameter --no-path verwendet wird.

Bitte installieren Sie alle erforderlichen Abhängigkeiten, bevor Sie das Skript ausführen.

Sie können den Parameter --version verwenden, um eine bestimmte Version zu installieren. Die angegebene Version erfordert eine dreiteilige Version (zum Beispiel: 1.0.0-13232). Wenn es weggelassen wird, wird standardmäßig die erste global.json-Datei verwendet, die einen sdkVersion-Knoten enthält, der im übergeordneten Ordner des aufgerufenen Skripts gefunden wird. Wenn es nicht vorhanden ist, wird das neueste verwendet.

Sie können dieses Skript auch verwenden, um Debug-Binärdateien für SDK oder gemeinsam genutzte Runtime-Debugging-Symbole abzurufen, indem Sie das Argument --debug verwenden. Wenn Sie dies bei der ersten Installation nicht tun und die Debugging-Symbole später tatsächlich benötigen, können Sie das Skript mit diesem Parameter und der von Ihnen installierten Version erneut ausführen.

Optionen

Optionen für verschiedene Skriptimplementierungen.

PowerShell (Windows)

-Kanal [CHANNEL]

Der zu installierende Kanal (zum Beispiel: „Zukunft“, „Vorschau“, „Produktion“). Die Standardversion ist „Produktion“.

-Version [VERSION]

Die installierte CLI-Version. Sie müssen die dreiteilige Version angeben (zum Beispiel: 1.0.0-13232). Wenn es weggelassen wird, wird standardmäßig die erste global.json-Datei verwendet, die einen sdkVersion-Knoten enthält, der im übergeordneten Ordner des aufgerufenen Skripts gefunden wird. Wenn es nicht vorhanden ist, wird das neueste verwendet.

-InstallDir [DIR]

Der Installationspfad. Erstellen Sie das Verzeichnis, falls es nicht vorhanden ist. Der Standardwert ist %LocalAppData%.dotnet.

-Debug

true gibt an, dass ein größeres Paket mit Debugging-Symbolen verwendet werden soll; andernfalls false. Der Standardwert ist false.

-NoPath

true gibt an, dass das Präfix/Installationsverzeichnis nicht in den Pfad der aktuellen Sitzung exportiert wird, andernfalls false. Der Standardwert ist false, d. h. PATH wird geändert. Dadurch ist das CLI-Tool sofort nach der Installation verfügbar.

-SharedRuntime

true installiert nur die freigegebene Laufzeit. false installiert das gesamte SDK. Der Standardwert ist false.

Bash (OS ). Die Standardversion ist „Produktion“.

--version [VERSION]

Installierte CLI-Version. Sie müssen die dreiteilige Version angeben (zum Beispiel: 1.0.0-13232). Wenn es weggelassen wird, wird standardmäßig die erste global.json-Datei verwendet, die einen sdkVersion-Knoten enthält. Wenn es nicht vorhanden ist, wird das neueste verwendet.

--install-dir [DIR]

Der Installationspfad. Erstellen Sie das Verzeichnis, falls es nicht vorhanden ist. Der Standardwert ist %HOME%/.dotnet.

--debug

true gibt an, dass ein größeres Paket mit Debugging-Symbolen verwendet werden sollte, andernfalls false. Der Standardwert ist false.

--no-path

true gibt an, dass das Präfix/Installationsverzeichnis nicht in den Pfad der aktuellen Sitzung exportiert wird, andernfalls false. Der Standardwert ist false, d. h. PATH wird geändert. Dadurch ist das CLI-Tool sofort nach der Installation verfügbar.

--shared-runtime

true installiert nur die Shared Runtime. false installiert das gesamte SDK. Der Standardwert ist false.

Beispiel

Windows:

./dotnet-install.ps1 -Channel Future

OS X/Linux:

./dotnet-install.sh --channel Future

Installieren Sie die neueste Entwicklungsversion am Standardspeicherort.

Windows:

./dotnet-install.ps1 -Channel Preview -InstallDir C:cli

OS X/Linux:

./dotnet-install.sh --channel Preview --install-dir ~/cli

Installieren Sie die neueste Vorschauversion am angegebenen Speicherort.