Megosztás a következőn keresztül:

Installutil.exe (telepítőeszköz)

  • Cikk

A Telepítő eszköz egy parancssori segédprogram, amely lehetővé teszi a kiszolgálói erőforrások telepítését és eltávolítását a telepítő összetevőinek megadott szerelvényekben való végrehajtásával. Ez az eszköz együtt működik a System.Configuration.Install névtér osztályaival.

Ez az eszköz automatikusan telepítve van a Visual Studióval. Az eszköz futtatásához használja a Visual Studio fejlesztői parancssorát vagy a Visual Studio Developer PowerShellt.

A parancssorba írja be a következőt:

Syntax

installutil [/u[ninstall]] [options] assembly [[options] assembly] ...

Paraméterek

Argumentum Leírás
assembly Annak a szerelvénynek a fájlneve, amelyben a telepítő összetevőit végre kell hajtani. Hagyja ki ezt a paramétert, ha meg szeretné adni az szerelvény erős nevét a /AssemblyName beállítás használatával.

Beállítások

Lehetőség Leírás
/h[elp]

-vagy-

/?		 Megjeleníti az eszköz parancsszintaxisát és beállításait.
/helpösszeszerelés

-vagy-

/?összeszerelés		 Megjeleníti az egyes telepítők által felismert további beállításokat a megadott szerelvényen belül, valamint a parancs szintaxisát és a InstallUtil.exe beállításait. Ez a beállítás hozzáadja az egyes telepítőösszetevők tulajdonsága Installer.HelpText által visszaadott szöveget a InstallUtil.exe súgószövegéhez. Ha például igenUser, ServiceProcessInstaller.Account akkor a lehetőségek és /password a /username lehetőségek is elérhetők.
/AssemblyName "assemblyName

,Version=major.minor.build.revision

,Culture=locale

,PublicKeyToken=publicKeyToken"		 Megadja egy szerelvény erős nevét, amelyet regisztrálni kell a globális szerelvény-gyorsítótárban. A szerelvény nevének teljes mértékben minősítettnek kell lennie a szerelvény verziójával, kultúrájával és nyilvánoskulcs-jogkivonatával. A teljes nevet idézőjelekkel kell körülvenni.

A "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0" például egy teljesen minősített szerelvénynév.
/InstallStateDir=[directoryName ] Megadja a könyvtárat. A szerelvény eltávolításához használt adatokat tartalmazó InstallState-fájl. Az alapértelmezett a szerelvényt tartalmazó könyvtár.
/LogFile=[fájlnév] Annak a naplófájlnak a nevét adja meg, amelyben a telepítési folyamat rögzítve van. Alapértelmezés szerint, ha a /LogFile beállítás nincs megadva, egy szerelvénynév nevű naplófájl. Létrejön az InstallLog. Ha a fájlnév nincs megadva, a rendszer nem hoz létre naplófájlt.
/LogToConsole={true|false} Ha true, megjeleníti a konzol kimenetét. Ha false (az alapértelmezett) letiltja a konzol kimenetét.
/ShowCallStack A hívásverem kimenete a naplófájlba, ha a telepítés során bármikor kivétel lép fel.
/u[ninstall] Eltávolítja a megadott szerelvényeket. A többi beállítástól eltérően az összes szerelvényre vonatkozik, függetlenül attól, /u hogy hol jelenik meg a lehetőség a parancssorban.

További telepítőbeállítások

A szerelvényen belül használt egyes telepítők a Beállítások szakaszban felsoroltak mellett a lehetőségeket is felismerhetik. A beállítások megismeréséhez futtassa a InstallUtil.exe a parancssorban lévő szerelvények elérési útjával és a /? /help beállítással együtt. Ezeknek a beállításoknak a megadásához a parancssorba kell felvennie őket a InstallUtil.exe által felismert beállításokkal együtt.

Feljegyzés

Az egyes telepítőösszetevők által támogatott beállítások súgószövegét a Installer.HelpText tulajdonság adja vissza. A parancssorban megadott egyéni beállítások programozott módon érhetők el a Installer.Context tulajdonságból.

A rendszer minden beállítást és parancssori paramétert a telepítési naplófájlba ír. Ha azonban az /Password egyes telepítőösszetevők által felismert paramétert használja, a jelszóadatokat nyolc csillag (*) váltja fel, és nem jelenik meg a naplófájlban.

Fontos

Bizonyos esetekben a telepítőnek átadott paraméterek bizalmas vagy személyazonosításra alkalmas információkat tartalmazhatnak, amelyek alapértelmezés szerint egyszerű szöveges naplófájlba vannak írva. Ennek a viselkedésnek a megakadályozása érdekében letilthatja a naplófájlt a parancssorban megadott (fájlnévargumentum nélküli) beállítással /LogFile= .

Megjegyzések

.NET-keretrendszer alkalmazások hagyományos programfájlokból és kapcsolódó erőforrásokból, például üzenetsorokból, eseménynaplókból és teljesítményszámlálókból állnak, amelyeket az alkalmazás üzembe helyezésekor kell létrehozni. A szerelvény telepítőösszetevői segítségével ezeket az erőforrásokat az alkalmazás telepítésekor és az alkalmazás eltávolításakor is létrehozhatja. Installutil.exe észleli és végrehajtja ezeket a telepítőösszetevőket.

Ugyanazon a parancssoron több szerelvényt is megadhat. Minden olyan beállítás, amely azelőtt fordul elő, hogy a szerelvény neve az adott szerelvény telepítésére vonatkozik. Az és /AssemblyNamea /u kivételével a lehetőségek kumulatívak, de felülírhatók. Vagyis az egy szerelvényhez megadott beállítások az összes későbbi szerelvényekre érvényesek, kivéve, ha a beállítás új értékkel van megadva.

Ha Installutil.exe futtat egy szerelvényen a beállítások megadása nélkül, az a következő három fájlt helyezi a szerelvény könyvtárába:

  • InstallUtil.InstallLog – A telepítés folyamatának általános leírását tartalmazza.
  • szerelvénynév. InstallLog – A telepítési folyamat véglegesítési fázisára vonatkozó információkat tartalmaz. A véglegesítési fázisról további információt a metódusban Commit talál.
  • szerelvénynév. InstallState – A szerelvény eltávolításához használt adatokat tartalmazza.

Installutil.exe tükröződés használatával vizsgálja meg a megadott szerelvényeket, és megkeresse az összes Installer olyan típusttrue, amelynél az System.ComponentModel.RunInstallerAttribute attribútum be van állítva. Az eszköz ezután végrehajtja vagy a Installer.Install metódust Installer.Uninstall a Installer típus minden egyes példányán. Installutil.exe tranzakciós módon végzi a telepítést; vagyis ha az egyik szerelvények telepítése sikertelen, az az összes többi szerelvények telepítését visszaállítja. Az eltávolítás nem tranzakciós.

Installutil.exe nem telepíthet vagy távolíthat el késleltetéssel aláírt szerelvényeket, de erős nevű szerelvényeket telepíthet vagy távolíthat el.

A közös nyelvi futtatókörnyezet (CLR) 32 bites verziója csak a Installer eszköz 32 bites verziójával működik, de a CLR 64 bites verziója a Installer eszköz 32 bites és 64 bites verzióival is működik. A 64 bites CLR használatakor a 32 bites Telepítő eszközzel 32 bites szerelvényeket telepíthet, a 64 bites Telepítő eszközt pedig a 64 bites és a közös köztes nyelvű (CIL) szerelvények telepítéséhez. A Telepítő eszköz mindkét verziója ugyanúgy viselkedik.

A C++ használatával létrehozott Windows-szolgáltatás Installutil.exe nem telepíthető, mert Installutil.exe nem ismeri fel a C++ fordító által létrehozott beágyazott natív kódot. Ha egy C++ Windows-szolgáltatást próbál üzembe helyezni Installutil.exe, a rendszer kivételt fog kivenni, például BadImageFormatException . A forgatókönyv használatához helyezze át a szolgáltatáskódot egy C++ modulba, majd írja meg a telepítőobjektumot c# vagy Visual Basic nyelven.

Példák

Az alábbi parancs a InstallUtil.exe parancsszintaxisának és beállításainak leírását jeleníti meg.

installutil /?

Az alábbi parancs a InstallUtil.exe parancsszintaxisának és beállításainak leírását jeleníti meg. A telepítő összetevői myAssembly.exe által támogatott beállítások leírását és listáját is megjeleníti, ha a telepítő Installer.HelpText tulajdonságához súgószöveg lett rendelve.

installutil /? myAssembly.exe

Az alábbi parancs végrehajtja a telepítő összetevőit a szerelvényben myAssembly.exe.

installutil myAssembly.exe

Az alábbi parancs végrehajtja a telepítő összetevőit egy szerelvényben a /AssemblyName kapcsoló és egy teljes név használatával.

installutil /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"

Az alábbi parancs egy fájlnévvel megadott szerelvényben és egy erős névvel megadott szerelvényben hajtja végre a telepítő összetevőit. Vegye figyelembe, hogy a fájlnévvel megadott összes szerelvénynek meg kell előznie a parancssorban erős névvel megadott szerelvényeket, mert a /AssemblyName beállítás nem bírálható felül.

installutil myAssembly.exe /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"

Az alábbi parancs végrehajtja az eltávolító összetevőket a szerelvényben myAssembly.exe.

installutil /u myAssembly.exe

Az alábbi parancs végrehajtja az eltávolítási összetevőket a szerelvényekben myAssembly1.exe és myAssembly2.exea .

installutil myAssembly1.exe /u myAssembly2.exe

Mivel a /u beállítás helye nem fontos a parancssorban, ez egyenértékű a következő paranccsal.

installutil /u myAssembly1.exe myAssembly2.exe

A következő parancs végrehajtja a telepítőket a szerelvényben myAssembly.exe , és megadja, hogy a folyamatinformációk a következőbe lesznek myLog.InstallLogírva.

installutil /LogFile=myLog.InstallLog myAssembly.exe

Az alábbi parancs végrehajtja a telepítőket a szerelvényben myAssembly.exe, meghatározza, hogy a folyamatinformációkat meg kell írni myLog.InstallLog, és a telepítők egyéni /reg beállításával határozza meg, hogy a rendszerregisztrációs adatbázisnak frissítéseket kell-e végrehajtania.

installutil /LogFile=myLog.InstallLog /reg=true myAssembly.exe

Az alábbi parancs végrehajtja a telepítőket a szerelvényben myAssembly.exe, a telepítő egyéni /email beállításával adja meg a felhasználó e-mail-címét, és letiltja a naplófájl kimenetét.

installutil /LogFile= /email=admin@mycompany.com myAssembly.exe

Az alábbi parancs a telepítés előrehaladását myAssembly.exe myLog.InstallLog írja le a következőre, és a következőre myTestLog.InstallLogírja a folyamat előrehaladásátmyTestAssembly.exe.

installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile=myTestLog.InstallLog myTestAssembly.exe

Lásd még