Exécution d’IIS Express à partir de la ligne de commande

2024-03-07

par Vaidy Gopalakrishnan

Vue d’ensemble

IIS Express est une version simple et autonome d’IIS optimisée pour les développeurs. Cette procédure pas à pas décrit comment exécuter un site à l’aide de la ligne de commande IIS Express.

Prérequis

Vous devez avoir installé ce qui suit pour effectuer les procédures décrites dans cette procédure pas à pas :

Windows XP ou version ultérieure
IIS Express

Pour plus d’informations sur le téléchargement et l’installation d’IIS Express, consultez la vue d’ensemble d’IIS Express.

Exécution d’un site à l’aide d’IIS Express à partir de la ligne de commande

Ouvrez une invite de commandes.

Vous n’avez pas besoin de droits d’utilisateur Administration istrateur pour exécuter les commandes de cette procédure pas à pas. Toutefois, vous devez disposer de droits d’utilisateur Administrateur si vous souhaitez exécuter IIS Express sur les ports numérotés 1024 ou moins.
Exécutez la commande suivante pour accéder au dossier d’installation IIS Express :
```
cd \Program Files\IIS Express
```
ou si vous utilisez un système d’exploitation 64 bits, exécutez la commande suivante :
```
cd \Program Files (x86)\IIS Express
```

Exécutez la commande suivante pour afficher la chaîne d’utilisation IIS Express :

iisexpress /?

IIS Express Usage:
------------------
iisexpress [/config:config-file] [/site:site-name] [/siteid:site-id] [/systray:boolean] 
iisexpress /path:app-path [/port:port-number] [/clr:clr-version] [/systray:boolean] 

/config:config-file 
The full path to the applicationhost.config file. The default value is the IISExpress8\config\applicationhost.config file that is located in the user's Documents folder.

/site:site-name 
The name of the site to launch, as described in the applicationhost.config file. 

/siteid:site-id 
The ID of the site to launch, as described in the applicationhost.config file.

/path:app-path 
The full physical path of the application to run. You cannot combine this option with the /config and related options. 

/port:port-number 
The port to which the application will bind. The default value is 8080. You must also specify the /path option. 

/clr:clr-version The .NET Framework version (e.g. v2.0) to use to run the application. The default value is v4.0. You must also specify the /path option. 

/systray:boolean 
Enables or disables the system tray application. The default value is true. 

/trace:debug-trace-level 
Valid values are info or i,warning or w,error or e. 

Examples: 
iisexpress /site:WebSite1 
This command runs WebSite1 site from the user profile configuration file.

iisexpress /config:c:\myconfig\applicationhost.config 
This command runs the first site in the specified configuration file. 

iisexpress /path:c:\myapp\ /port:80 
This command runs the site from c:\myapp folder over port 80.

Exécutez votre site à l’aide de l’un des éléments suivants :
- Utilisez /config pour exécuter un site à partir d’un fichier de configuration.
  
  Pour plus d’informations, consultez Exécuter votre site à partir d’un fichier de configuration.
- Utilisez /path pour exécuter un site à partir du dossier d’application.
  
  Pour plus d’informations, consultez Exécuter votre site à partir du dossier d’application.
  
  Remarque
  
  L’option /path et l’option /config ne peuvent pas être combinées.
Une fois votre site en cours d’exécution, vous pouvez utiliser la barre d’état système IIS Express pour la gérer. Pour plus d’informations, consultez Utiliser la barre d’état système Windows pour gérer les sites web et les applications. Vous pouvez également désactiver la barre d’état système en exécutant l’option suivante :
```
/systray:false
```

Exécution de votre site à partir d’un fichier de configuration

IIS Express et IIS utilisent le fichier ApplicationHost.config, qui spécifie les paramètres globaux pour les sites, les pools d’applications, les gestionnaires, etc. IIS Express utilise un fichier ApplicationHost.config spécifique à l’utilisateur par défaut pour permettre à de nombreux utilisateurs de partager le même ordinateur sans interférer avec les paramètres d’un autre utilisateur. Ce fichier se trouve dans le dossier %userprofile%\Documents\IISExpress\config ou %userprofile%\My Documents\IISExpress\config, en fonction de votre système d’exploitation. Lorsque vous exécutez un site à partir d’un fichier de configuration, vous pouvez spécifier le site à exécuter.

Vous pouvez utiliser les commandes suivantes :

Pour exécuter le site web Website1 dans le fichier de configuration par défaut, exécutez :
```
iisexpress /site:WebSite1
```
Pour exécuter le premier site web dans le fichier de configuration par défaut, exécutez :
```
iisexpress
```
Pour exécuter le premier site web dans un fichier de configuration personnalisé, exécutez :
```
iisexpress /config:c:\myconfig\applicationhost.config
```
Pour exécuter un site appelé MyBlog à partir d’un fichier de configuration personnalisé, exécutez :
```
iisexpress /config:c:\myconfig\applicationhost.config /site:MyBlog
```

Remarque : l’option /config spécifie le chemin d’accès complet du fichier de configuration. Vous pouvez omettre cette option si vous souhaitez utiliser le fichier de configuration par défaut. L’option /site spécifie un site particulier dans le fichier de configuration. Vous pouvez omettre cette option pour exécuter le premier site dans le fichier de configuration.

Exécution de votre site à partir du dossier d’application

Vous pouvez également utiliser l’option /path pour exécuter un site directement à partir d’un dossier. Cette option fonctionne pour n’importe quel type d’application, notamment html statique, HTML ASP.NET, PHP et WCF. Par défaut, IIS Express exécute le site sur http://localhost:8080/. Pour un site web géré, tel que ASP.NET, IIS Express utilise .NET 4.0. Vous pouvez utiliser les options /port et /clr pour remplacer ces valeurs par défaut.

Par exemple, la commande suivante exécute l’application spécifiée, « myapp », activée à http://localhost:9090/ l’aide de .NET 2.0 :

iisexpress /path:c:\myapp\ /port:9090 /clr:v2.0

Partager via