File Pengaturan <Penanganan File FTP DefaultHandling>

Gambaran Umum

Elemen <fileHandling> ini digunakan untuk menentukan cara layanan FTP menangani operasi file. Misalnya, keepPartialUploads atribut mengonfigurasi apakah layanan FTP harus menyimpan file yang ditransfer sebagian, seperti ketika transfer file berakhir sebelum waktunya.

Kompatibilitas

Versi	Catatan
IIS 10.0	Elemen <fileHandling> tidak dimodifikasi di IIS 10.0.
IIS 8.5	Elemen <fileHandling> tidak dimodifikasi di IIS 8.5.
IIS 8.0	Elemen <fileHandling> tidak dimodifikasi di IIS 8.0.
IIS 7.5	Elemen <fileHandling><ftpServer> dari elemen dikirim sebagai fitur IIS 7.5.
IIS 7.0	Elemen <fileHandling><ftpServer> elemen diperkenalkan dalam FTP 7.0, yang merupakan unduhan terpisah untuk IIS 7.0.
IIS 6.0	T/A

Catatan

Layanan FTP 7.0 dan FTP 7.5 dikirim ke luar band untuk IIS 7.0, yang memerlukan pengunduhan dan penginstalan modul dari URL berikut:

https://www.iis.net/downloads/microsoft/ftp

Dengan Windows 7 dan Windows Server 2008 R2, layanan FTP 7.5 dikirim sebagai fitur untuk IIS 7.5, sehingga mengunduh layanan FTP tidak lagi diperlukan.

Siapkan

Untuk mendukung penerbitan FTP untuk server Web, Anda harus menginstal layanan FTP. 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), lalu pilih Server FTP.

   Catatan

   Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda harus memilih Ekstensibilitas FTP, selain Layanan FTP.
   

5. Klik Berikutnya, lalu pada halaman Pilih fitur , klik Berikutnya lagi.

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, lalu pilih Server FTP.

   Catatan

   Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda juga harus memilih Ekstensibilitas FTP.
   

4. Klik OK.

5. Klik Tutup.

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, perluas Server FTP.

5. Pilih Layanan FTP.

   Catatan

   Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda juga harus memilih Ekstensibilitas FTP.
   

6. Klik Berikutnya.

7. Pada halaman Konfirmasi Pilihan Penginstalan , klik Instal.

8. Pada halaman Hasil , klik Tutup.

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 Server FTP.

4. Pilih Layanan FTP.

   Catatan

   Untuk mendukung ASP. Autentikasi keanggotaan atau autentikasi Manajer IIS untuk layanan FTP, Anda juga harus memilih Ekstensibilitas FTP.
   

5. Klik OK.

Windows Server 2008 atau Windows Vista

1. Unduh paket penginstalan dari URL berikut:

   • https://www.iis.net/downloads/microsoft/ftp

2. Ikuti instruksi dalam panduan berikut untuk menginstal layanan FTP:

   • Menginstal dan Memecahkan Masalah FTP 7

Bagaimana Caranya

Cara mengonfigurasi opsi penanganan file default untuk server FTP

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 , perluas nama server, lalu klik simpul Situs .

3. Di panel Situs , klik Atur Default Situs FTP di panel Tindakan .

4. Dalam kotak dialog Default Situs FTP , perluas Penanganan File, dan tentukan opsi berikut ini:

   • Tentukan True untuk Izinkan Membaca File Saat Mengunggah jika layanan FTP harus mengizinkan akses baca ke file yang saat ini sedang diunggah; jika tidak, tentukan False.

   • Tentukan True untuk Izinkan Ganti pada Ganti nama jika layanan FTP harus mengizinkan file yang sedang diganti namanya untuk menimpa file yang ada; jika tidak, tentukan False.

   • Tentukan True untuk Simpan Unggahan Parsial jika layanan FTP harus menyimpan file yang telah diunggah sebagian; jika tidak, tentukan False.

     Catatan

     Menyimpan file yang diunggah sebagian memungkinkan klien FTP untuk menyambungkan kembali dan melanjutkan pengunggahan.
     

5. Klik OK.

Konfigurasi

Atribut

Atribut	Deskripsi
allowReadUploadsInProgress	Atribut Boolean opsional. true jika layanan FTP harus mengizinkan akses baca ke file yang saat ini sedang diunggah; jika tidak, salah. Nilai defaultnya adalah false.
allowReplaceOnRename	Atribut Boolean opsional. true jika layanan FTP harus mengizinkan file yang diganti namanya untuk menimpa file yang ada; jika tidak, salah. Nilai defaultnya adalah false.
keepPartialUploads	Atribut Boolean opsional. true jika layanan FTP harus menyimpan file yang telah diunggah sebagian; jika tidak, salah. Nilai defaultnya adalah false.

Elemen Anak

Tidak ada.

Sampel Konfigurasi

Sampel konfigurasi berikut menampilkan elemen contoh <fileHandling> untuk server yang dikonfigurasi untuk menyimpan file yang diunggah sebagian secara default.

<siteDefaults>
   <ftpServer>
      <fileHandling keepPartialUploads="false" />
   </ftpServer>
</siteDefaults>

Kode Sampel

Sampel kode berikut menunjukkan cara mengonfigurasi layanan FTP untuk menyimpan file yang diunggah sebagian secara default.

AppCmd.exe

appcmd.exe set config -section:system.applicationHost/sites /siteDefaults.ftpServer.fileHandling.keepPartialUploads:"False" /commit:apphost.ftpServer.logFile.enabled:"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 sitesSection = config.GetSection("system.applicationHost/sites");
         ConfigurationElement siteDefaultsElement = sitesSection.GetChildElement("siteDefaults");
         ConfigurationElement ftpServerElement = siteDefaultsElement.GetChildElement("ftpServer");

         ConfigurationElement fileHandlingElement = ftpServerElement.GetChildElement("fileHandling");
         fileHandlingElement["keepPartialUploads"] = false;

         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 sitesSection As ConfigurationSection = config.GetSection("system.applicationHost/sites")
      Dim siteDefaultsElement As ConfigurationElement = sitesSection.GetChildElement("siteDefaults")
      Dim ftpServerElement As ConfigurationElement = siteDefaultsElement.GetChildElement("ftpServer")

      Dim fileHandlingElement As ConfigurationElement = ftpServerElement.GetChildElement("fileHandling")
      fileHandlingElement("keepPartialUploads") = False

      serverManager.CommitChanges()
   End Sub

End Module
End Module

JavaScript

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

var sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST");
var siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults");
var ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer");

var fileHandlingElement = ftpServerElement.ChildElements.Item("fileHandling");
fileHandlingElement.Properties.Item("keepPartialUploads").Value = false;

adminManager.CommitChanges();

Vbscript

Set adminManager = createObject("Microsoft.ApplicationHost.WritableAdminManager")
adminManager.CommitPath = "MACHINE/WEBROOT/APPHOST"
Set sitesSection = adminManager.GetAdminSection("system.applicationHost/sites", "MACHINE/WEBROOT/APPHOST")
Set siteDefaultsElement = sitesSection.ChildElements.Item("siteDefaults")
Set ftpServerElement = siteDefaultsElement.ChildElements.Item("ftpServer")

Set fileHandlingElement = ftpServerElement.ChildElements.Item("fileHandling")
fileHandlingElement.Properties.Item("keepPartialUploads").Value = False

adminManager.CommitChanges()