Guide de déploiement du .NET Framework pour les développeurs

Cette rubrique fournit des informations pour les développeurs qui veulent installer le .NET Framework version 4 avec leurs applications.

Vous pouvez télécharger le package redistribuable autonome .NET Framework 4 et les modules linguistiques .NET Framework 4 à partir du Centre de téléchargement Microsoft. Pour les liens de téléchargement, consultez les sections Packages redistribuables autonomes et Packages de programme d'amorçage Web.

Cette rubrique contient les sections suivantes :

• Conditions requises pour l'installation

• Packages redistribuables autonomes

• Packages de programme d'amorçage Web

• Redistribution de .NET Framework 4 à l'aide de Visual Studio 2010

• Installation manuelle du .NET Framework

• Chaînage du package redistribuable à votre programme d'installation de l'application

• Chaînage des modules linguistiques à votre programme d'installation de l'application

• Détection de .NET Framework 4

• Détection des modules linguistiques

• Désinstallation de Microsoft .NET Framework 4

• Options de ligne de commande

• Dépannage

Pour plus d'informations sur la façon dont un administrateur système peut déployer .NET Framework 4 et ses dépendances système sur un réseau, consultez le Guide de déploiement du .NET Framework pour les administrateurs.

Conditions requises pour l'installation

Voici un résumé de la configuration matérielle et logicielle requise pour l'installation de .NET Framework 4. Pour obtenir une description détaillée de la configuration requise, consultez Configuration requise du .NET Framework.

Remarque
Vous devez disposer des privilèges d'administrateur pour installer .NET Framework 4.

Configuration logicielle requise

Pour installer .NET Framework 4, l'un des systèmes d'exploitation suivants doit être présent sur l'ordinateur cible :

• Famille Windows 7.

• Famille Windows Server 2008 R2.

• Server Core de Windows Server 2008 R2 avec Service Pack 1 ou version ultérieure.

• Famille Windows Vista.

• Famille Windows Server 2008.

• Windows XP Édition Familiale ou Microsoft Windows XP Professionnel, avec Service Pack 3 ou version ultérieure.

• Famille Windows Server 2003 avec Service Pack 2 ou version ultérieure.

Pour Windows Server 2003, vous devez également installer le composant Imagerie Windows (WIC) sur l'ordinateur cible :

• Composant Imagerie Windows 32 bits

• Composant Imagerie Windows 64 bits

Pour Server Core de Windows Server 2008 R2, vous devez activer les fonctionnalités de système d'exploitation suivantes :

• .NET Framework 2.0 Utilisez l'une des commandes ocsetup suivantes :

  • start /w ocsetup NetFx2-ServerCore

  • start /w ocsetup NetFx2-ServerCore-WOW64

• Windows 32 bits sur Windows 64 bits (WOW64). Utilisez la commande ocsetup suivante :

  • start /w ocsetup ServerCore-WOW64

Configuration matérielle requise

Packages redistribuables autonomes

Les packages redistribuables autonomes contiennent tous les composants requis pour le déploiement de .NET Framework 4 sur les plateformes cibles spécifiées. Toutefois, ces fichiers exécutables ne contiennent pas de modules linguistiques. Vous pouvez utiliser les modules linguistiques autonomes pour installer une prise en charge linguistique.

Le tableau suivant répertorie les packages redistribuables autonomes pour chaque profil et chaque plateforme.

Les packages dotNetFx40_Client_x86_64.exe et dotNetFx40_Full_x86_64.exe sont conçus pour les ordinateurs x86 et x64. Ils sont recommandés pour la plupart des scénarios de déploiement. Toutefois, ils ne prennent pas en charge les ordinateurs IA-64.

Utilisez le package dotNetFx40_Full_x86.exe ou dotNetFx40_Client_x86.exe si vous prévoyez d'installer .NET Framework 4 uniquement sur des ordinateurs x86. N'utilisez pas ces packages pour une installation sur des systèmes d'exploitation 64 bits. (Le package Client Profile n'est pas disponible pour une redistribution sur des ordinateurs IA-64.)

Packages de programme d'amorçage Web

Les packages de programme d'amorçage Web sont des programmes d'installation Web qui simplifient le processus d'installation. Lors de l'installation, ces fichiers légers téléchargent les composants requis à partir d'Internet. Chaque package requiert une connexion Internet pour détecter, télécharger et installer les composants requis et le module linguistique correspondant à la langue du système d'exploitation de l'utilisateur. Vous pouvez utiliser les modules linguistiques autonomes pour installer d'autres prises en charge linguistiques.

Remarque
Les packages du programme d'amorçage Web ne fonctionnent pas sur les ordinateurs du Server Core de Windows Server 2008 R2.

Le tableau suivant répertorie les packages de programme d'amorçage Web pour chaque profil.

Le programme d'amorçage Web vous permet de lancer et d'installer manuellement le package redistribuable sur un ordinateur. Il peut également être lancé et installé dans le cadre du programme d'installation pour une application .NET Framework 4.

Redistribution de .NET Framework 4 à l'aide de Visual Studio 2010

Lorsque vous déployez des applications qui sont créées avec Microsoft Visual Studio 2010 et qui nécessitent .NET Framework 4, le .NET Framework doit être installé sur l'ordinateur cible avant l'installation de votre application. Vous pouvez inclure .NET Framework 4 dans un fichier exécutable d'installation créé à l'aide d'un projet d'installation Visual Studio 2010. Pour ce faire, il existe trois possibilités : vous pouvez utiliser un projet d'installation Visual Studio, un déploiement d'applications ClickOnce ou un projet InstallShield.

Si vous créez un programme d'installation pour le .NET Framework, vous pouvez éventuellement le chaîner au processus d'installation de votre application pour surveiller l'installation du .NET Framework. Cette opération est abordée dans la section Chaînage du .NET Framework à votre programme d'installation de l'application. Vous pouvez également chaîner les modules linguistiques .NET Framework, à moins que vous utilisiez le programme d'amorçage Web. Cette opération est abordée dans la section Chaînage des modules linguistiques à votre programme d'installation de l'application.

Si la création d'un fichier d'installation n'est pas pratique, vous pouvez demander aux utilisateurs d'installer le .NET Framework manuellement, comme décrit dans la section suivante.

Remarque
Pour plus d'informations sur l'installation du .NET Framework 4 sur les ordinateurs Server Core, consultez la section Chaînage des modules linguistiques à votre programme d'installation de l'application.

Pour inclure le .NET Framework dans un projet d'installation

Lorsque vous configurez un projet d'installation Visual Studio 2010 pour installer .NET Framework 4 avec votre application, .NET Framework 4 est fourni avec votre application. Le programme d'installation de votre application vérifie si .NET Framework 4 est installé et, si nécessaire, l'installe avant votre application.

Dans Visual Studio 2010, créez un projet d'installation en procédant comme suit :

1. Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.

2. Dans le volet gauche, cliquez sur Autres types de projets, sur Configuration et déploiement, puis sur Programme d'installation de Visual Studio.

3. Dans la zone Nom, tapez un nom de projet, puis cliquez sur OK.

4. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet d'installation, cliquez sur Ajouter, puis ajoutez votre sortie de projet, vos modules de fusion, vos fichiers et vos assemblys.

5. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet d'installation, puis cliquez sur Propriétés.

6. Dans la boîte de dialogue Pages de propriétés, cliquez sur Composants requis.

7. Dans la boîte de dialogue Composants requis, vérifiez que la case à cocher Créer un programme d'installation des composants requis est activée.

8. Dans la liste des composants requis, recherchez .NET Framework 4, puis sélectionnez le profil voulu (.NET Framework 4 ou .NET Framework 4 Client Profile).

9. Cliquez sur une option pour spécifier l'emplacement source des composants requis, puis cliquez sur OK.

   Si vous indiquez une URL pour l'emplacement de téléchargement de .NET Framework 4, vous pouvez spécifier le site du Centre de téléchargement Microsoft ou un autre site de votre choix. Si vous placez le package redistribuable sur votre propre serveur, vous devez utiliser le package redistribuable complet et non le programme d'amorçage Web. Vous pouvez uniquement créer un lien vers le programme d'amorçage Web sur le Centre de téléchargement Microsoft. L'URL peut également spécifier un CD sur lequel votre application est distribuée.

10. Dans la boîte de dialogue Pages de propriétés, cliquez sur OK.

Pour inclure le .NET Framework avec un déploiement ClickOnce

Le déploiement ClickOnce vous permet de publier des applications Windows sur un serveur Web ou un partage de fichiers réseau pour simplifier l'installation. Visual Studio prend intégralement en charge la publication et la mise à jour des applications déployées avec ClickOnce. Le déploiement ClickOnce est disponible pour les projets créés avec Visual Basic et Visual C#, mais pas Visual C++.

Dans Visual Studio 2010, choisissez le déploiement ClickOnce en procédant comme suit :

1. Ouvrez le projet d'application que vous voulez publier.

2. Dans l'Explorateur de solutions, cliquez avec le bouton droit sur le nom du projet, puis cliquez sur Propriétés.

3. Cliquez sur le volet Publier.

4. Cliquez sur le bouton Composants requis.

5. Dans la boîte de dialogue Composants requis, vérifiez que la case à cocher Créer un programme d'installation des composants requis est activée.

6. Dans la liste des composants requis, recherchez .NET Framework 4, puis sélectionnez le profil voulu (.NET Framework 4 ou .NET Framework 4 Client Profile).

7. Cliquez sur une option pour spécifier l'emplacement source des composants requis, puis cliquez sur OK.

   Si vous indiquez une URL pour l'emplacement de téléchargement de .NET Framework 4, vous pouvez spécifier le site du Centre de téléchargement Microsoft ou un autre site de votre choix. Si vous placez le package d'installation redistribuable sur votre propre serveur, vous devez utiliser le package redistribuable complet et non le programme d'amorçage Web. Vous pouvez uniquement créer un lien vers le programme d'amorçage Web sur le Centre de téléchargement Microsoft. L'URL peut également spécifier un CD sur lequel votre application est distribuée.

8. Dans la boîte de dialogue Pages de propriétés, cliquez sur OK.

Pour inclure le .NET Framework avec InstallShield

InstallShield vous permet de publier des applications Windows via Visual Studio 2010.

Dans Visual Studio 2010, créez un projet d'installation en procédant comme suit :

1. Dans le menu Fichier, cliquez sur Nouveau, puis sur Projet.

2. Dans le volet gauche, cliquez sur Autres types de projets, sur Configuration et déploiement, puis sur InstallShield 2010.

3. Dans la zone Nom, tapez un nom de projet, puis cliquez sur OK.

4. Si vous êtes un nouvel utilisateur, cliquez sur Accéder à InstallShield afin de télécharger InstallShield Limited Edition pour Microsoft Visual Studio 2010. Redémarrez Visual Studio 2010.

5. Ouvrez l'Assistant Projet et cliquez sur Fichiers d'application pour ajouter la sortie de projet. L'Assistant Projet vous permet de configurer d'autres attributs de projet.

6. Accédez à Configuration d'installation requise, puis sélectionnez les systèmes d'exploitation et la version du .NET Framework que vous voulez installer.

7. Cliquez avec le bouton droit sur votre projet d'installation et cliquez sur Générer.

Installation manuelle du .NET Framework

Il est parfois peu pratique d'installer automatiquement .NET Framework 4 avec votre application. Dans ce cas, vous pouvez faire en sorte que les utilisateurs installent le .NET Framework eux-mêmes. Le package redistribuable est disponible dans plusieurs configurations (consultez les sections Packages redistribuables autonomes et Packages de programme d'amorçage Web plus haut dans cette rubrique). Dans votre processus d'installation, fournissez des instructions sur la manière dont les utilisateurs doivent chercher et installer le .NET Framework.

Chaînage du .NET Framework à votre programme d'installation de l'application

.NET Framework 4 vous permet d'inclure (chaîner) le processus d'installation du .NET Framework dans le processus d'installation de votre application de deux façons, grâce à des commandes de ligne de commande : 

• Incluez l'ensemble complet des fichiers .NET Framework sur votre média de redistribution afin que les utilisateurs n'aient pas à télécharger de fichiers supplémentaires à partir d'Internet pendant l'installation.

• Laissez le processus d'installation du .NET Framework identifier les composants requis, puis les télécharger et les installer à partir d'Internet à l'aide des packages de programme d'amorçage Web.

Ces deux options sont traitées dans les deux sections suivantes :

Quelle que soit l'option choisie, exécutez le package redistribuable à partir de la ligne de commande, utilisez les options de ligne de commande d'installation suivantes après le nom .exe du package redistribuable et traitez les codes d'erreur en conséquence pour chaîner le processus d'installation de .NET Framework 4 :

<.NET Framework redistributable> /q /norestart /ChainingPackage <packageName>

Remarque
Les exemples de cette rubrique supposent que le nom du package de chaînage est MyProductName.

Pour une liste complète des options, consultez la section Options de ligne de commande.

Pour obtenir un exemple de package de chaînage, consultez Comment : obtenir la progression à partir du programme d'installation du .NET Framework 4.

Intégration des fichiers .NET Framework dans votre média de redistribution

Si vous voulez inclure tous les composants dans le processus d'installation du .NET Framework, utilisez les packages redistribuables autonomes. Ces packages contiennent les composants requis pour installer .NET Framework 4 sur tous les ordinateurs x86, x64 et IA-64 dont le système d'exploitation est pris en charge. Par exemple, pour chaîner le processus d'installation de .NET Framework Client Profile sur des ordinateurs x86 ou x64 à l'aide du package redistribuable autonome, utilisez la commande suivante :

dotNetFx40_Client_x86_x64.exe /q /norestart /ChainingPackage "MyProductName"

Remarque
Cette méthode ne permet pas de chaîner-installer les modules linguistiques.(Consultez la section Chaînage des modules linguistiques à votre programme d'installation de l'application.)

Décision par le processus d'installation .NET Framework

Cette option utilise les packages de programme d'amorçage Web pour installer uniquement les composants requis. Vous pouvez déployer le programme d'amorçage Web avec les paramètres de langue par défaut ou spécifier un autre module linguistique à l'aide de l'option de ligne de commande /LCID.

• Utilisation des paramètres de langue par défaut

  Si vous ne spécifiez pas l'option de ligne de commande /LCID, le programme d'amorçage Web télécharge automatiquement le module linguistique qui correspond au paramètre MUI (Multilingual User Interface) de l'utilisateur. Par exemple, pour chaîner le processus d'installation .NET Framework complet sur des ordinateurs x86 ou x64 à l'aide du package de programme d'amorçage Web, ajoutez la commande suivante au processus d'installation de votre application :

  dotNetFx40_Full_setup.exe /q /norestart /ChainingPackage "MyProductName"
  

  Avec cette option, le module linguistique correspondant au paramètre MUI de l'utilisateur est automatiquement téléchargé et installé.

• Remplacement des paramètres de langue par défaut

  Si vous spécifiez l'option de ligne de commande /LCID, le programme d'amorçage Web n'exécute pas de détection automatique ; il télécharge le module linguistique que vous spécifiez. Par exemple, pour chaîner le processus d'installation .NET Framework complet sur des ordinateurs x86 ou x64 et installer le module linguistique japonais, ajoutez la commande suivante au processus d'installation de votre application :

  dotNetFx40_Full_setup.exe /q /norestart /ChainingPackage "MyProductName" /LCID 1041
  

  Remarque

  Des modules linguistiques différents peuvent avoir des dates de publication différentes.Si le module linguistique spécifié n'est pas disponible au Centre de téléchargement, le programme d'installation installera le .NET Framework sans le module linguistique.De même, si .NET Framework 4 est déjà installé sur l'ordinateur de l'utilisateur, le programme d'amorçage Web installera uniquement le module linguistique.

Suivi et annulation d'une installation sans assistance dans le programme d'installation de l'application

Le programme d'installation de .NET Framework 4 est souvent inclus sous la forme d'un composant requis dans le programme d'installation des applications. Si vous voulez offrir une installation personnalisée ou unifiée pour les applications qui requièrent .NET Framework 4, vous pouvez lancer et suivre l'installation de .NET Framework 4 sans assistance en affichant votre propre vue de la progression de l'installation. Pour ce faire, consultez MSDN Library.

Chaînage des modules linguistiques à votre programme d'installation de l'application

Le tableau suivant fournit une liste de fichiers exécutables de modules linguistiques autonomes contenant les ressources localisées pour les plateformes cibles spécifiées. Ces fichiers exécutables ne contiennent pas les fichiers binaires indépendants de la langue qui sont requis pour l'installation des modules linguistiques .NET Framework 4. culture indique une langue prise en charge.

Vous n'avez pas besoin de chaîner les modules linguistiques si vous utilisez le programme d'amorçage Web.

Remarque
Les modules linguistiques Client Profile ne peuvent pas être redistribués sur des ordinateurs IA-64.

Les packages dotNetFx40LP_Full_x86_x64de.exe et dotNetFx40LP_Full_x86_x64ja.exe en sont des exemples.

Par exemple, pour déployer .NET Framework 4 complet avec le module linguistique allemand sur des ordinateurs x86 ou x64, utilisez la commande suivante :

dotNetFx40LP_Full_x86_x64de.exe /q /norestart /ChainingPackage "MyProductName"

Pour une liste complète des options de ligne de commande, consultez la section Options de ligne de commande.

Détection de .NET Framework 4

Le programme d'installation de .NET Framework 4 écrit des clés de Registre lorsque l'installation est réussie. Vous pouvez tester si .NET Framework 4 est installé en vérifiant les clés de Registre répertoriées dans le tableau suivant.

Détection des modules linguistiques

Pour tester si un module linguistique spécifique est installé, vérifiez les clés de Registre répertoriées dans le tableau suivant. LCID spécifie un identificateur de paramètres régionaux ; consultez la liste des langues prises en charge.

Par exemple, pour détecter si le module linguistique japonais complet est déjà installé, recherchez les valeurs suivantes dans le Registre :

Key: HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\NET Framework Setup\NDP\v4\Full\1041
Name: Install
Type: DWORD
Data: 1

Désinstallation de .NET Framework 4

Vous pouvez désinstaller .NET Framework 4 à partir d'Ajout/Suppression de programmes dans le Panneau de configuration. Vous devez d'abord désinstaller la version .NET Framework 4 Extended avant de pouvoir désinstaller .NET Framework 4 Client Profile.

Pour les systèmes d'exploitation Server Core, vous devez désinstaller le .NET Framework 4 à l'aide des opérations de ligne de commande suivantes :

1. Désinstallez la version étendue de .NET Framework 4 :

   %windir%\Microsoft.NET\Framework64\v4.0.30319\SetupCache\Extended\setup.exe /uninstall /x86 /x64 /ia64 /parameterfolder Extended /q
   

2. Désinstallez le Client Profile de .NET Framework 4 :

   %windir%\Microsoft.NET\Framework64\v4.0.30319\SetupCache\Client\setup.exe /uninstall /x86 /x64 /parameterfolder Client
   

Options de ligne de commande

Le tableau suivant répertorie les options que vous pouvez inclure lorsque vous exécutez le programme d'installation redistribuable de .NET Framework 4 à partir de la ligne de commande.

Option	Description
/q	Définit le mode silencieux.
/norestart	Empêche le programme d'installation de redémarrer automatiquement. Si vous utilisez cette option, l'application de chaînage doit capturer le code de retour et gérer le redémarrage (consultez Obtention d'informations sur la progression d'un programme d'installation (page éventuellement en anglais).NET Framework 4).
/repair	Déclenche les fonctionnalités de réparation
/LCID LCID où LCID spécifie un identificateur de paramètres régionaux (consultez la liste des langues prises en charge)	Installe le module linguistique spécifié par LCID et force l'affichage de l'interface utilisateur dans cette langue (sauf si le mode silencieux est défini). Pour le programme d'amorçage Web, cette option chaîne-installe le module linguistique à partir d'Internet. Remarque N'utilisez pas cette option lorsque vous installez les modules linguistiques .NET Framework.
/passive	Définit le mode passif ; affiche la barre de progression pour indiquer que l'installation est en cours, mais n'affiche aucune invite ni aucun message d'erreur à l'utilisateur. Dans ce mode, le programme d'installation doit gérer les codes de retour.
/showfinalerror	Définit le mode passif, mais affiche des erreurs si l'installation a échoué. Cette option requiert une intervention de l'utilisateur si l'installation n'a pas réussi.
/promptrestart	En mode passif, si le programme d'installation nécessite un redémarrage pour terminer l'opération, il invite l'utilisateur à redémarrer son ordinateur. Cette option requiert une intervention de l'utilisateur si un redémarrage est obligatoire.
/CEIPConsent	Remplace le comportement par défaut et envoie des commentaires anonymes à Microsoft pour améliorer les futurs déploiements. Cette option peut être utilisée uniquement si l'utilisateur accepte d'envoyer des commentaires anonymes à Microsoft après y avoir été invité par le programme d'installation de l'application.
/chainingpackage PackageName	Spécifie le nom du fichier exécutable qui effectue le chaînage. Ces informations sont envoyées à Microsoft sous forme de commentaires anonymes pour améliorer les futurs déploiements. Si le nom du package inclut des espaces, utilisez des guillemets doubles comme délimiteurs ; par exemple: /chainingpackage "Chaining Product". Pour obtenir un exemple de package de chaînage, consultez Obtention d'informations sur la progression d'un programme d'installation (page éventuellement en anglais) dans MSDN Library.

Langues prises en charge

Dépannage

Codes de retour

Le tableau suivant répertorie les codes de retour les plus courants pour le programme d'installation redistribuable .NET Framework 4. Les codes de retour sont les mêmes pour toutes les versions du programme d'installation. Pour plus d'informations, consultez la section suivante, « Codes d'erreur de téléchargement ».

Codes d'erreur de téléchargement

• Background Intelligent Transfer Service (BITS) error codes

• URL moniker error codes

• WinHttp error codes

Autres codes d'erreur :

• Windows Installer error codes

• Windows Update Agent result codes

Voir aussi

Concepts

Installation du .NET Framework

Autres ressources

Guide de déploiement du .NET Framework pour les administrateurs

Historique des modifications