DotNet-betiklerin başvurusunu yüklemeyi

  • Makale
  • Okumak için 2 dakika

Name

dotnet-install.ps1 | dotnet-install.sh -.NET SDK ve paylaşılan çalışma zamanı yüklemek için kullanılan betik.

Özeti

Windows:

dotnet-install.ps1 [-Architecture <ARCHITECTURE>] [-AzureFeed]
    [-Channel <CHANNEL>] [-DryRun] [-FeedCredential]
    [-InstallDir <DIRECTORY>] [-JSonFile <JSONFILE>]
    [-NoCdn] [-NoPath] [-ProxyAddress] [-ProxyBypassList <LIST_OF_URLS>]
    [-ProxyUseDefaultCredentials] [-Quality <QUALITY>] [-Runtime <RUNTIME>]
    [-SkipNonVersionedFiles] [-UncachedFeed] [-Verbose]
    [-Version <VERSION>]

Get-Help ./dotnet-install.ps1

Linux/macOS:

dotnet-install.sh  [--architecture <ARCHITECTURE>] [--azure-feed]
    [--channel <CHANNEL>] [--dry-run] [--feed-credential]
    [--install-dir <DIRECTORY>] [--jsonfile <JSONFILE>]
    [--no-cdn] [--no-path] [--quality <QUALITY>]
    [--runtime <RUNTIME>] [--runtime-id <RID>]
    [--skip-non-versioned-files] [--uncached-feed] [--verbose]
    [--version <VERSION>]

dotnet-install.sh --help

Bash betiği Ayrıca PowerShell anahtarlarını okur, bu sayede PowerShell anahtarlarını Linux/macOS sistemlerinde betiği ile birlikte kullanabilirsiniz.

Description

dotnet-installBetikler .NET SDK 'sının .net CLI ve paylaşılan çalışma zamanını içeren yönetici olmayan bir yüklemesini gerçekleştirir. İki komut dosyası vardır:

  • Windows üzerinde çalışacak bir PowerShell betiği.
  • Linux/macOS üzerinde çalışacak bir bash betiği.

Not

.NET telemetri verilerini toplar. Daha fazla bilgi edinmek ve devre dışı bırakmak için bkz. .NET SDK telemetrisi.

Amaç

Betiklerin amaçlanan kullanımı sürekli tümleştirme (CI) senaryolarına yöneliktir; burada:

  • SDK 'nın Kullanıcı etkileşimi olmadan ve yönetici hakları olmadan yüklenmesi gerekir.

  • SDK yüklemesinin birden çok CI çalıştırması arasında kalıcı olması gerekmez.

    Tipik olay dizisi:

    • CI tetiklenir.
    • CI, Bu betiklerin birini kullanarak SDK 'Yı yüklüyor.
    • CI işini sonlandırır ve SDK yüklemesi dahil olmak üzere geçici verileri temizler.

Geliştirme ortamı ayarlamak veya uygulamaları çalıştırmak için, bu betikler yerine yükleyicileri kullanın.

Betiklerin kararlı sürümünü kullanmanızı öneririz:

Betik davranışı

Her iki komut dosyası da aynı davranışa sahiptir. Bunlar, CLı derleme bırakmalarından ZIP/tarbol dosyasını indirir ve varsayılan konuma veya tarafından belirtilen bir konuma yüklemeye devam ederler -InstallDir|--install-dir .

Varsayılan olarak, yükleme betikleri SDK 'Yı indirir ve yükler. Yalnızca paylaşılan çalışma zamanını elde etmek istiyorsanız, -Runtime|--runtime bağımsız değişkenini belirtin.

Komut dosyası varsayılan olarak, geçerli oturum için $PATH yüklemesi konumunu ekler. Bağımsız değişkenini belirterek bu varsayılan davranışı geçersiz kılın -NoPath|--no-path . Betik, DOTNET_ROOT ortam değişkenini ayarladı.

Betiği çalıştırmadan önce gerekli bağımlılıklarıyükler.

Bağımsız değişkenini kullanarak belirli bir sürümü yükleyebilirsiniz -Version|--version . Sürüm, gibi üç bölümden oluşan bir sürüm numarası olarak belirtilmelidir 2.1.0 . Sürüm belirtilmemişse, komut dosyası latest sürümü yüklenir.

Install betikleri Windows kayıt defterini güncelleştirmez. Yalnızca daraltılmış ikilileri indirir ve bir klasöre kopyalar. Kayıt defteri anahtarı değerlerinin güncelleştirilmesini istiyorsanız .NET yükleyicileri ' ni kullanın.

Seçenekler

  • -Architecture|--architecture <ARCHITECTURE>

    Yüklenecek .NET ikililerinin mimarisi. Olası değerler şunlardır,,,, <auto> amd64 x64 x86 arm64 ve arm . Varsayılan değer <auto> , çalışmakta olan işletim sistemi mimarisini temsil eder.

  • -AzureFeed|--azure-feed

    Yükleyicideki Azure akışına ait URL 'YI belirtir. Bu değeri değiştirmemenizi öneririz. https://dotnetcli.azureedge.net/dotnet varsayılan değerdir.

  • -Channel|--channel <CHANNEL>

    Yükleme için kaynak kanalını belirtir. Olası değerler şunlardır:

    • Current -En güncel sürüm.
    • LTS -Long-Term destek kanalı (desteklenen en güncel sürüm).
    • Belirli bir sürümü (örneğin, veya) temsil eden. B biçimindeki iki bölümden oluşan sürüm 2.1 3.0 .
    • Belirli bir SDK sürümünü (örneğin, 5.0.1 xx veya 5.0.2 xx) temsil eden. B. cxx biçimindeki üç bölümden oluşan sürüm. 5,0 sürümünden itibaren kullanılabilir.

    Parametresi, dışında version channel bir sürüm kullanıldığında parametresini geçersiz kılar latest .

    LTS varsayılan değerdir. .NET destek kanalları hakkında daha fazla bilgi için bkz. .net destek ilkesi sayfası.

  • -DryRun|--dry-run

    Ayarlanırsa, betik yüklemeyi gerçekleştirmez. Bunun yerine, mevcut .NET CLı sürümünü tutarlı bir şekilde yüklemek için kullanılacak komut satırını görüntüler. Örneğin, sürümünü belirtirseniz latest , bu komutun bir yapı betiğine göre belirleyici olarak kullanılabilmesi için belirli bir sürümle birlikte bir bağlantı görüntüler. Ayrıca, kendiniz yüklemeyi veya indirmeyi tercih ediyorsanız ikilinin konumunu da görüntüler.

  • -FeedCredential|--feed-credential

    Azure akışına eklemek için sorgu dizesi olarak kullanılır. Bu, URL 'nin genel olmayan BLOB depolama hesaplarını kullanmak üzere değiştirilmesini sağlar.

  • --help

    Betiğe yönelik yardım yazdırır. Yalnızca Bash betiği için geçerlidir. PowerShell için kullanın Get-Help ./dotnet-install.ps1 .

  • -InstallDir|--install-dir <DIRECTORY>

    Yükleme yolunu belirtir. Dizin yoksa oluşturulur. varsayılan değer %localappdata%\microsoft\dotnet Windows ve Linux/macos üzerinde /ve dotnet $HOME . İkili dosyalar doğrudan bu dizine yerleştirilir.

  • -JSonFile|--jsonfile <JSONFILE>

    SDK sürümünü belirlemekte kullanılacak Global. JSON dosyasının yolunu belirtir. Global. JSON dosyası için bir değere sahip olmalıdır sdk:version .

  • -NoCdn|--no-cdn

    Azure Content Delivery Network (CDN) indirmeyi devre dışı bırakır ve önbelleğe alınmamış akışı doğrudan kullanır.

  • -NoPath|--no-path

    Ayarlanırsa, yükleme klasörü geçerli oturum için yola aktarılmaz. Varsayılan olarak, komut dosyası yolu değiştirir ve bu, .NET CLı 'yı yüklemeden hemen sonra kullanılabilir hale getirir.

  • -ProxyAddress

    Ayarlanırsa, yükleyici Web istekleri yaparken proxy 'yi kullanır. (Yalnızca Windows için geçerlidir.)

  • -ProxyBypassList <LIST_OF_URLS>

    İle ayarlandıysa ProxyAddress , proxy 'yi atlayacak, virgülle ayrılmış URL 'lerin bir listesini sağlar. (Yalnızca Windows için geçerlidir.)

  • ProxyUseDefaultCredentials

    Ayarlanırsa, yükleyici proxy adresini kullanırken geçerli kullanıcının kimlik bilgilerini kullanır. (Yalnızca Windows için geçerlidir.)

  • -Quality|--quality <QUALITY>

    Kanalda belirtilen kaliteyi en son derlemeyi indirir. Olası değerler şunlardır: daily , signed ,, validated preview , GA . Yalnızca ile birlikte geçerlidir channel . Geçerli ve LTS kanalları için geçerli değildir ve bu kanallardan biri kullanılırsa yok sayılır.

    SDK yüklemesi için, channel A.B veya A.B.Cxx biçiminde kullanın. Çalışma zamanı yüklemesi için biçiminde kullanın channel A.B .

    versionParametresi, dışında channel bir dışında, ve parametrelerini geçersiz kılar quality version latest .

    5,0 sürümünden bu yana kullanılabilir.

  • -Runtime|--runtime <RUNTIME>

    Tüm SDK 'Yı değil yalnızca paylaşılan çalışma zamanını kurar. Olası değerler şunlardır:

    • dotnet - Microsoft.NETCore.App paylaşılan çalışma zamanı.
    • aspnetcore - Microsoft.AspNetCore.App paylaşılan çalışma zamanı.
    • windowsdesktop - Microsoft.WindowsDesktop.App paylaşılan çalışma zamanı.

  • --runtime-id <RID> Kullanım dışı

    Araçların yüklendiği çalışma zamanı tanımlayıcısını belirtir. Taşınabilir linux-x64 Linux için kullanın. (Yalnızca Linux/macOS ve .NET Core 2.1'den önceki sürümler için geçerlidir.)

    --os <OPERATING_SYSTEM>

    Araçların yüklü olduğu işletim sistemini belirtir. Olası değerler: osx , , , , linux linux-musl freebsd rhel.6 . (.NET Core 2.1 ve sonraki için geçerlidir.)

    parametresi isteğe bağlıdır ve yalnızca betik tarafından algılanan işletim sistemini geçersiz kılmak gerektiğinde kullanılmalıdır.

  • -SharedRuntime|--shared-runtime

    Not

    Bu parametre artık kullanılmıyor ve betiğin gelecekteki bir sürümünde kaldırılabilir. Önerilen alternatif -Runtime|--runtime seçenektir.

    SDK'nın tamamını değil yalnızca paylaşılan çalışma zamanı bitlerini yükleme. Bu seçenek, belirtmeye -Runtime|--runtime dotnet eşdeğerdir.

  • -SkipNonVersionedFiles|--skip-non-versioned-files

    Zaten varsa,dotnet.exegibi sürüme sahip olmayan dosyaları yüklemeyi atlar.

  • -UncachedFeed|--uncached-feed

    Bu yükleyici tarafından kullanılan erişimsiz akışın URL'sinin değiştirilmesine izin verir. Bu değeri değiştirmenizi önerilmez.

  • -Verbose|--verbose

    Tanılama bilgilerini görüntüler.

  • -Version|--version <VERSION>

    Belirli bir derleme sürümünü temsil eder. Olası değerler şunlardır:

    • latest - Kanalda en son derleme (seçeneğiyle -Channel birlikte kullanılır).
    • Belirli bir derleme sürümünü temsil eden X.Y.Z biçiminde üç parçalı sürüm; seçeneğinin yenisi -Channel olur. Örneğin: 2.0.0-preview2-006120.

    Belirtilmezse, -Version varsayılan olarak latest kullanılır.

Örnekler

  • En son uzun süreli desteklenen (LTS) sürümü varsayılan konuma yükleyin:

    Windows:

    ./dotnet-install.ps1 -Channel LTS

    macOS/Linux:

    ./dotnet-install.sh --channel LTS

  • Belirtilen konuma 6.0.1xx SDK'nın en son önizleme sürümünü yükleyin:

    Windows:

    ./dotnet-install.ps1 -Channel 6.0.1xx -Quality preview -InstallDir C:\cli

    macOS/Linux:

    ./dotnet-install.sh --channel 6.0.1xx --quality preview --install-dir ~/cli

  • Paylaşılan çalışma zamanının 3.0.0 sürümünü yükleyin:

    Windows:

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

    macOS/Linux:

    ./dotnet-install.sh --runtime dotnet --version 3.0.0

  • Betiği alın ve 2.1.2 sürümünü şirket ara sunucusunun arkasına yükleyin (yalnızca Windows):

    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;

  • Betik alın ve .NET CLI tek satırlı örnekleri yükleyin:

    Windows:

    # Run a separate PowerShell process because the script calls exit, so it will end the current PowerShell session.
&powershell -NoProfile -ExecutionPolicy unrestricted -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; &([scriptblock]::Create((Invoke-WebRequest -UseBasicParsing 'https://dot.net/v1/dotnet-install.ps1'))) <additional install-script args>"

    macOS/Linux:

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

Ayrıca bkz.