.NET Barındırma Paketi

Note

Bu, bu makalenin en son sürümü değildir. Geçerli sürüm için bu makalenin .NET 10 sürümüne bakın.

Warning

ASP.NET Core'un bu sürümü artık desteklenmiyor. Daha fazla bilgi için bkz . .NET ve .NET Core Destek İlkesi. Geçerli sürüm için bu makalenin .NET 9 sürümüne bakın.

.NET Barındırma paketi, .NET Çalışma Zamanı ve ASP.NET Çekirdek Modülü için bir yükleyicidir. Paket, ASP.NET Core uygulamalarının IIS ile çalışmasına olanak tanır.

.NET Barındırma Paketini Yükleme

Important

Barındırma Paketi IIS'den önce yüklenirse paket yüklemesinin onarılması gerekir. IIS'yi yükledikten sonra Barındırma Paketi yükleyicisini yeniden çalıştırın.

.NET'in 64 bit (x64) sürümünü yükledikten sonra Barındırma Paketi yüklenirse SDK'lar eksik gibi görünebilir (.NET SDK'ları algılanmadı). Sorunu çözmek için bkz. ASP.NET Core projelerinde sorun giderme ve hata ayıklama.

Önemli değişiklikler ve güvenlik önerileri Duyurular havuzunda bildirilir. Etiket filtresi seçilerek duyurular belirli bir sürümle sınırlandırılabilir.

Doğrudan indirme

Aşağıdaki bağlantıları kullanarak yükleyiciyi indirin:

• Geçerli sürüm: .NET Barındırma Paketi yükleyicisi (doğrudan indirme)
• Önceki ve yayın öncesi sürümler

Visual C++ Yeniden Dağıtılabilir Gereksinimi

Windows'un eski sürümlerinde, örneğin Windows Server 2012 R2'de Visual Studio C++ 2015, 2017, 2019 Yeniden Dağıtılabilir'i yükleyin. Aksi takdirde, Windows Olay Günlüğü'nde kafa karıştırıcı bir hata iletisi bildirir ki The data is the error.

Geçerli x64 VS C++ yeniden dağıtılabilirGeçerli x86 VS C++ yeniden dağıtılabilir

Yükleyicinin önceki sürümleri

Yükleyicinin önceki bir sürümünü edinmek için:

1. .NET'i İndir sayfasına gidin.
2. İstenen .NET sürümünü seçin.
3. Uygulamaları çalıştır - Çalışma Zamanı sütununda, istenen .NET çalışma zamanı sürümünün satırını bulun.
4. Barındırma Paketi bağlantısını kullanarak yükleyiciyi indirin.

Warning

Bazı yükleyiciler kullanım ömrünün sonuna (EOL) ulaşmış ve artık Microsoft tarafından desteklenmeyen sürümler içerir. Daha fazla bilgi için destek ilkesi bölümüne bakın.

ASP.NET Core Modülü, .NET'in destek içi sürümleriyle ileri ve geri uyumludur.

Options

1. Yönetici komut kabuğundan yükleyiciyi çalıştırırken aşağıdaki parametreler kullanılabilir:

   • OPT_NO_ANCM=1: ASP.NET Core Modülü'nü yüklemeyi atlayın.
   • OPT_NO_RUNTIME=1: .NET çalışma zamanını yüklemeyi atlayın. Sunucu yalnızca kendi içindeki dağıtımları (SCD) barındırdığında kullanılır.
   • OPT_NO_SHAREDFX=1: ASP.NET Paylaşılan Çerçevesi'ni (ASP.NET çalışma zamanı) yüklemeyi atlayın. Sunucu yalnızca kendi içindeki dağıtımları (SCD) barındırdığında kullanılır.
   • OPT_NO_X86=1: x86 çalışma zamanlarını yüklemeyi atlayın. Bu parametreyi, 32 bit uygulamalar barındırmayacağınızı bildiğiniz durumlarda kullanın. Gelecekte hem 32 bit hem de 64 bit uygulamalar barındırma olasılığınız varsa bu parametreyi kullanmayın ve her iki çalışma zamanını da yükleyin.
   • OPT_NO_SHARED_CONFIG_CHECK=1: Paylaşılan yapılandırma (applicationHost.config) IIS yüklemesiyle aynı makinede yer aldığında IIS Paylaşılan Yapılandırması'nı kullanmak için denetimi devre dışı bırakın. Yalnızca ASP.NET Core 2.2 veya üzeri Barındırma Paketi yükleyicilerinde kullanılabilir. Daha fazla bilgi için, bkz. Gelişmiş yapılandırma.

Note

IIS Paylaşılan Yapılandırması hakkında bilgi için bkz. IIS Paylaşılan Yapılandırması ile ASP.NET Core Modülü.

Note

Barındırma Paketi yükleyicisini seçenekler ayarlanmış olarak çalıştırırken, her seçeneğin değeri kayıt defterine kaydedilir. Aynı Major.Minor sürüm bandından yapılan sonraki yüklemeler, komut satırından açıkça başka bir seçenek kümesi geçirilmediği sürece aynı seçenekleri kullanır. Barındırma paketinin ilk yüklemesinde herhangi bir seçenek geçirilmemişse, her seçenek kayıt defterine yazılan varsayılan değerini 0 alır. 0 değeri, seçeneğin kapalı olduğunu belirtir, yani kullanıcı belirtilen bileşenden vazgeçmiyor demektir.

IIS'yi yeniden başlatma

Barındırma Paketi yüklendikten sonra el ile IIS yeniden başlatması gerekebilir. Örneğin, dotnet IIS çalışan işlemlerini çalıştırmak için PATH'de CLI araçları (komut) bulunmayabilir.

IIS'yi el ile yeniden başlatmak için Windows İşlem Etkinleştirme Hizmeti'ni (WAS) durdurun ve ardından World Wide Web Yayımlama Hizmeti'ni (W3SVC) ve bağımlı hizmetleri yeniden başlatın. Yükseltilmiş bir komut kabuğunda aşağıdaki komutları yürütebilirsiniz:

net stop was /y
net start w3svc

Modül sürümü ve Barındırma Paketi yükleyici günlükleri

Yüklü ASP.NET Çekirdek Modülünün sürümünü belirlemek için:

1. Barındırma sisteminde %PROGRAMFILES%\IIS\Asp.Net Core Module\V2 adresine gidin.
2. aspnetcorev2.dll Dosyayı bulun.
3. Dosyaya sağ tıklayın ve bağlam menüsünden Özellikler'i seçin.
4. Ayrıntılar sekmesini seçin. Dosya sürümü ve Ürün sürümü, modülün yüklü sürümünü temsil edilir.

Modülün Barındırma Paketi yükleyici günlükleri adresinde C:\Users\%UserName%\AppData\Local\Tempbulunur. Dosya olarak adlandırılır dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, burada yer tutucu {TIMESTAMP} dosyanın zaman damgasıdır.