SectionInformation クラス
構成セクションのオーバーライド モードとコントロール ロック設定を指定します。
構文
class SectionInformation : EmbeddedObject
メソッド
このクラスにはメソッドが含まれていません。
プロパティ
次の表は、SectionInformation クラスによって公開されるプロパティの一覧です。
| 名前 | 説明 |
|---|---|
EffectiveOverrideMode |
現在の構成セクションが継承された設定を効果的にオーバーライドできるかどうかを指定する読み取り専用 string の値。 使用できる値の一覧は、後述の「注釈」セクションに示します。EffectiveOverrideMode の値を決定するために、IIS は現在のセクションから構成セクションの継承階層をたどります。 セクション スキーマ定義の overrideModeDefault 属性に到達するまで、各親セクションの OverrideMode プロパティを連続して検査します。 IIS は、検出された値を論理的に結合し、その階層的順位を考慮して EffectiveOverrideMode を計算します。 注: overrideModeDefault は、構成セクションの既定のロックダウン状態を含む省略可能な属性です。 各構成セクションの overrideModeDefault 属性は、ApplicationHost.config ファイルの <configSections> の下にある対応するセクション定義にあります。 overrideModeDefault が不足している場合、その値は "Allow" です。 "許可" が指定されている場合、下位レベルの Web.config ファイルはセクションの設定をオーバーライドできます。"Deny" が指定されている場合は、拒否できません。 overrideModeDefaultほとんどの IIS Web サーバー セクションの既定値は "拒否" です。 ほとんどの ASP.NET および .NET Framework セクションの既定値は "許可" です。これらのセクションにはアプリケーション レベルの設定が含まれているためです。 overrideModeDefault 属性には、WMI に対応するプロパティがありません。 適切なアクセス許可がある場合は、ApplicationHost.config ファイルを直接編集するか、XML 解析 API またはファイル アクセス API を使用してプログラムでアクセスできます。 |
IsLocked |
読み取り専用の boolean 値です。 現在の構成セクションとその子要素を変更できない場合は true、それ以外の場合は false です。 |
LockItem |
読み取り/書き込みの boolean 値。 現在の構成セクションとその子要素がロックされている場合は true、それ以外の場合は false です。 既定値は、false です。 注: 既定値は false ですが、最初に読み取られたときにこのプロパティは null を返します。 この初期値 を false に明示的に設定すると、プロパティは引き続き null を返します。 ただし、初期値を true に設定すると、プロパティは true を返します。その後、値を false に設定すると、プロパティは明示的に false を返します。 この動作は、WMI プロバイダーの制限によるものです。 |
OverrideMode |
下位レベルの構成ファイルが現在の構成セクションの設定をオーバーライドできるかどうかを指定する読み取り/書き込み string 値。 使用できる値の一覧は、後述の「注釈」セクションに示します。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
このクラスのインスタンスは、ConfigurationSection クラスの SectionInformation プロパティに含まれています。 すべての構成セクション クラスは、SectionInformation クラスをプロパティの 1 つとして継承します。
次の表に、EffectiveOverrideMode プロパティとして使用できる値の一覧を示します。
| キーワード | 説明 |
|---|---|
Allow |
下位レベルの構成ファイルは、現在の構成セクションの設定をオーバーライドできます。 |
Deny |
下位レベルの構成ファイルは、現在の構成セクションの設定をオーバーライドできません。 |
次の表に、OverrideMode プロパティとして使用できる値の一覧を示します。 既定値は "Inherit" です。
| キーワード | 説明 |
|---|---|
Inherit |
下位レベルの構成ファイルは、継承する OverrideMode 値の組み合わせに応じて、現在の構成セクションの設定をオーバーライドできるかどうかが決まります。 |
Allow |
下位レベルの構成ファイルは、現在の構成セクションの設定をオーバーライドできます。 |
Deny |
下位レベルの構成ファイルは、現在の構成セクションの設定をオーバーライドできません。 |
Note
EffectiveOverrideMode プロパティは、OverrideMode プロパティが "継承" に設定されている場合に、構成セクションの有効なオーバーライド モードを決定する際に役立ちます。
例
次の例では、すべての構成セクションの SectionInformation プロパティを取得します。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Retrieve configuration sections.
Set oConfigSections = oWebAdmin.ExecQuery( _
"SELECT * FROM ConfigurationSection")
' Loop through the configuration sections.
For Each oConfigSection In oConfigSections
iCounter = iCounter + 1
' Display the name of each configuration section and its location.
WScript.Echo "[" & iCounter & "] " & oConfigSection.Path_.Class
WScript.Echo "Location: " & oConfigSection.Location
' Display the SectionInformation property values.
Set oConfigSectionInfo = oConfigSection.SectionInformation
WScript.Echo "Effective Override Mode: " & _
oConfigSectionInfo.EffectiveOverrideMode
WScript.Echo "Is Locked: " & oConfigSectionInfo.IsLocked
WScript.Echo "Is Present: " & oConfigSectionInfo.IsPresent
WScript.Echo "Lock Item: " & oConfigSectionInfo.LockItem
WScript.Echo "Override Mode: " & oConfigSectionInfo.OverrideMode
WScript.Echo "------------------------------------------"
Next
継承階層
SectionInformation
要件
| 型 | 説明 |
|---|---|
| クライアント | - 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 |