Share via


IIsWebVirtualDir (WMI)

This class corresponds to the IIsWebVirtualDir IIS Admin object, and contains the methods and read-only properties for the object.

IIsDirectory (WMI)

Methods in Vtable Order

The IIsWebVirtualDir object defines the following methods, in addition to those inherited from IIsDirectory (WMI).

Method

Description

IIsWebVirtualDir.AppCreate (WMI)

The AppCreate method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object creates a Web application definition and marks it as running in-process or out-of-process. If an application already exists at the specified path, you can use this method to reconfigure the application from in-process to out-of-process, or the reverse.

IIsWebVirtualDir.AppCreate2 (WMI)

The AppCreate2 method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object creates a Web application definition and marks it as running in-process, out-of-process, or in a process pool. If an application already exists at the specified path, you can use this method to reconfigure the application to run in whatever process space you want.

IIsWebVirtualDir.AppCreate3 (WMI)

The AppCreate3 method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object creates a Web application definition and marks it as running in-process, out-of-process, or in a process pool. If an application already exists at the specified path, you can use this method to reconfigure the application to run in whatever process space you want.

IIsWebVirtualDir.AppDelete (WMI)

The AppDelete method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object deletes a Web application definition from a metabase key. If the application is running, it will be shut down. If the application is in-process with IIS, all resources associated with the application (such as out-of-process applications) will be released if the resource is not referenced by another in-process application.

Note

Server component DLLs are not released from in-process applications, even if they are not currently referenced by other applications.

Deletions performed by using AppDelete cannot be undone.

IIsWebVirtualDir.AppUnLoad (WMI)

The AppUnload method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object unloads a Web application that is running out-of-process. All of the application's resources are released and the application's process is terminated. If the application is running in-process, the application is released, if it is not being referenced by any other applications.

Note

Server component DLLs are not released from in-process applications, even if they aren't currently referenced by other applications.

IIsWebVirtualDir.AppDisable (WMI)

The AppDisable method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object disables a Web application that is running out-of-process. All of the application's resources are released and the application's process is terminated. Attempts to access this application will fail. The AppEnable method reenables a disabled application. Both methods are used primarily when moving, copying, or renaming metabase keys. The AppDisable method has no effect if the application is running in-process.

IIsWebVirtualDir.AppEnable (WMI)

The AppEnable method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object reinstates a Web application definition that was previously disabled with the AppDisable method. If the application specified was not previously deleted, it will be reregistered with Component Services.

IIsWebVirtualDir.AppGetStatus (WMI)

The AppGetStatus method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object retrieves the current status of a Web application.

IIsWebVirtualDir.AspAppRestart (WMI)

The AspAppRestart method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object restarts ASP applications. Users can use this method to restart ASP applications without accessing the Global.asa file or stopping and starting the World Wide Web Publishing Service (WWW service) itself. Essentially, a user can restart the application on demand.

Properties

The IIsWebVirtualDir object defines the following properties, in addition to those inherited from IIsDirectory (WMI).

Property

Data type

Description

AppIsolated

SINT32

See AppIsolated in the Metabase Property Reference.

AppPackageID

String

See AppPackageID in the Metabase Property Reference.

AppPackageName

String

See AppPackageName in the Metabase Property Reference.

AppRoot

String

See AppRoot in the Metabase Property Reference.

Requirements

Server: Requires or Windows Server 2003.

Product: IIS

See Also