アプリケーション コレクション
ローカル コンピューターにインストールされている COM+ アプリケーションごとに 1 つのオブジェクトが含まれます。 これらのオブジェクトによって公開されるプロパティは、アプリケーション レベルで行われたすべての設定を保持します。
関連する Components コレクションを使用して、アプリケーション内の コンポーネント のプロパティを設定します。 関連する Roles コレクションを使用して、アプリケーションに ロール を割り当てます。
アプリケーションにコンポーネントをインストールするには、 COMAdminCatalog オブジェクトのメソッドを使用します。 ファイルからアプリケーションをインストールしたり、アプリケーションをシャットダウンまたはエクスポートしたりするには、 COMAdminCatalog オブジェクトの メソッドも使用します。 それ以外の場合は、新しいアプリケーションを作成するために、 Applications コレクションに オブジェクトを追加できます。
このコレクションは、COMAdminCatalogCollection オブジェクトの Add メソッドと Remove メソッドをサポートしています。
メンバー
Applications コレクションは IUnknown インターフェイスから継承されますが、追加のメンバーはありません。
関連コレクション
このコレクションから次のいずれかのコレクションに移動できます。
このコレクションには、次のコレクションから移動できます。
プロパティ
次のプロパティは、コレクション内の COMAdminCatalogObject オブジェクトでサポートされています。
- 3GigSupportEnabled
- AccessChecksLevel
- アクティブ化
- ApplicationAccessChecksEnabled
- ApplicationDirectory
- ApplicationProxy
- ApplicationProxyServerName
- AppPartitionID
- 認証
- AuthenticationCapability
- 変更可能
- CommandLine
- ConcurrentApps
- CreatedBy
- CRMEnabled
- CRMLogFile
- 削除可能
- 説明
- DumpEnabled
- DumpOnException
- DumpOnFailfast
- DumpPath
- EventsEnabled
- ID
- ID
- ImpersonationLevel
- IsEnabled
- IsSystem
- MaxDumpCount
- 名前
- Password
- QCAuthenticateMsgs
- QCListenerMaxThreads
- QueueListenerEnabled
- QueuingEnabled
- RecycleActivationLimit
- RecycleCallLimit
- RecycleExpirationTimeout
- RecycleLifetimeLimit
- RecycleMemoryLimit
- レプリケート
- RunForever
- ServiceName
- ShutdownAfter
- SoapActivated
- SoapBaseUrl
- SoapMailTo
- SoapVRoot
- SRPEnabled
- SRPTrustLevel
3GigSupportEnabled
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションがそのプロセスで 3 GB のメモリを使用できるかどうかを示します。 これが有効になっていない場合、アプリケーションは 2 GB のメモリのみを使用できます。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
AccessChecksLevel
| 入力 | 値 |
|---|---|
| 説明 | アクセス チェックがプロセス レベルでのみ実行されるか、プロセス レベルとコンポーネント レベルの両方で実行されるかを示します。 数値ではなく、列挙で定数を使用することをお勧めします。 |
| Access | ReadWrite |
| Type | 有効な長い値: COMAdminAccessChecksApplicationLevel (0) COMAdminAccessChecksApplicationComponentLevel (1) |
| Default | COMAdminAccessChecksApplicationComponentLevel (1) |
| 最小システム | Windows 2000 |
アクティブ化
| 入力 | 値 |
|---|---|
| 説明 | ローカル アクティブ化は、アプリケーション内のオブジェクトが専用のローカル サーバー プロセス (サーバー アプリケーション) 内で実行されることを示します。 インプロセス アクティブ化は、オブジェクトが作成者のプロセス (ライブラリ アプリケーション) で実行されることを示します。 |
| Access | ReadWrite |
| Type | Long Possible values:COMAdminActivationInproc (0)COMAdminActivationLocal (1) |
| Default | COMAdminActivationLocal (1) |
| 最小システム | Windows 2000 |
ApplicationAccessChecksEnabled
| 入力 | 値 |
|---|---|
| 説明 | クライアントが呼び出しを行うときに、アプリケーションに対してアクセス チェックを実行するかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
ApplicationDirectory
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションへの完全なパス。 この情報は、Side-by-Side (SxS) アセンブリを構成するときに必要です。 サイド バイ サイド (SxS) アセンブリを使用すると、ASP アプリケーションは、MSVCRT、MSXML、COMCTL、GDIPLUS など、使用する SxS でサポートされるシステム DLL のバージョンを指定できます。 たとえば、ASP アプリケーションが MSVCRT バージョン 2.0 に依存している場合、サービス パックがサーバーに適用された後でも、アプリケーションで MSVCRT バージョン 2.0 が引き続き使用されるようにすることができます。 MSVCRT の新しいバージョンは引き続きコンピューターにインストールされますが、バージョン 2.0 は残り、アプリケーションで使用されます。 SxS でサポートされる DLL は、%WINDIR%\WinSxS に格納されます。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows XP |
Note
この機能はアプリケーション レベルで構成できますが、任意のアプリケーション プールで使用できるシステム DLL のバージョンは 1 つだけです。 たとえば、アプリケーション App1 で MSVCRT バージョン 2.5 が使用され、アプリケーション App2 で MSVCRT バージョン 2.4 が使用されている場合、App1 と App2 は同じアプリケーション プール内にありません。 その場合、最初に読み込まれるアプリケーションには MSVCRT のバージョンが読み込まれ、他のアプリケーションはアプリケーションがアンロードされるまで強制的に使用されます。
詳細については、「 IIS 6.0 の COM+ サービスの変更」の「Side-by-Side アセンブリ」を参照してください。
ApplicationProxy
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションがアプリケーション プロキシであるかどうかを示します。 |
| Access | ReadOnly |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
ApplicationProxyServerName
| 入力 | 値 |
|---|---|
| 説明 | アプリケーション プロキシをエクスポートするときに使用されるリモート サーバー名。 これは、アプリケーション プロキシがクライアント コンピューターにインストールされるときに指すこのサーバー名です。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
AppPartitionID
| 入力 | 値 |
|---|---|
| 説明 | アプリケーション パーティション ID を表す GUID。 |
| Access | ReadOnly |
| Type | 文字列型 |
| Default | <自動生成> |
| 最小システム | Windows Server 2003 |
認証
| 入力 | 値 |
|---|---|
| 説明 | リモート プロシージャ コール (RPC) 認証設定に対応する値を使用して、呼び出しの認証レベルを設定します。 COMAdminAuthenticationDefault を選択すると、 LocalComputer コレクション内の DefaultAuthenticationLevel プロパティの設定が使用されます。 |
| Access | ReadWrite |
| Type | Long Possible values:COMAdminAuthenticationDefault (0)COMAdminAuthenticationNone (1) COMAdminAuthenticationConnect (2)COMAdminAuthenticationCall (3)COMAdminAuthenticationPacket (4)COMAdminAuthenticationIntegrity (5)COMAdminAuthenticationPrivacy (6) |
| Default | COMAdminAuthenticationPacket (4) |
| 最小システム | Windows 2000 |
Note
ライブラリ (インプロセス) アプリケーションの場合、ここで有効な設定は COMAdminAuthenticationDefault と COMAdminAuthenticationNone だけです。 数値ではなく、列挙で定数を使用することをお勧めします。
AuthenticationCapability
| 入力 | 値 |
|---|---|
| 説明 | 呼び出しが偽装されるときに表示される ID を決定します。 |
| Access | ReadWrite |
| Type | Long Possible values:COMAdminAuthenticationCapabilitiesNone (0x0)COMAdminAuthenticationCapabilitiesSecureReference (0x2)COMAdminAuthenticationCapabilitiesStaticCloaking (0x20)COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40) |
| Default | COMAdminAuthenticationCapabilitiesDynamicCloaking (0x40) |
| 最小システム | Windows 2000 |
変更可能
| 入力 | 値 |
|---|---|
| 説明 | プログラムまたはコンポーネント サービス管理ツールを使用して、アプリケーション設定またはそのコンポーネントの変更を許可するかどうかを決定します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
CommandLine
| 入力 | 値 |
|---|---|
| 説明 | デバッグで使用するコマンド ライン文字列。 アプリケーションは、指定したコマンド ラインを使用してデバッガーで起動できます。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
ConcurrentApps
| 入力 | 値 |
|---|---|
| 説明 | 同時に実行できるプール可能なアプリケーションの最大数を指定します。 |
| Access | ReadWrite |
| Type | Long (1-1048576) |
| Default | 1 |
| 最小システム | Windows XP |
CreatedBy
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションを作成したユーザーを示す情報文字列。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
CRMEnabled
| 入力 | 値 |
|---|---|
| 説明 | 補正Resource Managerが有効かどうかを判断します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
CRMLogFile
| 入力 | 値 |
|---|---|
| 説明 | 補正リソース マネージャー (CRM) のログを保持するためのファイルの名前とパス。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
削除可能
| 入力 | 値 |
|---|---|
| 説明 | プログラムまたはコンポーネント サービス管理ツールを使用して、アプリケーションを削除できるかどうかを設定します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
説明
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションについて説明します。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
DumpEnabled
| 入力 | 値 |
|---|---|
| 説明 | 指定されたディレクトリへの障害発生時の COM+ アプリケーションの状態のダンプを有効にします。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows XP |
Note
Windows Server 2003 の時点では、COM+ ダンプ ファイルに対する読み取りアクセス権を持つのは管理者のみです。
DumpOnException
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションで未処理の例外が発生し、COM+ ランタイムによって終了された場合に、COM+ アプリケーションの状態のダンプを有効にします。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows XP |
DumpOnFailfast
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションが失敗した場合の COM+ アプリケーションの状態のダンプを有効にします。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows XP |
DumpPath
| 入力 | 値 |
|---|---|
| 説明 | ダンプ ファイルが保存されるディレクトリのパス。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "%systemroot%\system32\com\dmp" |
| 最小システム | Windows XP |
Note
Windows Server 2003 の時点では、COM+ ダンプ ファイルに対する読み取りアクセス権を持つのは管理者のみです。
EventsEnabled
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションに対してイベントが有効になっているかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows 2000 |
id
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションを表す GUID。 このプロパティは、このコレクションのオブジェクトで Key プロパティ メソッドが呼び出されたときに返されます。 |
| Access | WriteOnce |
| Type | 文字列型 |
| Default | <自動生成> |
| 最小システム | Windows 2000 |
ID
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションのサーバー プロセス ID を設定します。 有効なユーザー アカウントまたは "対話型ユーザー" を指定して、アプリケーションで現在ログオンしているユーザーの ID を想定させます。 文字列 "nt authority\localservice"、"nt authority\networkservice"、および "nt authority\system" を指定することもできます。 これら 3 つのアカウントの既定のパスワードは "" (空の文字列) です。 |
| Access | |
| Type | |
| Default | |
| 最小システム | Windows 2000 |
Identity プロパティは、クライアント プロセスで実行されるライブラリ アプリケーションでは有効になっていません。
パスワードと ID が保存される前に検証されるため、 SaveChanges を使用する前に、Identity と同時に Password プロパティを設定する必要があります。 パスワードと ID が同期を取り消した場合、アプリケーションは管理者によってリセットされるまで起動できません。
ImpersonationLevel
| 入力 | 値 |
|---|---|
| 説明 | 他のアプリケーションへの呼び出しに使用される偽装レベルを設定します。 |
| Access | ReadWrite |
| Type | Long 可能な値:COMAdminImpersonationAnonymous (1)COMAdminImpersonationIdentify (2)COMAdminImpersonationImpersonate (3)COMAdminImpersonationDelegate (4) |
| Default | COMAdminImpersonationImpersonate (3) |
| 最小システム | Windows 2000 |
IsEnabled
| 入力 | 値 |
|---|---|
| 説明 | COM+ アプリケーションまたはコンポーネントが無効になっている場合、IsEnabled は False です。 COM+ アプリケーションまたはコンポーネントが有効になっている場合、IsEnabled は True です。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows XP |
IsSystem
| 入力 | 値 |
|---|---|
| 説明 | COM+ システム アプリケーションを識別します。 |
| Access | ReadOnly |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
MaxDumpCount
| 入力 | 値 |
|---|---|
| 説明 | 上書きが発生する前に生成されるファイルの最大数を示します。 |
| Access | ReadWrite |
| Type | Long (1 から 200) |
| Default | 5 |
| 最小システム | Windows XP |
名前
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションの名前です。 文字列の先頭と末尾に余分なスペースが取り除かれます。このプロパティは、このコレクションのオブジェクトで Name プロパティ メソッドが呼び出されたときに返されます。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "新しいアプリケーション" |
| 最小システム | Windows 2000 |
注意
アプリケーションには一意の名前を選択する必要があります。 同じ名前で複数のアプリケーションが作成されると、アプリケーションの名前による参照が妨げられ、予期しない動作が発生する可能性があります。
パスワード
| 入力 | 値 |
|---|---|
| 説明 | ID の下でログオンするためにサーバー プロセスで使用されるパスワードを設定します。 |
| Access | WriteOnly |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows 2000 |
パスワードと ID は保存される前に検証されるため、 SaveChanges を使用する前に、ID と同時にパスワードを設定する必要があります。 パスワードと ID が同期を取り消した場合、アプリケーションは管理者によってリセットされるまで起動できません。
QCAuthenticateMsgs
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションに対してキューに登録された要求が認証される状況を示します。 |
| Access | ReadWrite |
| Type | Long 可能な値:COMAdminQCMessageAuthenticateSecureApps (0)COMAdminQCMessageAuthenticateOff (1)COMAdminQCMessageAuthenticateOn (2) |
| Default | COMAdminQCMessageAuthenticateSecureApps (0) |
| 最小システム | Windows XP |
QCListenerMaxThreads
| 入力 | 値 |
|---|---|
| 説明 | 同時リスナー スレッドの最大数を示します。 このプロパティの有効な範囲は 0 から 1000 です。 新しく作成されたアプリケーションの場合、この設定は、リスナー スレッドの既定の数 (サーバー内の CPU の数の 16 倍) を決定するために現在使用されているアルゴリズムから派生します。 |
| Access | ReadWrite |
| Type | Long (0 から 1000) |
| Default | 0 |
| 最小システム | Windows XP |
注意
このプロパティは、コンポーネント サービス管理ツールの [ キュー ] タブから読み取り/書き込み機能でも使用できます。
QueueListenerEnabled
| 入力 | 値 |
|---|---|
| 説明 | キューに登録されたコンポーネント リスナーがアプリケーションに対して有効になっているかどうかを示します。 有効にすると、アプリケーションの起動時にリスナーが起動します。 このプロパティは、QueuingEnabled が True に設定されている場合にのみ有効になります。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
QueuingEnabled
| 入力 | 値 |
|---|---|
| 説明 | COM+ Queued Components サービスがアプリケーションに対して有効になっているかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
RecycleActivationLimit
| 入力 | 値 |
|---|---|
| 説明 | プロセスをリサイクルする前に受け入れるアプリケーション内の構成済みオブジェクトのアクティブ化の最大数を示します。 アクティブ化の既定の数は 0 です。 |
| Access | ReadWrite |
| Type | Long (0-1048576) |
| Default | 0 |
| 最小システム | Windows XP |
RecycleCallLimit
| 入力 | 値 |
|---|---|
| 説明 | プロセスをリサイクルする前に、アプリケーションで構成されたオブジェクトが受け入れられる呼び出しの最大数を示します。 呼び出しの既定の数は 0 です。 |
| Access | ReadWrite |
| Type | Long (0-1048576) |
| Default | 0 |
| 最小システム | Windows XP |
RecycleExpirationTimeout
| 入力 | 値 |
|---|---|
| 説明 | リサイクルされたプロセスをシャットダウンする前に実行できる時間 (分単位) を示します。 カウントダウンは、プロセスがリサイクルされた直後に開始されます。 有効期限の最大タイムアウトは 1440 分 (24 時間) で、既定値は 15 分です。 |
| Access | ReadWrite |
| Type | Long (1 から 1440) |
| Default | 15 |
| 最小システム | Windows XP |
RecycleLifetimeLimit
| 入力 | 値 |
|---|---|
| 説明 | プロセスをリサイクルする前に実行できる最大時間 (分) を示します。 有効期間の上限は 30240 分 (21 日) で、既定値は 0 分です。 |
| Access | ReadWrite |
| Type | Long (0-30240) |
| Default | 0 |
| 最小システム | Windows XP |
RecycleMemoryLimit
| 入力 | 値 |
|---|---|
| 説明 | プロセスがリサイクルされる前に許容されるメモリ使用量の最大量 (キロバイト単位) を示します。 プロセス のメモリ使用量が 1 分を超える期間に指定された数を超えた場合、プロセスはリサイクルされます。 メモリ使用量の既定の量は 0 KB です。 |
| Access | ReadWrite |
| Type | Long (0-1048576) |
| Default | 0 |
| 最小システム | Windows XP |
レプリケート
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションをレプリケートできるかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | True |
| 最小システム | Windows XP |
RunForever
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションがアイドル状態の場合にサーバー プロセスを続行できるようにします。 True に設定すると、アイドル状態のままでもサーバー プロセスはシャットダウンされません。 False に設定すると、ShutdownAfter プロパティによって設定された値に従ってプロセスがシャットダウンされます。 RunForever は、ライブラリ (インプロセス) アプリケーションでは有効になっていません。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows 2000 |
ServiceName
| 入力 | 値 |
|---|---|
| 説明 | サービス アプリケーションとして実行するように構成されたアプリケーションに対応するサービス名。 この値が NULL の場合、アプリケーションはサービスとして実行するように構成されていません。 それ以外の場合は、サービス名を使用してサービスの構成情報を確認できます。 |
| Access | ReadOnly |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows XP |
ShutdownAfter
| 入力 | 値 |
|---|---|
| 説明 | アイドル状態になった後にサーバー プロセスをシャットダウンするまでの遅延を設定します。 シャットダウンの待機時間は、0 から 1440 分 (24 時間) の範囲です。 RunForever が True に設定されている場合、このプロパティは無視されます。 ShutdownAfter は、ライブラリ (インプロセス) アプリケーションでは有効になっていません。 |
| Access | ReadWrite |
| Type | Long (0 から 1440) |
| Default | 3 |
| 最小システム | Windows 2000 |
SoapActivated
| 入力 | 値 |
|---|---|
| 説明 | このアプリケーションが SOAP プロトコルを介して使用するために公開されているかどうかを示します。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows Server 2003 |
SoapBaseUrl
| 入力 | 値 |
|---|---|
| 説明 | このアプリケーションが SOAP プロトコルを介して公開される URL エンドポイント。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows Server 2003 |
SoapMailTo
| 入力 | 値 |
|---|---|
| 説明 | このアプリケーションが SOAP プロトコルを介して公開される電子メール アドレス。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows Server 2003 |
SoapVRoot
| 入力 | 値 |
|---|---|
| 説明 | SOAP プロトコルを介してアプリケーションを公開するアクセス スクリプトが存在する IIS 仮想ルート ディレクトリ。 |
| Access | ReadWrite |
| Type | 文字列型 |
| Default | "" |
| 最小システム | Windows Server 2003 |
SRPEnabled
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションのソフトウェア制限ポリシー (SRP) を決定します。 True に設定すると、アプリケーションの SRPTrustLevel プロパティが使用されます。 False に設定すると、ローカル セキュリティ設定のソフトウェア制限ポリシーが使用されます。 ローカル セキュリティ設定は、Microsoft 管理コンソールのローカル セキュリティ ポリシー スナップインを使用して制御されます。 |
| Access | ReadWrite |
| Type | Bool |
| Default | 誤 |
| 最小システム | Windows XP |
SRPTrustLevel
| 入力 | 値 |
|---|---|
| 説明 | アプリケーションのソフトウェア制限ポリシー (SRP) 信頼レベルを示します。 このプロパティは、SRPEnabled プロパティが True に設定されている場合にのみ使用されます。 SRP 信頼レベルとは、アプリケーションに与える信頼のレベルを指します。 無制限の SRP 信頼レベルはSAFER_LEVELID_FULLYTRUSTED列挙型の値に対応し、許可されていない SRP 信頼レベルはSAFER_LEVELID_DISALLOWED列挙型の値に対応します。 信頼レベルの列挙は Winsafer.h で定義されます。 |
| Access | ReadWrite |
| Type | Long 可能な値:SAFER_LEVELID_DISALLOWED (0x0)SAFER_LEVELID_FULLYTRUSTED (0x40000) |
| Default | SAFER_LEVELID_FULLYTRUSTED (0x40000) |
| 最小システム | Windows XP |
無制限アクセスで信頼するアプリケーションには、最も厳格なセキュリティがアタッチされている必要があります。 Unrestricted のアプリケーションでは、無制限のコンポーネントのみを読み込むことができますが、許可されていないアプリケーションの実行は許可されないため、コンポーネントを読み込めません。
関連項目