Filter <ISAPI isapiFilters>

Gambaran Umum

Elemen ini <isapiFilters> memungkinkan Anda mengelola filter ISAPI di server Internet Information Services (IIS) 7 Anda. Anda dapat menambahkan filter ISAPI saat Anda ingin meningkatkan fungsionalitas server Web. Misalnya, Anda mungkin memiliki filter ISAPI yang mengambil informasi tentang permintaan HTTP dan menyimpan informasi ke database.

Catatan

Meskipun IIS 7 mendukung filter ISAPI, Microsoft menyarankan agar Anda memperluas fungsionalitas server Web dengan menggunakan modul alih-alih dengan menggunakan filter ISAPI.

Elemen <isapiFilters> dapat berisi satu atau beberapa <filter> elemen, yang masing-masing menentukan filter ISAPI yang diaktifkan untuk server atau situs Web Anda. Ini juga dapat berisi <remove> elemen , yang dapat Anda gunakan untuk menghapus filter ISAPI tertentu yang diwarisi dari yang lebih tinggi dalam hierarki konfigurasi. Elemen <isapiFilters> ini juga dapat berisi <clear> elemen , yang menghapus semua filter ISAPI yang diwarisi dari yang lebih tinggi dalam hierarki konfigurasi.

Kompatibilitas

Versi	Catatan
IIS 10.0	Elemen <isapiFilters> tidak dimodifikasi di IIS 10.0.
IIS 8.5	Elemen <isapiFilters> tidak dimodifikasi di IIS 8.5.
IIS 8.0	Elemen <isapiFilters> tidak dimodifikasi di IIS 8.0.
IIS 7.5	Elemen <isapiFilters> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0	Elemen <isapiFilters> ini diperkenalkan di IIS 7.0.
IIS 6.0	Elemen menggantikan <isapiFilters> properti metabase FilterEnableCache dan FilterPath IIS 6.0.

Siapkan

Untuk menggunakan elemen , <isapiFilters> Anda harus menginstal modul Filter ISAPI di server IIS 7 dan yang lebih baru. Untuk melakukannya, gunakan langkah-langkah berikut.

Windows Server 2012 atau Windows Server 2012 R2

1. Pada taskbar, klik Manajer Server.
2. Di Manajer Server, klik menu Kelola , lalu klik Tambahkan Peran dan Fitur.
3. Di wizard Tambahkan Peran dan Fitur , klik Berikutnya. Pilih jenis penginstalan dan klik Berikutnya. Pilih server tujuan dan klik Berikutnya.
4. Pada halaman Peran Server , perluas Server Web (IIS), perluas Server Web, perluas Pengembangan Aplikasi, lalu pilih Filter ISAPI. Klik Berikutnya.
   .
5. Pada halaman Pilih fitur, klik Berikutnya.
6. Pada halaman Konfirmasi pilihan instalasi, klik Instal.
7. Pada halaman Hasil , klik Tutup.

Windows 8 atau Windows 8.1

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

Windows Server 2008 atau Windows Server 2008 R2

1. Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Server.
2. Di panel hierarki Manajer Server , perluas Peran, lalu klik Server Web (IIS).
3. Di panel Server Web (IIS), gulir ke bagian Layanan Peran , lalu klik Tambahkan Layanan Peran.
4. Pada halaman Pilih Layanan Peran dari Wizard Tambahkan Layanan Peran, pilih Filter ISAPI, lalu klik Berikutnya.
   
5. Pada halaman Konfirmasi Pilihan Penginstalan , klik Instal.
6. Pada halaman Hasil , klik Tutup.

Windows Vista atau Windows 7

1. Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
2. Di Panel Kontrol, klik Program dan Fitur, lalu klik Aktifkan atau nonaktifkan Fitur Windows.
3. Dalam kotak dialog Fitur Windows , perluas Layanan Informasi Internet, lalu Layanan World Wide Web, lalu Fitur Pengembangan Aplikasi.
   
4. Pilih Filter ISAPI, lalu klik OK.

Bagaimana Caranya

Cara menambahkan filter ISAPI

1. Buka Manajer Layanan Informasi Internet (IIS):

   • Jika Anda menggunakan Windows Server 2012 atau Windows Server 2012 R2:

     • Pada bilah tugas, klik Manajer Server, klik Alat, lalu klik Manajer Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows 8 atau Windows 8.1:

     • Tahan tombol Windows, tekan huruf X, lalu klik Panel Kontrol.
     • Klik Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows Server 2008 atau Windows Server 2008 R2:

     • Pada taskbar, klik Mulai, arahkan ke Alat Administratif, lalu klik Manajer Layanan Informasi Internet (IIS).

   • Jika Anda menggunakan Windows Vista atau Windows 7:

     • Pada taskbar, klik Mulai, lalu klik Panel Kontrol.
     • Klik dua kali Alat Administratif, lalu klik dua kali Manajer Layanan Informasi Internet (IIS).

2. Di panel Koneksi , buka koneksi atau situs yang ingin Anda konfigurasi filter ISAPI-nya.

3. Di panel Beranda , klik dua kali Filter ISAPI.
   

4. Di panel Tindakan , klik Tambahkan...

5. Dalam kotak teks Filter nama dari kotak dialog Tambahkan Filter ISAPI , ketik nama yang mudah diingat untuk filter ISAPI.

6. Dalam kotak Dapat Dieksekusi , ketik jalur sistem file lokasi file filter ISAPI atau klik elipsis (...) untuk menavigasi ke folder yang berisi file filter ISAPI, lalu klik OK.
   

Konfigurasi

Anda dapat menambahkan filter ISAPI di tingkat server dan tingkat situs. Jika Anda menambahkan filter ISAPI di tingkat server, filter akan mencegat semua permintaan yang dibuat ke server. Jika Anda menambahkan filter ISAPI ke situs tertentu, filter akan mencegat semua permintaan yang dibuat ke situs tersebut.

Anda dapat mengonfigurasi <isapiFilters> elemen di tingkat server dalam file ApplicationHost.config atau di tingkat situs dalam file Web.config yang sesuai.

Atribut

Tidak ada.

Elemen Anak

Elemen	Deskripsi
clear	Elemen opsional. Menghapus semua referensi ke filter ISAPI dari koleksi filter ISAPI.
filter	Elemen opsional. Menambahkan filter ISAPI ke koleksi filter ISAPI.
remove	Elemen opsional. Menghapus referensi ke filter ISAPI dari kumpulan filter ISAPI.

Sampel Konfigurasi

Contoh konfigurasi berikut menambahkan filter ISAPI bernama SalesQueryIsapi ke situs web atau aplikasi. Contoh nama dan mengaktifkan filter ISAPI dengan nama dan atribut yang diaktifkan . Ini juga menggunakan atribut enableCache untuk menonaktifkan penembolokan HTTP.sys dan atribut jalur untuk menentukan lokasi ISAPI DLL.

<configuration>
   <system.webServer>
      <isapiFilters>
         <filter 
            name="SalesFilter" 
            enabled="true" 
            enableCache="false" 
            path="C:\Inetpub\filters\SalesFilter.dll" />
      </isapiFilters>
   </system.webServer>
</configuration>

Kode Sampel

Contoh berikut mengonfigurasi filter ISAPI bernama SalesQueryIsapi di server. Setiap contoh menggunakan properti nama untuk menentukan nama untuk filter ISAPI, properti enableCache untuk menonaktifkan penembolokan HTTP.sys, dan properti jalur untuk menentukan lokasi ISAPI DLL.

AppCmd.exe

appcmd.exe set config -section:system.webServer/isapiFilters /+"[name='SalesQueryIsapi',path='c:\Inetpub\www.contoso.com\filters\SalesQueryIsapi.dll',enabled='True',enableCache='True']" /commit:apphost

Catatan

Anda harus memastikan untuk mengatur parameter penerapan ke apphost saat Anda 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 isapiFiltersSection = config.GetSection("system.webServer/isapiFilters");
         ConfigurationElementCollection isapiFiltersCollection = isapiFiltersSection.GetCollection();

         ConfigurationElement filterElement = isapiFiltersCollection.CreateElement("filter");
         filterElement["name"] = @"SalesQueryIsapi";
         filterElement["path"] = @"c:\Inetpub\www.contoso.com\filters\SalesQueryIsapi.dll";
         filterElement["enabled"] = true;
         filterElement["enableCache"] = true;
         isapiFiltersCollection.Add(filterElement);

         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 isapiFiltersSection As ConfigurationSection = config.GetSection("system.webServer/isapiFilters")
      Dim isapiFiltersCollection As ConfigurationElementCollection = isapiFiltersSection.GetCollection
      Dim filterElement As ConfigurationElement = isapiFiltersCollection.CreateElement("filter")
      filterElement("name") = "SalesQueryIsapi"
      filterElement("path") = "c:\Inetpub\www.contoso.com\filters\SalesQueryIsapi.dll"
      filterElement("enabled") = True
      filterElement("enableCache") = True
      isapiFiltersCollection.Add(filterElement)
      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

var adminManager = new ActiveXObject('Microsoft.ApplicationHost.WritableAdminManager');
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST";
var isapiFiltersSection = adminManager.GetAdminSection("system.webServer/isapiFilters", "MACHINE/WEBROOT/APPHOST");
var isapiFiltersCollection = isapiFiltersSection.Collection;

var filterElement = isapiFiltersCollection.CreateNewElement("filter");
filterElement.Properties.Item("name").Value = "SalesQueryIsapi";
filterElement.Properties.Item("path").Value = "c:\\Inetpub\\www.contoso.com\\filters\\SalesQueryIsapi.dll";
filterElement.Properties.Item("enabled").Value = true;
filterElement.Properties.Item("enableCache").Value = true;
isapiFiltersCollection.AddElement(filterElement);

adminManager.CommitChanges();

Vbscript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set isapiFiltersSection = adminManager.GetAdminSection("system.webServer/isapiFilters", "MACHINE/WEBROOT/APPHOST")
Set isapiFiltersCollection = isapiFiltersSection.Collection

Set filterElement = isapiFiltersCollection.CreateNewElement("filter")
filterElement.Properties.Item("name").Value = "SalesQueryIsapi"
filterElement.Properties.Item("path").Value = "c:\\Inetpub\\www.contoso.com\\filters\\SalesQueryIsapi.dll"
filterElement.Properties.Item("enabled").Value = True
filterElement.Properties.Item("enableCache").Value = True
isapiFiltersCollection.AddElement filterElement

adminManager.CommitChanges()