ModuleAction クラス
構成ファイルの <modules> セクション内のモジュール エントリを表します。
構文
class ModuleAction : CollectionElement
メソッド
このクラスにはメソッドが含まれていません。
プロパティ
次の表は、ModuleAction クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
Name |
モジュールの名前を含む、必須かつ一意の読み取り/書き込みの string 値。 キー プロパティ。 |
PreCondition |
読み込むモジュールの前提条件を表す値のコンマ区切りのリストを含む、読み取り/書き込みの string 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
Type |
マネージド モジュールの種類を指定する、読み取り/書き込みの string 値。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
このクラスのインスタンスは、ModulesSection クラスの Modules プロパティに含まれています。
次の表に、PreCondition プロパティとして使用できる値の一覧を示します。 integratedMode 設定と ISAPIMode 設定は同時に指定できません。 既定値は、null です。
| Value | 説明 |
|---|---|
bitness32 |
IIS は、32 ビット ワーカー プロセスでモジュールを読み込みます。 この設定は、64 ビット オペレーティング システムにのみ適用されます。 |
bitness64 |
IIS は、64 ビット ワーカー プロセスでモジュールを読み込みます。 この設定は、64 ビット オペレーティング システムにのみ適用されます。 |
integratedMode |
IIS は、統合モードで実行されるアプリケーション プールに対してのみモジュールを読み込みます。 |
ISAPIMode |
IIS は、ISAPI モードで実行されるアプリケーション プールに対してのみモジュールを読み込みます。 |
runtimeVersion |
IIS は、指定した .NET Framework バージョンを使用するアプリケーション プールに対してのみモジュールを読み込みます。 この前提条件を有効にするには、文字列 "runtimeVersion" に v<メジャー バージョン>.<マイナー バージョン> という形式の文字列を追加します (例: "runtimeVersionv2.0")。 |
managedHandler |
IIS は、要求がマネージド ハンドラーにマップされる場合にのみモジュールを読み込みます。 この設定では、静的ファイルが要求ごとにマネージド モジュールを使用できないようにすることで、パフォーマンスを最適化できます。 |
例
次の例は、ルートの Web.config ファイルにマネージド モジュールを追加します。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Get the modules section.
Set oModulesSection = _
oWebAdmin.Get("ModulesSection.Path=" & _
"'MACHINE/WEBROOT/APPHOST/Default Web Site',Location=''")
' Get the ModuleAction class.
Set oModuleAction = oWebAdmin.Get( "ModuleAction" )
' Spawn a new instance of the ModuleAction class.
Set oNewModule = oModuleAction.SpawnInstance_
' Assign values to the new module's Name and Type properties.
oNewModule.Name = "myNewModule2"
oNewModule.Type = "System.Web.Profile.ProfileModule2"
' Call the ModulesSection.Add method to add the new module.
' If the module entry already exists, the error "Cannot create a file
' when that file already exists." will be displayed.
oModulesSection.Add "Modules", oNewModule
' Alert user when done.
WScript.Echo "Done!"
継承階層
ModuleAction
要件
| 型 | 説明 |
|---|---|
| クライアント | - 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 |
参照
CollectionElement クラス
GlobalModuleElement クラス
GlobalModulesSection クラス
ModulesSection クラス