Application クラス 1
IIS Web アプリケーションを表します。
構文
class Application : ConfiguredObject
メソッド
次の表に、Application
クラスによって公開されるメソッドの一覧を示します。
名前 | 説明 |
---|---|
作成 | Web アプリケーションを作成します。 |
GetSection | (ConfiguredObject から継承。) |
GetAllSections | (ConfiguredObject から継承。) |
RevertToParent | アプリケーションの 1 つまたは複数の構成値を既定値に戻します。 |
プロパティ
次の表は、Application
クラスによって公開されるプロパティの一覧です。
名前 | 説明 |
---|---|
ApplicationPool |
アプリケーションについてのアプリケーション プールの大文字と小文字を区別する名前を指定する読み取り/書き込みの string 値。 既定値は "DefaultAppPool" です。 |
EnabledProtocols |
要求でアプリケーションへのアクセスに使用できるプロトコルを指定する読み取り/書き込みの string 配列。 "HTTP" または "HTTPS" のいずれかの値を指定すると、HTTP と HTTPS の両方が有効になります。 "HTTP" も "HTTPS" も指定されていない場合、アプリケーションに対してどちらも有効になりません。 既定値は "HTTP" です。 HTTPS 要求のみを受け入れるには、サイトの Secure Sockets Layer (SSL) 機能を構成します。 |
Path |
ホスト ヘッダーの後のアプリケーションの仮想パスを指定する読み取り専用の string 値。 たとえば、http://www.alpineskihouse.com/Skis/Downhill にアプリケーションがある場合、Path プロパティは /Skis/Downhill です。 キー プロパティ。 |
SiteName |
Web サイトの一意の名前を指定する読み取り専用の string 値。 キー プロパティ。 |
VirtualDirectoryDefaults |
VirtualDirectoryElementDefaults オブジェクト。そのオブジェクトの読み取り/書き込みプロパティは、アプリケーションの仮想ディレクトリの既定値を指定します。 |
サブクラス
このクラスにはサブクラスが含まれていません。
解説
Web アプリケーションとは、Web サイトをルート レベルでコンテンツにグループ化したもの、または Web サイトのルート ディレクトリの下の別のフォルダーにコンテンツをグループ化したものです。 Application
クラスでは、アプリケーションを実行するアプリケーション プールなど、そのアプリケーションに固有のプロパティを指定できます。
例
次の例では、Northwind
アプリケーションを NewAppPool
という名前のアプリケーション プールに割り当てます。
' Connect to the WMI WebAdministration namespace.
Set oWebAdmin = GetObject("winmgmts:root\WebAdministration")
' Retrieve the application and display its Web site name and path.
Set oApp = oWebAdmin.Get(_
"Application.SiteName='Default Web Site',Path='/Northwind'")
WScript.Echo "Web site and path: '" & oApp.SiteName & oApp.Path & "'"
WScript.Echo "Old application pool: " & oApp. ApplicationPool
' Specify a new application pool name and save it.
' Note that the name is case-sensitive.
oApp.ApplicationPool = "NewAppPool"
oApp.Put_
' Display the new application pool name.
WScript.Echo "New application pool: " & oApp.ApplicationPool
Note
アプリケーション プールの名前では、大文字と小文字が区別されます。
IIS では、指定されたアプリケーション プールが実際に存在するかどうかが確認されません。 アプリケーション プールが存在しない場合、ユーザーは HTTP エラー 403.18 で、"The specified request cannot be executed in the application pool that is configured for this resource on the Web server." (指定された要求は、Web サーバー上のこのリソース用に構成されているアプリケーション プールで実行できません) というメッセージを受け取ります。
Web サイト内のすべてのアプリケーションの既定のアプリケーション プールを設定するには、Site クラスのApplicationDefaults
プロパティを使用します。
継承階層
Application
要件
型 | 説明 |
---|---|
クライアント | - 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 |
参照
ApplicationElementDefaults クラス
ConfiguredObject クラス
Site クラス
VirtualDirectoryElementDefaults クラス