VirtualDirectoryElementDefaults Class1

Статья
07/19/2023

Предоставляет параметры конфигурации по умолчанию для виртуальных каталогов IIS.

Синтаксис

class VirtualDirectoryElementDefaults : EmbeddedObject

Методы

Этот класс не содержит методов.

Свойства

В следующей таблице перечислены свойства, предоставляемые классом VirtualDirectoryElementDefaults .

Имя	Описание
`AllowSubDirConfig`	Значение для чтения и записи `boolean` . `true` Если по умолчанию СЛУЖБЫ IIS ищут Web.config файлы в каталогах содержимого ниже текущего уровня; `false` Значение , если службы IIS не ищут эти файлы в каталогах ниже текущего уровня.
`LogonMethod`	Перечисление для чтения и записи `sint32` , задающее метод по умолчанию, с помощью которого пользователь локально вошел в систему. Тип входа определяет, можно ли использовать полученный маркер удаленно. Возможные значения перечислены далее в разделе Примечания.
`Password`	Значение для чтения и записи `string` , указывающее зашифрованный пароль по умолчанию для доступа к виртуальному корневому каталогу. Значение по умолчанию — `null`.
`Path`	Значение для чтения и записи `string` , содержащее путь к виртуальному каталогу по умолчанию.
`PhysicalPath`	Значение для чтения и записи `string` , указывающее физический путь по умолчанию, связанный с виртуальным каталогом.
`UserName`	Значение для чтения и записи `string` , указывающее пользователя по умолчанию, который имеет права на доступ к любым файлам конфигурации или содержимому в виртуальном каталоге. Значение по умолчанию — `null`.

используются подклассы ;

Этот класс не содержит подклассов.

В следующей таблице содержатся возможные значения и ключевые LogonMethod слова для свойства . Значение по умолчанию — 3 (ClearText). Дополнительные сведения см. в разделе Функция LogonUserEx .

Значение	Ключевое слово	Описание
0	Интерактивно	Позволяет пользователю в интерактивном режиме войти в систему с помощью сервера терминалов, удаленной оболочки или аналогичного процесса. Так как этот тип входа кэширует сведения о входе в систему для отключенных операций, производительность может быть затронута. Поэтому этот тип входа не подходит для клиентских и серверных приложений, таких как почтовые серверы.
1	Пакетная служба	Позволяет пользователю входить в систему через сервер пакетной службы, где процессы могут выполняться для пользователя без вмешательства пользователя. Этот тип входа подходит для серверов, таких как почта или веб-серверы, которые одновременно обрабатывают множество попыток проверки подлинности в виде открытого текста. Учетные данные не кэшируются для этого типа входа.
2	Сеть	Позволяет пользователю входить в систему через высокопроизводительный сервер, который проверяет подлинность паролей в виде открытого текста. Учетные данные не кэшируются для этого типа входа.
3	ClearText	Позволяет пользователю входить в систему с помощью обычной проверки подлинности. Имя пользователя и пароль сохраняются в пакете проверки подлинности, который позволяет серверу устанавливать подключения к другим сетевым серверам при олицетворении клиента. Пакет проверки подлинности — это библиотека DLL, которая инкапсулирует логику проверки подлинности, которая определяет, следует ли разрешить пользователю войти в систему. Локальный центр безопасности (LSA) проверяет подлинность входа пользователя, отправляя запрос в пакет проверки подлинности. Затем пакет проверки подлинности проверяет сведения о входе и выполняет проверку подлинности или отклоняет попытку входа пользователя.

Пример

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

' Connect to the WMI WebAdministration namespace.  
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")  
  
' Get the default Web site.  
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")  
  
' Set the virtual directory defaults on the Web site.  
oSite.VirtualDirectoryDefaults.UserName = "JohnV"  
oSite.VirtualDirectoryDefaults.Password = "p@ssw0rd."  
oSite.Put_  
  
' List all the virtual directory defaults for the Web site.  
WScript.Echo "AllowSubDirConfig: " & _  
    oSite.VirtualDirectoryDefaults.AllowSubDirConfig  
WScript.Echo "LogonMethod: " & _  
    GetLogonMethodText(oSite.VirtualDirectoryDefaults.LogonMethod)  
WScript.Echo "Password: " & oSite.VirtualDirectoryDefaults.Password  
WScript.Echo "Path: " & oSite.VirtualDirectoryDefaults.Path  
WScript.Echo "PhysicalPath: " & _  
    oSite.VirtualDirectoryDefaults.PhysicalPath  
WScript.Echo "UserName: " & oSite.VirtualDirectoryDefaults.UserName  
  
' This helper function converts the LogonMethod value to text.  
Function GetLogonMethodText(LogonMethodValue)  
    Select Case LogonMethodValue  
        Case 0  
            GetLogonMethodText = "Interactive"  
        Case 1  
            GetLogonMethodText = "Batch"  
        Case 2  
            GetLogonMethodText = "Network"  
        Case 3  
            GetLogonMethodText = "ClearText"  
        Case Else  
            GetLogonMethodText = "Unknown logon method."  
    End Select  
End Function

Иерархия наследования

EmbeddedObject

VirtualDirectoryElementDefaults

Требования

Тип	Описание
клиент	— IIS 7.0 в Windows Vista — IIS 7.5 в Windows 7 — IIS 8.0 в Windows 8 — IIS 10.0 в Windows 10
Сервер	— IIS 7.0 в Windows Server 2008 — IIS 7.5 в Windows Server 2008 R2 — IIS 8.0 в Windows Server 2012 — IIS 8.5 в Windows Server 2012 R2 — IIS 10.0 в Windows Server 2016
Продукт	— IIS 7.0, IIS 7.5, IIS 8.0, IIS 8.5, IIS 10.0
MOF-файл	WebAdministration.mof

См. также:

Класс приложения
Класс EmbeddedObject
Класс Server
Класс сайта
Класс VirtualDirectory
LogonUserEx

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