Поделиться через

Файловая система файловой системы <WebDAV>

  • Статья

Общие сведения

Элемент <fileSystem><authoring> элемента указывает, как модуль WebDAV взаимодействует с базовой файловой системой. В частности, элемент содержит атрибуты, <fileSystem> определяющие, должны ли операции с файлами быть транзакционными и будут ли скрытые файлы или виртуальные каталоги возвращаться в запросах свойств, которые обычно используются для списков каталогов.

Совместимость

Версия Примечания
IIS 10.0 Элемент <fileSystem> не был изменен в IIS 10.0.
IIS 8,5 Элемент <fileSystem> не был изменен в IIS 8.5.
IIS 8,0 Элемент <fileSystem> не был изменен в IIS 8.0.
IIS 7,5 Элемент <fileSystem> входит в <authoring> состав iis 7.5.
IIS 7.0 Элемент <fileSystem><authoring> элемента появился в WebDAV 7.0, который был отдельной загрузкой для IIS 7.0.
IIS 6,0 Н/Д

Примечание

Модули WebDAV 7.0 и WebDAV 7.5 поставляются внеполосно для IIS 7.0, что требует скачивания и установки модулей по следующему URL-адресу:

https://www.iis.net/expand/WebDAV

В Windows 7 и Windows Server 2008 R2 модуль WebDAV 7.5 поставляется в качестве функции для IIS 7.5, поэтому скачивание WebDAV больше не требуется.

Настройка

Для поддержки публикации WebDAV для веб-сервера необходимо установить модуль WebDAV. Для этого выполните следующие действия.

Windows Server 2012 или Windows Server 2012 R2

  1. На панели задач щелкните Диспетчер сервера.
  2. В диспетчер сервера откройте меню Управление и выберите пункт Добавить роли и компоненты.
  3. В мастере добавления ролей и компонентов нажмите кнопку Далее. Выберите тип установки и нажмите кнопку Далее. Выберите целевой сервер и нажмите кнопку Далее.
  4. На странице Роли сервера разверните узел Веб-сервер (IIS),веб-сервер, узел Общие функции HTTP, а затем выберите Публикация WebDAV. Щелкните Далее.
    Снимок экрана: область
  5. На странице Выбор компонентов нажмите кнопку Далее.
  6. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  7. На странице Результаты нажмите кнопку Закрыть.

Windows 8 или Windows 8.1

  1. На начальном экране переместите указатель в левый нижний угол, щелкните правой кнопкой мыши кнопку Пуск и выберите пункт панель управления.
  2. В панель управления щелкните Программы и компоненты, а затем — Включить или выключить компоненты Windows.
  3. Разверните узел Службы IIS, Веб-службы, Общие функции HTTP, а затем выберите Публикация WebDAV.
    Снимок экрана: панель
  4. Нажмите кнопку ОК.
  5. Щелкните Закрыть.

Windows Server 2008 R2

  1. На панели задач нажмите кнопку Пуск, наведите указатель мыши на пункт Администрирование, а затем щелкните диспетчер сервера.
  2. В области иерархии диспетчер сервера разверните узел Роли, а затем щелкните Веб-сервер (IIS) .
  3. В области Веб-сервер (IIS) прокрутите страницу до раздела Службы ролей и щелкните Добавить службы ролей.
  4. На странице Выбор служб ролеймастера добавления служб ролей разверните узел Общие функции HTTP, выберите Публикация WebDAV и нажмите кнопку Далее.
    Снимок экрана: страница
  5. На странице Подтверждение выбранных элементов для установки нажмите кнопку Установить.
  6. На странице Результаты нажмите кнопку Закрыть.

Windows 7

  1. На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
  2. В панель управления щелкните Программы и компоненты, а затем — Включить или отключить компоненты Windows.
  3. Разверните узел Службы IIS, затем Службы Интернета, а затем Общие функции HTTP.
  4. Выберите WebDAV Publishing (Публикация WebDAV) и нажмите кнопку ОК.
    Снимок экрана: развернутая область

Windows Server 2008 или Windows Vista

Инструкции

Как разрешить вывод скрытых файлов в ответы WebDAV

  1. Откройте диспетчер служб IIS.

    • Если вы используете Windows Server 2012 или Windows Server 2012 R2:

      • На панели задач щелкните диспетчер сервера, инструменты, а затем диспетчер служб IIS.

    • Если вы используете Windows 8 или Windows 8.1:

      • Удерживая нажатой клавишу Windows, нажмите букву X и щелкните панель управления.
      • Щелкните Администрирование, а затем дважды щелкните диспетчер служб IIS.

    • Если вы используете Windows Server 2008 или Windows Server 2008 R2:

      • На панели задач нажмите кнопку Пуск, наведите указатель на пункт Администрирование, а затем щелкните Диспетчер служб IIS.

    • Если вы используете Windows Vista или Windows 7:

      • На панели задач нажмите кнопку Пуск, а затем выберите пункт панель управления.
      • Дважды щелкните элемент Администрирование, а затем дважды щелкните диспетчер служб IIS.

  2. В области Подключения разверните имя сервера, а затем перейдите к сайту, приложению или каталогу, в котором требуется включить публикацию WebDAV.

  3. На панели Главная дважды щелкните WebDAV Authoring Rules.
    Снимок экрана: функция правил разработки веб-dav в домашней области. Параметры веб-dav отображаются в области Действия.

  4. В области Действия щелкните Параметры WebDAV...

  5. В области Параметры WebDAV выберите Значение True для параметра Разрешить вывод скрытых файлов в список , если требуется, чтобы свойства скрытых файлов возвращались в ответах на свойства. в противном случае выберите False.
    Снимок экрана: панель параметров веб-dav с параметром

  6. Щелкните Применить в области Действия.

Конфигурация

Элемент <fileSystem> можно настроить только на уровне сайта в файле ApplicationHost.config. Любые <fileSystem> элементы на других уровнях или в Web.config файлах игнорируются.

Атрибуты

Атрибут Описание
allowHiddenFiles Необязательный атрибут типа Boolean . Значение true , если WebDAV будет отображать скрытые файлы в ответах на запросы свойств; в противном случае — false.

Примечание: Несмотря на то, что файлы могут быть скрыты в запросах свойств, их можно запрашивать напрямую. Например, если вы скрыли файл Web.config для веб-сайта, он не будет отображаться в списках каталогов, но вы все равно можете открыть файл в редакторе на основе WebDAV, если вы знаете, что путь существует. Значение по умолчанию — false.
useTransactionalIo Необязательный атрибут типа Boolean . Атрибут useTransactionalIo указывает, должны ли операции с файлами быть транзакциями. Например, обработка транзакций помогает определить, каким должно быть поведение сервера, если клиент отправляет запрос MOVE для последовательности файлов, а в целевом объекте заканчивается дисковое пространство до завершения всей операции. При включенной обработке транзакций вся операция должна завершиться ошибкой. Если обработка транзакций отключена, операция будет выполнена лишь частично, а файлы будут распределены между источником и назначением.

Если задано значение false, модуль WebDAV не будет применять какую-либо форму обработки транзакций. Если задано значение true, модуль WebDAV будет применять обработку транзакций путем сбоя операции, если базовая файловая система не может выполнять транзакции. Значение по умолчанию — false.
hideChildVirtualDirectories Необязательный атрибут типа Boolean .

Значение true , если виртуальные каталоги скрыты от запросов WebDAV; в противном случае — false.

Примечание: Этот атрибут был добавлен в WebDAV 7.5 и IIS 7.5.

Значение по умолчанию — false.

Дочерние элементы

Отсутствует.

Образец конфигурации

В следующем примере приведен пример <webdav> элемента для веб-сайта по умолчанию. Этот пример очищает все существующие правила разработки, добавляет одно правило для группы администраторов, включает разработку WebDAV, указывает, что скрытые файлы разрешены, включает блокировки WebDAV и задает поставщик блокировки, включает свойства WebDAV и задает пространство имен XML по умолчанию для сопоставления свойств.

<location path="Default Web Site">
   <system.webServer>
      <webdav>
         <authoringRules defaultAccess="none" allowNonMimeMapFiles="true" defaultMimeType="text/plain">
            <clear />
            <add roles="administrators" path="*" access="Read, Write, Source" />
         </authoringRules>
         <authoring enabled="true" requireSsl="false">
            <fileSystem allowHiddenFiles="true" />
            <locks enabled="true" lockStore="webdav_simple_lock" requireLockForWriting="false" />
            <properties allowAnonymousPropfind="false" allowInfinitePropfindDepth="false" allowCustomProperties="true">
               <clear />
               <add xmlNamespace="*" propertyStore="webdav_simple_prop" />
            </properties>
         </authoring>
      </webdav>
   </system.webServer>
</location>

Пример кода

В следующих примерах параметры файловой системы WebDAV настраиваются таким образом, чтобы скрытые файлы и виртуальные каталоги возвращались в ответах на запросы свойств.

AppCmd.exe

appcmd.exe set config "Default Web Site" -section:system.webServer/webdav/authoring /fileSystem.allowHiddenFiles:"True" /fileSystem.hideChildVirtualDirectories:"True" /commit:apphost

Примечание

При использовании AppCmd.exe для настройки этих параметров для параметра apphostфиксации необходимо задать значение . Это зафиксирует параметры конфигурации в соответствующем разделе расположения в файле 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 authoringSection = config.GetSection("system.webServer/webdav/authoring", "Default Web Site");

         ConfigurationElement fileSystemElement = authoringSection.GetChildElement("fileSystem");
         fileSystemElement["allowHiddenFiles"] = true;
         fileSystemElement["hideChildVirtualDirectories"] = 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 authoringSection As ConfigurationSection = config.GetSection("system.webServer/webdav/authoring", "Default Web Site")

      Dim fileSystemElement As ConfigurationElement = authoringSection.GetChildElement("fileSystem")
      fileSystemElement("allowHiddenFiles") = True
      fileSystemElement("hideChildVirtualDirectories") = True

      serverManager.CommitChanges()
   End Sub
End Module

JavaScript

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

var authoringSection = adminManager.GetAdminSection("system.webServer/webdav/authoring", "MACHINE/WEBROOT/APPHOST/Default Web Site");
var fileSystemElement = authoringSection.ChildElements.Item("fileSystem");
fileSystemElement.Properties.Item("allowHiddenFiles").Value = true;
fileSystemElement.Properties.Item("hideChildVirtualDirectories").Value = true;

adminManager.CommitChanges();

VBScript

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

Set authoringSection = adminManager.GetAdminSection("system.webServer/webdav/authoring", "MACHINE/WEBROOT/APPHOST/Default Web Site")
Set fileSystemElement = authoringSection.ChildElements.Item("fileSystem")
fileSystemElement.Properties.Item("allowHiddenFiles").Value = True
fileSystemElement.Properties.Item("hideChildVirtualDirectories").Value = True

adminManager.CommitChanges()