IIsWebVirtualDir (WMI)
This class corresponds to the IIsWebVirtualDir IIS Admin object, and contains the methods and read-only properties for the object.
Parent Class
Methods
The table below lists the methods for this class:
| Method Name | Return Data Type | Description |
|---|---|---|
| IIsWebVirtualDir.AppCreate (WMI) | void | You can use the AppCreate method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to create a Web application definition and mark 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) | void | You can use the AppCreate2 method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to create a Web application definition and mark 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) | void | You can use the AppCreate3 method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to create a Web application definition and mark 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) | void | You can use the AppDelete method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to delete 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.
Deletions performed by using AppDelete cannot be undone. |
| IIsWebVirtualDir.AppUnLoad (WMI) | void | You can use the AppUnload method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to unload 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.
|
| IIsWebVirtualDir.AppDisable (WMI) | void | You can use the AppDisable method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to disable 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. You can use the AppEnable method to re-enable 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) | void | You can use the AppEnable method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to reinstate 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) | UINT32 | You can use the AppGetStatus method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to retrieve the current status of a Web application. |
| IIsWebVirtualDir.AspAppRestart (WMI) | void | You can use the AspAppRestart method of the IIsWebDirectory (WMI) or IIsWebVirtualDir (WMI) object to restart ASP applications. Users can use this method to restart ASP applications without accessing the Global.asa file or stopping and starting the Web service itself. Essentially, a user can restart the application on demand. |
.gif)
Note Server component DLLs are not released from in-process applications, even if they are not currently referenced by other applications.Properties
The table below lists properties other than those that are inherited from parent classes:
| Property Name | Data Type | Description |
|---|---|---|
| AppRoot | String | Please see AppRoot in the Metabase Property Reference. |
| AppIsolated | SINT32 | Please see AppIsolated in the Metabase Property Reference. |
| AppPackageName | String | Please see AppPackageName in the Metabase Property Reference. |
| AppPackageID | String | Please see AppPackageID in the Metabase Property Reference. |
Related Topics
- For more information about the IIS WMI Provider, see Using the IIS WMI Provider.
- For detailed examples of scripts that use the properties and methods of the Windows WMI provider to access the IIS WMI provider, see Module 3: Writing Administration Scripts that use WMI of the IIS WMI Provider Tutorial.
- For basic examples in VBScript, JScript, and Perl, see Code Examples to Configure Metabase Properties.
- Your installation of IIS 6.0 includes command-line administration scripts that manage IIS. See Using Command-Line Administration Scripts.