Megjegyzés
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhat bejelentkezni vagy módosítani a címtárat.
Az oldalhoz való hozzáféréshez engedély szükséges. Megpróbálhatja módosítani a címtárat.
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 igenServiceProcessInstaller.Account, User akkor a lehetőségek és /username a /password 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/LogFile=) beállítással .
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 /ua /AssemblyName 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ípustSystem.ComponentModel.RunInstallerAttribute, amelynél az true 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.exemyLog.InstallLog írja le a következőre, és a következőre myTestAssembly.exeírja a folyamat előrehaladásátmyTestLog.InstallLog.
installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile=myTestLog.InstallLog myTestAssembly.exe
Lásd még
Dolgozzon együtt velünk a GitHubon
A tartalom forrása a GitHubon található, ahol létrehozhat és áttekinthet problémákat és lekéréses kérelmeket is. További információért tekintse meg a közreműködői útmutatónkat.
