ConfigurationSection.SetAllowDefinition メソッド
構成セクションの allowDefinition 属性を設定します。
構文
ConfigurationSection.SetAllowDefinition(AllowDefinition)
ConfigurationSection.SetAllowDefinition(AllowDefinition);
Parameters
| 名前 | Definition |
|---|---|
AllowDefinition |
allowDefinition 属性に設定する値を指定する string 変数。 使用できる属性値の一覧は、後述の「注釈」セクションに示します。 |
戻り値
このメソッドは値を返しません。
解説
allowDefinition 属性は、特定の構成セクションに対して構成階層で値を設定できる場所を指定します。 これらの属性は、ApplicationHost.config ファイルの <configSections> セクションで指定します。
SetAllowDefinition は静的メソッドであるため、次の例のようにクラス オブジェクトを取得して呼び出す必要があります。
' Correct syntax:
Set oAnonAuth = oWebAdmin.Get("AnonymousAuthenticationSection")
oAnonAuth.SetAllowDefinition "MachineOnly"
Site クラスの具象インスタンスで SetAllowDefinition を呼び出そうとするため、次の構文は失敗します。 メソッドを呼び出すと、"SWbemObjectEx: Not found" エラーが発生します。
' Incorrect syntax:
Set oSite = oWebAdmin.Get("Site.Name='Default Web Site'")
oSite.GetSection "AnonymousAuthenticationSection", oAnonAuth
oAnonAuth.SetAllowDefinition "MachineOnly"
次の表に、allowDefinition 属性として使用できる値の一覧を示します。
| キーワード | 説明 |
|---|---|
Everywhere |
このセクションは、階層内の任意の場所に設定できます。 |
MachineOnly |
このセクションは、Machine.config ファイルでのみ設定できます。 注: Machine.config ファイルの既定の位置は %systemroot% Microsoft.NET\Framework\<version>\config\ です。 |
MachineToWebRoot |
このセクションは、Machine.config ファイルまたはルート Web.config ファイルでのみ設定できます。 注: ルート Web.config ファイルの既定の位置は %systemroot% Microsoft.NET\Framework\<version>\config\ です。 |
AppHostOnly |
このセクションは、ApplicationHost.config ファイルでのみ設定できます。 |
MachineToApplication |
このセクションは、グローバル レベルでのみ設定できます。 .NET Framework セクションの場合、グローバル レベルはルート Web.config または Machine.config ファイルです。IIS セクションの場合は、ApplicationHost.config ファイルです。アプリケーションの場合は、ルート アプリケーションの Web.config ファイルです。 |
例
次の例では、匿名認証構成セクションの allowDefinition 属性を設定します。
' Get the WebAdministration namespace.
Set oWebAdmin = GetObject( _
"winmgmts:root\WebAdministration")
' Get the AnonymousAuthenticationSection.
Set oAnonAuth = oWebAdmin.Get( _
"AnonymousAuthenticationSection")
' Set the AllowDefinition attribute.
oAnonAuth.SetAllowDefinition "MachineToApplication"
要件
| 型 | 説明 |
|---|---|
| クライアント | - 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 |
参照
AnonymousAuthenticationSection クラス
ConfigurationSection クラス
ConfigurationSection.GetAllowDefinition メソッド