VirtualDirectoryElementDefaults Class1

IIS 仮想ディレクトリの既定の構成設定を公開します。

構文

class VirtualDirectoryElementDefaults : EmbeddedObject  

メソッド

このクラスにはメソッドが含まれていません。

プロパティ

次の表は、VirtualDirectoryElementDefaults クラスによって公開されるプロパティの一覧です。

名前	説明
AllowSubDirConfig	読み取り/書き込みの boolean 値。 デフォルトで IIS が現在のレベルより下のコンテンツ ディレクトリで Web.config ファイルを検索する場合は true、IIS が現在のレベルより下のディレクトリでこれらのファイルを検索しない場合は false です。
LogonMethod	ユーザーがローカルにログオンする既定のメソッドを指定する読み取り/書き込み sint32 列挙型。 ログオンの種類によって、結果のトークンをリモートで使用できるかどうかが決まります。 使用できる値の一覧は、後述の「注釈」セクションに示します。
Password	仮想ルート ディレクトリにアクセスするための既定の暗号化パスワードを指定する読み取り/書き込み string 値。 既定値は、null です。
Path	既定の仮想ディレクトリ パスを含む読み取り/書き込み string 値。
PhysicalPath	仮想ディレクトリに関連付けられている既定の物理パスを指定する読み取り/書き込み string 値。
UserName	仮想ディレクトリ内の構成ファイルまたはコンテンツにアクセスする権限を持つ既定のユーザーを指定する読み取り/書き込み string 値。 既定値は、null です。

サブクラス

このクラスにはサブクラスが含まれていません。

解説

このクラスのインスタンスは、Server、Site、および Application クラスの VirtualDirectoryDefaults プロパティに含まれています。

次の表に、LogonMethod プロパティに設定可能な値とキーワードを示します。 既定値は 3 (ClearText) です。 詳細については、LogonUserEx 関数を参照してください。

Value	キーワード	説明
0	Interactive	ユーザーがターミナル サーバー、リモート シェル、または同様のプロセスを介して対話形式でログオンできるようにします。 このログオンの種類は、切断された操作のログオン情報をキャッシュするため、パフォーマンスが影響を受ける可能性があります。 そのため、このログオンの種類は、メール サーバーなどのクライアント/サーバー アプリケーションには不適切です。
1	Batch	ユーザーがバッチ サーバー経由でログオンできるようにします。バッチ サーバーでは、ユーザーの介入なしにユーザーに対してプロセスを実行できます。 このログオンの種類は、一度に多数のプレーンテキスト認証試行を処理するサーバー (メールサーバーや Web サーバーなど) に適しています。 このログオンの種類の資格情報はキャッシュされません。
2	ネットワーク	ユーザーがプレーンテキスト パスワードを認証する高パフォーマンス サーバー経由でログオンできるようにします。 このログオンの種類の資格情報はキャッシュされません。
3	ClearText	ユーザーが基本認証を使用してログオンできるようにします。 ユーザーの名前とパスワードは認証パッケージに保存されるため、サーバーはクライアントになりすまして他のネットワーク サーバーに接続できます。 認証パッケージは、ユーザーにログオンを許可するかどうかを決定する認証ロジックをカプセル化する DLL です。 ローカル セキュリティ機関 (LSA) は、認証パッケージに要求を送信してユーザー ログオンを認証します。 その後、認証パッケージはログオン情報を調べ、ユーザーのログオン試行を認証または拒否します。

例

次の例は、Web サイト上のすべての仮想ディレクトリのユーザー名とパスワードを設定する方法を示しています。 次に、サイトのすべての仮想ディレクトリの既定値を取得する方法を示します。

' 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

要件

型	説明
クライアント	- Windows Vista 上の IIS 7.0 - Windows 7 上の IIS 7.5 - Windows 8 上の IIS 8.0 - Windows 10 上の IIS 10.0
[サーバー]	- Windows Server 2008 上の IIS 7.0 - Windows Server 2008 R2 上の IIS 7.5 - Windows Server 2012 上の IIS 8.0 - Windows Server 2012 R2 上の IIS 8.5 - Windows Server 2016 上の IIS 10.0
Product	- IIS 7.0、IIS 7.5、IIS 8.0、IIS 8.5、IIS 10.0
MOF ファイル	WebAdministration.mof

参照

Application クラス
EmbeddedObject クラス
Server クラス
Site クラス
VirtualDirectory クラス
LogonUserEx