Heim > Artikel > Backend-Entwicklung > 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
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.