How to pause an FTP site using iisftp.vbs _vbs

Applied to: Windows Server 2003, Windows Server 2003 R2, Windows Server 2003 with SP1

Pausing a File Transfer Protocol (FTP) site is similar to stopping a site, except that pausing the site will allow the existing process to continue to complete. If stopping a Web site suddenly causes serious problems for the user, the administrator may want to use this feature for troubleshooting.

You can use command-line scripting iisftp.vbs (stored in systemroot\system32) to pause the site indefinitely. Pausing a Web site prevents the FTP service from accepting new connections, but it does not affect requests that are already being processed.

Important matters
only members of the Administrators group on the local computer can run scripts and executables. As a security best practice, log on to the computer using an account that is not part of the Administrators group, and then use the runas command to run scripts and executables as an administrator. At the command prompt, type runas/profile/user:mycomputer\administrator cmd, open a command window with administrator privileges, and then type Cscript.exescriptname (including the full path and any parameters of the script).

This topic includes the following information:

• Syntax: The order in which you type the command and any parameters and options that follow it.
• Parameter: Gives the value of the variable in the command.
• Example: Sample code and a description of the result.

Grammar
Iisftp/pause Ftpsite [Ftpsite ...] [/s Computer [/u [domain\]user/p Password]]

Parameters
Ftpsite

Required. Specifies the site name or metabase path of the FTP site. The FTP site must be uniquely identified. If more than one FTP site has the same descriptive name, you must use the metabase path to identify the FTP site.

/s Computer

Runs the script on the specified remote computer. Type the name or IP address of the computer without the backslash. By default, the script runs on the local computer.

/u [domain\]user

Runs the script with the permissions of the specified user account. The account must be a member of the Administrators group on the remote computer. By default, the script runs with the permissions of the current user of the local computer.

/P Password

Specifies the password for the user account specified in the/u parameter.

Example

Example 1:
The following example pauses the FTP site "Drivers" on the local computer. This command identifies the site with the site name. In this case, the/s parameter is ignored because the server is the local computer. The/U and/p parameters are ignored because the current user of the local computer must be logged on as an administrator to run the command.

Copy Code code as follows:

Iisftp/pause Drivers

In response, IIsFtp displays the following message confirming that the site has been paused and identifying each site with the site's metabase path: The metabase path is equivalent in IIS to the entries in the system registry.

Connecting to server ... Done.
Server msftpsvc/1879143292 has been paused.

Example 2:

The following example pauses the FTP site "Downloads" and "Drivers" on the remote computer SVR01. This command uses its metabase path "msftpsvc/2109607139" to identify the "Downloads" site, identifying the "Drivers" site by name. In addition, the command uses the/s parameter to specify the remote computer, using the/U and/P parameters to run the command with the user's administrator account permissions.

Copy Code code as follows:

Iisftp/pause msftpsvc/2109607139 drivers/s svr01/u tom/p pa# #word

In response, IIsFtp displays the following message confirming that the site has been paused and identifying each site with the site's metabase path:

Connecting to server ... Done.
Server msftpsvc/2109607139 has been paused.
Server msftpsvc/1879143292 has been paused.

The advantage of using scripts is that you can perform operations in bulk. Combined with bat and planning tasks, it's more perfect.