referencia de scripts de dotnet-installdotnet-install scripts reference

nombreName

dotnet-install.ps1 | dotnet-install.sh: script usado para instalar las herramientas de la CLI de .NET Core y el entorno de tiempo de ejecución compartido.dotnet-install.ps1 | dotnet-install.sh - Script used to install the .NET Core CLI tools and the shared runtime.

SinopsisSynopsis

Windows:Windows:

dotnet-install.ps1 [-Channel] [-Version] [-InstallDir] [-Architecture] [-SharedRuntime] [-Runtime] [-DryRun] [-NoPath] [-Verbose] [-AzureFeed] [-UncachedFeed] [-NoCdn] [-FeedCredential] [-ProxyAddress] [-ProxyUseDefaultCredentials] [-SkipNonVersionedFiles] [-Help]

macOS y Linux:macOS/Linux:

dotnet-install.sh [--channel] [--version] [--install-dir] [--architecture] [--runtime] [--dry-run] [--no-path] [--verbose] [--azure-feed] [--uncached-feed] [--no-cdn] [--feed-credential] [--runtime-id] [--skip-non-versioned-files] [--help]

DescripciónDescription

Los scripts dotnet-install se usan para realizar una instalación sin derechos administrativos del SDK de .NET Core, que incluye las herramientas de la CLI de .NET Core y el entorno de tiempo de ejecución compartido.The dotnet-install scripts are used to perform a non-admin installation of the .NET Core SDK, which includes the .NET Core CLI tools and the shared runtime.

Le recomendamos que use la versión estable que se hospeda en el sitio web principal de .NET Core.We recommend that you use the stable version that is hosted on .NET Core main website. Las rutas de acceso directas a los scripts son las siguientes:The direct paths to the scripts are:

La utilidad principal de estos scripts está en los escenarios de automatización y las instalaciones sin derechos administrativos.The main usefulness of these scripts is in automation scenarios and non-admin installations. Existen dos scripts: uno es un script de PowerShell que funciona en Windows y el otro es un script de Bash que funciona en Linux y macOS.There are two scripts: one is a PowerShell script that works on Windows, and the other is a bash script that works on Linux/macOS. Ambos scripts tienen el mismo comportamiento.Both scripts have the same behavior. El script de bash también lee modificadores de PowerShell, por lo que puede usar modificadores de PowerShell con el script en sistemas Linux y macOS.The bash script also reads PowerShell switches, so you can use PowerShell switches with the script on Linux/macOS systems.

Los scripts de instalación descargan el archivo ZIP o tarball desde las entregas de compilación de la CLI y proceden a instalarlo en la ubicación predeterminada o en una ubicación especificada por -InstallDir|--install-dir.The installation scripts download the ZIP/tarball file from the CLI build drops and proceed to install it in either the default location or in a location specified by -InstallDir|--install-dir. De forma predeterminada, los scripts de instalación descargan el SDK y lo instalan.By default, the installation scripts download the SDK and install it. Si desea obtener solo el tiempo de ejecución compartido, especifique el argumento --runtime.If you wish to only obtain the shared runtime, specify the --runtime argument.

De forma predeterminada, el script agrega la ubicación de instalación a $PATH para la sesión actual.By default, the script adds the install location to the $PATH for the current session. Para invalidar este comportamiento, especifique el argumento --no-path.Override this default behavior by specifying the --no-path argument.

Antes de ejecutar el script, instale las dependencias necesarias.Before running the script, install the required dependencies.

Puede instalar una versión específica mediante el argumento --version.You can install a specific version using the --version argument. La versión debe especificarse como una versión de tres partes (por ejemplo, 1.0.0-13232).The version must be specified as a three-part version (for example, 1.0.0-13232). Si no se proporciona, usa la versión latest.If not provided, it uses the latest version.

OpcionesOptions

  • -Channel <CHANNEL>

    Especifica el canal de origen para la instalación.Specifies the source channel for the installation. Los valores posibles son:The possible values are:

    • Current: versión más actual.Current - Most current release.
    • LTS: canal de soporte técnico a largo plazo (versión compatible más actual).LTS - Long-Term Support channel (most current supported release).
    • Versión de dos partes en formato X.Y que representa una versión específica (por ejemplo, 2.0 o 1.0).Two-part version in X.Y format representing a specific release (for example, 2.0 or 1.0).
    • Nombre de rama.Branch name. Por ejemplo, release/2.0.0, release/2.0.0-preview2 o master (para versiones nocturnas).For example, release/2.0.0, release/2.0.0-preview2, or master (for nightly releases).

    El valor predeterminado es LTS.The default value is LTS. Para más información sobre los canales de soporte técnico de .NET, vea la página .NET Support Policy (Directiva de soporte técnico de .NET Core).For more information on .NET support channels, see the .NET Support Policy page.

  • -Version <VERSION>

    Representa una versión de compilación concreta.Represents a specific build version. Los valores posibles son:The possible values are:

    • latest: compilación más reciente en el canal (utilizado con la opción -Channel).latest - Latest build on the channel (used with the -Channel option).
    • coherent: compilación coherente más reciente en el canal; usa la última combinación de paquetes estables (usados con las opciones -Channel del nombre de la rama).coherent - Latest coherent build on the channel; uses the latest stable package combination (used with Branch name -Channel options).
    • Versión de tres partes en formato X.Y.Z que representa una determinada versión de compilación; reemplaza a la opción -Channel.Three-part version in X.Y.Z format representing a specific build version; supersedes the -Channel option. Por ejemplo: 2.0.0-preview2-006120.For example: 2.0.0-preview2-006120.

    Si no se especifica, el valor predeterminado de -Version es latest.If not specified, -Version defaults to latest.

  • -InstallDir <DIRECTORY>

    Especifica la ruta de instalación.Specifies the installation path. Si no existe el directorio, se crea.The directory is created if it doesn't exist. El valor predeterminado es %LocalAppData%\Microsoft\dotnet.The default value is %LocalAppData%\Microsoft\dotnet. Los archivos binarios se colocan directamente en el directorio.Binaries are placed directly in this directory.

  • -Architecture <ARCHITECTURE>

    Arquitectura de los archivos binarios de .NET Core para instalar.Architecture of the .NET Core binaries to install. Los valores posibles son <auto>, amd64, x64, x86, arm64 y arm.Possible values are <auto>, amd64, x64, x86, arm64, and arm. El valor predeterminado es <auto>, que representa la arquitectura de SO que se ejecuta en ese momento.The default value is <auto>, which represents the currently running OS architecture.

  • -SharedRuntime

    Nota

    Este parámetro está obsoleto y puede quitarse en una versión futura del script.This parameter is obsolete and may be removed in a future version of the script. La alternativa recomendada es la opción Runtime.The recommended alternative is the Runtime option.

    Se instalan simplemente los bits del entorno de tiempo de ejecución compartido, no el SDK completo.Installs just the shared runtime bits, not the entire SDK. Es equivalente a especificar -Runtime dotnet.This is equivalent to specifying -Runtime dotnet.

  • -Runtime <RUNTIME>

    Se instala simplemente el entorno de tiempo de ejecución compartido, no el SDK completo.Installs just the shared runtime, not the entire SDK. Los valores posibles son:The possible values are:

    • dotnet: el entorno de tiempo de ejecución compartido Microsoft.NETCore.App.dotnet - the Microsoft.NETCore.App shared runtime.
    • aspnetcore: el entorno de tiempo de ejecución compartido Microsoft.AspNetCore.App.aspnetcore - the Microsoft.AspNetCore.App shared runtime.
  • -DryRun

    Si se establece, el script no realizará la instalación.If set, the script won't perform the installation. En su lugar, mostrará qué línea de comandos se va a usar para instalar de manera coherente la versión solicitada actualmente de la CLI de .NET Core.Instead, it displays what command line to use to consistently install the currently requested version of the .NET Core CLI. Por ejemplo, si especifica la versión latest, se muestra un vínculo con la versión específica, de manera que este comando puede usarse de manera determinista en un script de compilación.For example, if you specify version latest, it displays a link with the specific version so that this command can be used deterministically in a build script. También se muestra la ubicación de los archivos binarios si prefiere instalarla o descargarla por su cuenta.It also displays the binary's location if you prefer to install or download it yourself.

  • -NoPath

    Si se establece, la carpeta de instalación no se exporta a la ruta de acceso para la sesión actual.If set, the installation folder isn't exported to the path for the current session. De manera predeterminada, el script modifica la ruta de acceso, que hace que las herramientas de la CLI estén disponibles inmediatamente después de la instalación.By default, the script modifies the PATH, which makes the CLI tools available immediately after install.

  • -Verbose

    Muestra la información de diagnóstico.Displays diagnostics information.

  • -AzureFeed

    Especifica la dirección URL de la fuente de Azure al instalador.Specifies the URL for the Azure feed to the installer. Le recomendamos que no cambie este valor.We recommended that you don't change this value. El valor predeterminado es https://dotnetcli.azureedge.net/dotnet.The default value is https://dotnetcli.azureedge.net/dotnet.

  • -UncachedFeed

    Permite cambiar la dirección URL de la fuente no almacenada en caché que este instalador utiliza.Allows changing the URL for the uncached feed used by this installer. Le recomendamos que no cambie este valor.We recommended that you don't change this value.

  • -NoCdn

    Deshabilita la descarga desde Azure Content Delivery Network (CDN) y usa la fuente no almacenada en caché directamente.Disables downloading from the Azure Content Delivery Network (CDN) and uses the uncached feed directly.

  • -FeedCredential

    Se utiliza como una cadena de consulta para anexar a la fuente de Azure.Used as a query string to append to the Azure feed. Permite cambiar la dirección URL para usar cuentas de almacenamiento de blobs no público.It allows changing the URL to use non-public blob storage accounts.

  • -ProxyAddress

    Si se establece, el instalador usa el proxy al realizar solicitudes web.If set, the installer uses the proxy when making web requests. (Solo es válido para Windows)(Only valid for Windows)

  • ProxyUseDefaultCredentials

    Si se establece, el instalador usa las credenciales del usuario actual cuando se usa la dirección del proxy.If set, the installer uses the credentials of the current user when using proxy address. (Solo es válido para Windows)(Only valid for Windows)

  • -SkipNonVersionedFiles

    Omite la instalación de archivos sin control de versiones, como dotnet.exe, si ya existen.Skips installing non-versioned files, such as dotnet.exe, if they already exist.

  • -Help

    Imprime la ayuda para el script.Prints out help for the script.

EjemplosExamples

  • Instale la versión compatible a largo plazo más reciente en la ubicación predeterminada:Install the latest long-term supported (LTS) version to the default location:

    Windows:Windows:

    ./dotnet-install.ps1 -Channel LTS
    

    macOS y Linux:macOS/Linux:

    ./dotnet-install.sh --channel LTS
    
  • Instale la versión más reciente del canal 2.0 en la ubicación especificada:Install the latest version from 2.0 channel to the specified location:

    Windows:Windows:

    ./dotnet-install.ps1 -Channel 2.0 -InstallDir C:\cli
    

    macOS y Linux:macOS/Linux:

    ./dotnet-install.sh --channel 2.0 --install-dir ~/cli
    
  • Instale la versión 1.1.0 del entorno de tiempo de ejecución compartido:Install the 1.1.0 version of the shared runtime:

    Windows:Windows:

    ./dotnet-install.ps1 -Runtime dotnet -Version 1.1.0
    

    macOS y Linux:macOS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 1.1.0
    
  • Obtenga el script e instale la versión 2.1.2 detrás de un proxy corporativo (solo Windows):Obtain script and install the 2.1.2 version behind a corporate proxy (Windows only):

    Invoke-WebRequest 'https://dot.net/v1/dotnet-install.ps1' -Proxy $env:HTTP_PROXY -ProxyUseDefaultCredentials -OutFile 'dotnet-install.ps1';
    ./dotnet-install.ps1 -InstallDir '~/.dotnet' -Version '2.1.2' -ProxyAddress $env:HTTP_PROXY -ProxyUseDefaultCredentials;
    
  • Obtenga el script e instale ejemplos de una línea para la CLI de .NET Core:Obtain script and install .NET Core CLI one-liner examples:

    Windows:Windows:

    @powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -useb 'https://dot.net/v1/dotnet-install.ps1'))) <additional install-script args>"
    

    macOS y Linux:macOS/Linux:

    curl -sSL https://dot.net/v1/dotnet-install.sh | bash /dev/stdin <additional install-script args>
    

Vea tambiénSee also