Menambahkan Tambahkan Halaman <Inisialisasi>

2023-07-19

Gambaran Umum

Elemen <add> di bawah <applicationInitialization> elemen menentukan aplikasi yang akan diinisialisasi saat aplikasi dimulai ulang. Untuk melakukan proses inisialisasi aplikasi, IIS mengirimkan permintaan palsu ke aplikasi untuk meminta inisialisasi. Beberapa URL aplikasi dapat ditentukan dengan menggunakan beberapa <add> tag. Aplikasi ini tidak disajikan kepada pemohon. Halaman yang ditentukan oleh atribut remapManagedRequestsTo dalam <applicationInitialization> elemen akan dilayani kepada pelanggan.

Kompatibilitas

Versi	Catatan
IIS 10.0	Elemen `<add>` tidak dimodifikasi dalam IIS 10.0.
IIS 8.5	Elemen `<add>` tidak dimodifikasi dalam IIS 8.5.
IIS 8.0	Elemen ini `<add>` diperkenalkan di IIS 8.0.
IIS 7.5	T/A
IIS 7.0	T/A
IIS 6.0	T/A

Siapkan

Untuk mendukung inisialisasi aplikasi di server Web, Anda harus menginstal peran atau fitur Inisialisasi Aplikasi.

Windows Server 2012 atau Windows Server 2012 R2

Pada taskbar, klik Manajer Server.
Di Manajer Server, klik menu Kelola , lalu klik Tambahkan Peran dan Fitur.
Di wizard Tambahkan Peran dan Fitur , klik Berikutnya. Pilih jenis penginstalan dan klik Berikutnya. Pilih server tujuan dan klik Berikutnya.
Pada halaman Peran Server, perluas Server Web (IIS), perluas Server Web, perluas Pengembangan Aplikasi, lalu pilih Inisialisasi Aplikasi. Klik Berikutnya.
.
Pada halaman Pilih Fitur , klik Berikutnya.
Pada halaman Konfirmasi pilihan instalasi, klik Instal.
Pada halaman Hasil , klik Tutup.

Windows 8 atau Windows 8.1

Pada layar Mulai, pindahkan penunjuk ke sudut kiri bawah, klik kanan tombol Mulai, lalu klik Panel Kontrol.
Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan fitur Windows.
Perluas Layanan Informasi Internet, perluas World Wide Web Services, perluas Fitur Pengembangan Aplikasi, lalu pilih Inisialisasi Aplikasi.
Klik OK.
Klik Tutup.

Bagaimana Caranya

Cara mengonfigurasi inisialisasi aplikasi

Buka Pengelola Layanan Informasi Internet (IIS):
- Jika Anda menggunakan Windows Server 2012 atau yang lebih baru:
  - Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Pengelola Layanan Informasi Internet (IIS).
- Jika Anda menggunakan Windows 8 atau yang lebih baru:
  - Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
  - Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).
Di panel Koneksi , pilih server, atau perluas server, perluas Situs, lalu pilih situs.
Di panel Beranda , klik dua kali fitur Editor Konfigurasi .
Jika Anda memilih situs, pilih <nama> situs Web.config di kotak teks Dari , lalu pilih system.webServer/applicationInitialization di kotak teks Bagian .
Jika Anda memilih server, pilih system.webServer/applicationInitialization di kotak teks Bagian .
Untuk menentukan nama file statis yang akan dikembalikan selama inisialisasi, atur remapManagedRequestsTo ke nama file.
Jika Anda tidak ingin memuat modul terkelola, atur skipManagedModules ke true.
Untuk menentukan bahwa proses inisialisasi dimulai secara otomatis setiap kali aplikasi dimulai ulang, atur doAppInitAfterRestart ke true.
Untuk menentukan aplikasi atau aplikasi yang akan diinisialisasi saat aplikasi dimulai ulang, klik baris (Koleksi) lalu klik elipsis.
Di Editor Koleksi, untuk menambahkan aplikasi yang akan diinisialisasi, klik Tambahkan, klik hostName, lalu atur hostName ke nama host. Klik inisialisasiPage dan atur ke URL untuk aplikasi. Tutup kotak dialog.
Klik Terapkan di panel Tindakan .

Konfigurasi

Elemen <add> elemen dikonfigurasi <applicationInitialization> di tingkat server, situs, atau aplikasi.

Atribut

Atribut	Deskripsi
`initializationPage`	Atribut string yang diperlukan. Menentukan URL aplikasi yang akan diinisialisasi saat aplikasi dimulai ulang. Nilai defaultnya adalah `""`.
`hostName`	Atribut string opsional. Nama host yang akan digunakan dengan URL aplikasi yang disediakan dalam atribut initializationPage. Nilai defaultnya adalah `""`.

Elemen Anak

Tidak ada.

Sampel Konfigurasi

Contoh berikut menunjukkan konfigurasi inisialisasi aplikasi.

<system.webServer>
   <applicationInitialization
      doAppInitAfterRestart="true"
      skipManagedModules="true"
      remapManagedRequestsTo="filename.htm"/>
      <add initializationPage="/default.aspx" hostName="myhost"/>
   </applicationInitialization>
</system.webServer>

Kode Sampel

Contoh berikut mengonfigurasi <applicationInitialization> untuk situs.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/applicationInitialization /remapManagedRequestsTo:"HelloJoe.htm" /skipManagedModules:"True" /doAppInitAfterRestart:"True"  /commit:apphost

appcmd.exe set config "Default Web Site" -section:system.webServer/applicationInitialization /+"[initializationPage='JoesSite.htm',hostName='JoesHost']" /commit:apphost

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat menggunakan AppCmd.exe untuk mengonfigurasi pengaturan ini. Ini menerapkan pengaturan konfigurasi ke bagian lokasi yang sesuai dalam file ApplicationHost.config.

C#

using System;
using System.Text;
using Microsoft.Web.Administration;

internal static class Sample {

    private static void Main() {
        
        using(ServerManager serverManager = new ServerManager()) { 
            Configuration config = serverManager.GetApplicationHostConfiguration();
            
            ConfigurationSection applicationInitializationSection = config.GetSection("system.webServer/applicationInitialization", "Default Web Site");
            applicationInitializationSection["remapManagedRequestsTo"] = @"HelloJoe.htm";
            applicationInitializationSection["skipManagedModules"] = true;
            applicationInitializationSection["doAppInitAfterRestart"] = true;
            
            ConfigurationElementCollection applicationInitializationCollection = applicationInitializationSection.GetCollection();
            
            ConfigurationElement addElement = applicationInitializationCollection.CreateElement("add");
            addElement["initializationPage"] = @"JoesSite.htm";
            addElement["hostName"] = @"JoesHost";
            applicationInitializationCollection.Add(addElement);
            
            serverManager.CommitChanges();
        }
    }
}

VB.NET

Imports System
Imports System.Text
Imports Microsoft.Web.Administration
Module Sample
     
     Sub Main()
         Dim serverManager As ServerManager = New ServerManager
         Dim config As Configuration = serverManager.GetApplicationHostConfiguration
         Dim applicationInitializationSection As ConfigurationSection = config.GetSection("system.webServer/applicationInitialization", "Default Web Site")
         applicationInitializationSection("remapManagedRequestsTo") = "HelloJoe.htm"
         applicationInitializationSection("skipManagedModules") = true
         applicationInitializationSection("doAppInitAfterRestart") = true
         Dim applicationInitializationCollection As ConfigurationElementCollection = applicationInitializationSection.GetCollection
         Dim addElement As ConfigurationElement = applicationInitializationCollection.CreateElement("add")
         addElement("initializationPage") = "JoesSite.htm"
         addElement("hostName") = "JoesHost"
         applicationInitializationCollection.Add(addElement)
         serverManager.CommitChanges
     End Sub
 End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";

var applicationInitializationSection = adminManager.GetAdminSection("system.webServer/applicationInitialization", "MACHINE/WEBROOT/APPHOST/Default Web Site");
applicationInitializationSection.Properties.Item("remapManagedRequestsTo").Value = "HelloJoe.htm";
applicationInitializationSection.Properties.Item("skipManagedModules").Value = true;
applicationInitializationSection.Properties.Item("doAppInitAfterRestart").Value = true;

var applicationInitializationCollection = applicationInitializationSection.Collection;

var addElement = applicationInitializationCollection.CreateNewElement("add");
addElement.Properties.Item("initializationPage").Value = "JoesSite.htm";
addElement.Properties.Item("hostName").Value = "JoesHost";
applicationInitializationCollection.AddElement(addElement);

adminManager.CommitChanges();

Vbscript

Set adminManager = CreateObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"

Set applicationInitializationSection = adminManager.GetAdminSection("system.webServer/applicationInitialization", "MACHINE/WEBROOT/APPHOST/Default Web Site")
applicationInitializationSection.Properties.Item("remapManagedRequestsTo").Value = "HelloJoe.htm"
applicationInitializationSection.Properties.Item("skipManagedModules").Value = true
applicationInitializationSection.Properties.Item("doAppInitAfterRestart").Value = true

Set applicationInitializationCollection = applicationInitializationSection.Collection

Set addElement = applicationInitializationCollection.CreateNewElement("add")
addElement.Properties.Item("initializationPage").Value = "JoesSite.htm"
addElement.Properties.Item("hostName").Value = "JoesHost"
applicationInitializationCollection.AddElement(addElement)

adminManager.CommitChanges()

PowerShell

Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "remapManagedRequestsTo" -value "HelloJoe.htm"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "skipManagedModules" -value "True"
Set-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "doAppInitAfterRestart" -value "True"

Add-WebConfigurationProperty -pspath 'MACHINE/WEBROOT/APPHOST' -location 'Default Web Site' -filter "system.webServer/applicationInitialization" -name "." -value @{initializationPage='JoesSite.htm';hostName='JoesHost'}

Bagikan melalui