Bagikan melalui

Sisi Server Menyertakan <serverSideInclude>

  • Artikel

Gambaran Umum

Elemen <serverSideInclude> menentukan apakah sisi server menyertakan (SSI) #exec direktifkan untuk Internet Information Services (IIS) 7.

Secara khusus, <serverSideInclude> elemen berisi atribut tunggal: ssiExecDisable. Mengatur atribut ssiExecDisable ke true akan menonaktifkan direktif #exec SSI untuk IIS 7, sehingga mencegah file SSI mengeksekusi program, skrip, atau perintah shell di server.

Kompatibilitas

Versi Catatan
IIS 10.0 Elemen <serverSideInclude> tidak dimodifikasi di IIS 10.0.
IIS 8.5 Elemen <serverSideInclude> tidak dimodifikasi di IIS 8.5.
IIS 8.0 Elemen <serverSideInclude> tidak dimodifikasi di IIS 8.0.
IIS 7.5 Elemen <serverSideInclude> tidak dimodifikasi dalam IIS 7.5.
IIS 7.0 Elemen <serverSideInclude> ini diperkenalkan di IIS 7.0.
IIS 6.0 Elemen menggantikan <serverSideInclude> properti metabase IIS 6.0 SSIExecDisable .

Catatan

Direktif cmd untuk #exec dinonaktifkan untuk file SSI di IIS 7; Anda hanya dapat menggunakan direktif cgi. Misalnya, Anda dapat menggunakan perintah berikut dengan direktif cgi :

<!--#exec cgi="/HITCOUNTER.EXE"-->

Tetapi Anda tidak dapat lagi menggunakan perintah berikut dengan direktif cmd :

<!--#exec cmd="dir /b"-->

Jika Anda mencoba menggunakan arahan cmd dalam file SSI di IIS 7, Anda akan menerima pesan kesalahan berikut:

Opsi CMD tidak diaktifkan untuk panggilan #EXEC

Siapkan

Elemen <serverSideInclude> tidak tersedia pada penginstalan default IIS 7 dan yang lebih baru. Untuk menginstalnya, 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 Sisi Server Menyertakan. Klik Berikutnya.
    Cuplikan layar Sisi Server Termasuk yang dipilih di bawah Pengembangan Aplikasi di daftar Server Web (I S) dan Server Web yang diperluas. .
  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 Sisi Server Menyertakan.
    Cuplikan layar Sisi Server Menyertakan yang dipilih dalam antarmuka Windows 8.
  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 Sisi Server Menyertakan, lalu klik Berikutnya.
    Cuplikan layar Sisi Server Termasuk yang dipilih di bawah Pengembangan Aplikasi dalam daftar Server Web yang diperluas.
  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. Perluas Layanan Informasi Internet, lalu pilih Sisi Server Termasuk, lalu klik OK.
    Cuplikan layar Sisi Server Termasuk yang dipilih di antarmuka Windows Vista atau Windows 7.

Bagaimana Caranya

Tidak ada antarmuka pengguna untuk mengonfigurasi <serverSideInclude> elemen untuk IIS 7. Untuk contoh cara mengonfigurasi <serverSideInclude> elemen secara terprogram, lihat bagian Sampel Kode dari dokumen ini.

Konfigurasi

Atribut

Atribut Deskripsi
ssiExecDisable Atribut Boolean opsional.

Menentukan apakah arahan #exec SSI diaktifkan (false) atau dinonaktifkan (true). Ketika dinonaktifkan, direktif tidak dapat menjalankan perintah program, skrip, atau shell pada server.

Nilai defaultnya adalah false.

Elemen Anak

Tidak ada.

Sampel Konfigurasi

Sampel konfigurasi berikut menonaktifkan perintah #exec untuk file SSI di Situs Web Default.

<location path="Default Web Site">
   <system.webServer>
      <serverSideInclude ssiExecDisable="true" />
   </system.webServer>
</location>

Kode Sampel

Sampel kode berikut menonaktifkan perintah #exec untuk file SSI di Situs Web Default.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/serverSideInclude /ssiExecDisable:"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 serverSideIncludeSection = config.GetSection("system.webServer/serverSideInclude", "Default Web Site");
         serverSideIncludeSection["ssiExecDisable"] = true;

         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 serverSideIncludeSection As ConfigurationSection = config.GetSection("system.webServer/serverSideInclude", "Default Web Site")
      serverSideIncludeSection("ssiExecDisable") = True

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

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

var serverSideIncludeSection = adminManager.GetAdminSection("system.webServer/serverSideInclude", "MACHINE/WEBROOT/APPHOST/Default Web Site");
serverSideIncludeSection.Properties.Item("ssiExecDisable").Value = true;

adminManager.CommitChanges();

Vbscript

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

Set serverSideIncludeSection = adminManager.GetAdminSection("system.webServer/serverSideInclude", "MACHINE/WEBROOT/APPHOST/Default Web Site")
serverSideIncludeSection.Properties.Item("ssiExecDisable").Value = True

adminManager.CommitChanges()