Installutil.exe (Yükleme aracı)
Yükleyici aracı, yükleyici bileşenlerini belirli derlemelerde yürüterek sunucu kaynaklarını yüklemenize ve kaldırmanıza olanak tanıyan bir komut satırı aracıdır. Bu araç, ad alanında System.Configuration.Install sınıflarla birlikte çalışır.
Bu araç, Visual Studio ile birlikte otomatik olarak yüklenir. Aracı çalıştırmak için Visual Studio Geliştirici Komut İstemi'ni veya Visual Studio Geliştirici PowerShell'i kullanın.
Komut istemine şunu yazın:
Sözdizimi
installutil [/u[ninstall]] [options] assembly [[options] assembly] ...
Parametreler
| Bağımsız değişken | Açıklama |
|---|---|
assembly |
Yükleyici bileşenlerinin yürütüleceği derlemenin dosya adı. seçeneğini kullanarak derlemenin tanımlayıcı adını belirtmek istiyorsanız bu parametreyi atla /AssemblyName . |
Seçenekler
| Seçenek | Açıklama |
|---|---|
/h[elp]-veya- /? |
Araç için komut sözdizimini ve seçenekleri görüntüler. |
/helpmeclis-veya- /?meclis |
InstallUtil.exe'ye ilişkin komut sözdizimi ve seçeneklerin yanı sıra, belirtilen derleme içinde tek tek yükleyiciler tarafından tanınan ek seçenekleri görüntüler. Bu seçenek, her yükleyici bileşeninin Installer.HelpText özelliği tarafından döndürülen metni InstallUtil.exe yardım metnine ekler. Örneğin, ise ServiceProcessInstaller.Account User/username ve /password seçenekleri kullanılabilir. |
/AssemblyName "assemblyName,Version=major.minor.build.revision ,Culture=locale ,PublicKeyToken=publicKeyToken" |
Bir derlemenin, genel derleme önbelleğine kaydedilmesi gereken tanımlayıcı adını belirtir. Derleme adı, derlemenin sürüm, kültür ve genel anahtar belirteciyle birlikte belirtilmelidir. Tam olarak belirtilen ad, tırnak işareti içine alınmalıdır. Örneğin, "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0" tam olaralk belirtilmiş bir derleme adıdır. |
/InstallStateDir=[directoryName ] |
Derlemeyi yüklemek için kullanılan verileri içeren .InstallState dosyasının dizinini içerir. Varsayılan değer, derlemeyi içeren dizindir. |
/LogFile=[dosyaadı] |
Yükleme ilerlemesinin kaydedildiği günlük dosyasının adını belirtir. Varsayılan olarak, /LogFile seçenek atlanırsa assemblyname adlı bir günlük dosyası. InstallLog oluşturulur. Dosya adı atlanırsa, hiçbir günlük dosyası oluşturulmaz. |
/LogToConsole={true|false} |
ise true, konsolunun çıkışını görüntüler. If false (varsayılan), konsolunun çıkışını gizler. |
/ShowCallStack |
Yükleme sırasında herhangi bir noktada bir özel durum oluşursa, çağrı yığınını günlük dosyana çıkış olarak aktarır. |
/u[ninstall] |
Belirtilen derlemeleri kaldırır. Diğer seçeneklerden farklı olarak, /u seçeneğin komut satırında nerede göründüğüne bakılmaksızın tüm derlemeler için geçerlidir. |
Ek yükleyici seçenekleri
Bir derleme içinde kullanılan tek tek yükleyiciler, Seçenekler bölümünde listelenenlere ek olarak seçenekleri tanıyabilir. Bu seçenekler hakkında bilgi edinmek için InstallUtil.exe veya /help seçeneğiyle birlikte komut satırındaki derlemelerin yollarıyla /? çalıştırın. Bu seçenekleri belirtmek için, bunları, InstallUtil.exe tarafından tanınan seçeneklerin yanı sıra komut satırına ekleyebilirsiniz.
Not
Tek tek yükleyici bileşenleri tarafından desteklenen seçeneklerle ilgili yardım metni özelliği tarafından Installer.HelpText döndürülür. Komut satırına girilen tek tek seçeneklere özelliğinden Installer.Context program aracılığıyla erişilebilir.
Tüm seçenekler ve komut satırı parametreleri yükleme günlük dosyasına yazılır. Ancak, bazı yükleyici bileşenleri tarafından tanınan parametresini kullanırsanız /Password , parola bilgileri sekiz yıldız (*) ile değiştirilir ve günlük dosyasında görünmez.
Önemli
Bazı durumlarda, yükleyiciye geçirilen ve varsayılan olarak düz bir metin günlüğü dosyasına yazılan, hassas veya kişisel olarak tanımlanabilir bilgiler içerebilir. Bu davranışı önlemek için, komut satırında (dosya adı bağımsız değişkeni olmadan) belirterek /LogFile= günlük dosyasını gizleyebilirsiniz.
Açıklamalar
.NET Framework uygulamaları, uygulama dağıtıldığında oluşturulması gereken geleneksel program dosyalarından ve ileti kuyrukları, olay günlükleri ve performans sayaçları gibi ilişkili kaynaklardan oluşur. Uygulamanız yüklendiğinde bu kaynakları oluşturmak ve uygulamanız kaldırıldığında kaldırmak için, bir derlemenin yükleyici bileşenlerini kullanabilirsiniz. Installutil.exe, bu yükleyici bileşenlerini algılar ve çalıştırır.
Aynı komut satırında birden çok derleme belirtebilirsiniz. Derleme adından önce gelen herhangi bir seçenek o derlemenin yüklemesine uygulanır. /u ve /AssemblyNamedışında, seçenekler kümülatiftir ancak geçersiz kılınabilir. Diğer bir deyişle, bir derleme için belirtilen seçenekler, seçenek yeni bir değerle belirtilmediği sürece sonraki tüm derlemelere uygulanır.
Installutil.exe'yi herhangi bir seçenek belirtmeden bir derlemeye yönelik olarak çalıştırırsanız, aşağıdaki üç dosyayı derlemenin dizinine yerleştirir:
- InstallUtil.InstallLog - Yükleme ilerlemesinin genel bir açıklamasını içerir.
- assemblyname. InstallLog - Yükleme işleminin işleme aşamasına özgü bilgileri içerir. İşleme aşaması hakkında daha fazla bilgi için yöntemine Commit bakın.
- assemblyname. InstallState - Derlemeyi kaldırmak için kullanılan verileri içerir.
Installutil.exe, belirtilen derlemeleri incelemek ve özniteliği olarak ayarlanmış truetüm Installer türleri System.ComponentModel.RunInstallerAttribute bulmak için yansıma kullanır. Araç daha sonra türün Installer.Install her örneğinde Installer veya Installer.Uninstall yöntemini yürütür. Installutil.exe, yüklemeyi işlemsel bir şekilde gerçekleştirir; yani, derlemelerden birisi yüklenemezse, diğer tüm derlemelerin yüklemelerini geri alır. Kaldırma, işlemsel değildir.
Installutil.exe, gecikme imzalı derlemeleri yükleyemez veya kaldıramaz, fakat tanımlayıcı adlı derlemeleri yükleyebilir veya kaldırabilir.
Ortak dil çalışma zamanının (CLR) 32 bit sürümü Yükleyici aracının yalnızca 32 bit sürümüyle birlikte sunulur, ancak CLR'nin 64 bit sürümü Yükleyici aracının hem 32 bit hem de 64 bit sürümleriyle birlikte sunulur. 64 bit CLR kullanırken, 32 bit derlemeleri yüklemek için 32 bit Yükleyici aracını ve 64 bit ve ortak ara dil (CIL) derlemelerini yüklemek için 64 bit Yükleyici aracını kullanın. Yükleyici aracının her iki sürümü de aynı şekilde davranır.
Installutil.exe C++ derleyicisi tarafından oluşturulan eklenmiş yerel kodu tanımadığından Installutil.exe kullanarak C++ kullanılarak oluşturulmuş bir Windows hizmetini dağıtamazsınız. Installutil.exe ile bir C++ Windows hizmeti dağıtmaya çalışırsanız, gibi BadImageFormatException bir özel durum oluşturulur. Bu senaryoyla çalışmak için, hizmet kodunu bir C++ modülüne taşıyın ve sonra yükleyici nesnesini C# veya Visual Basic'te yazın.
Örnekler
Aşağıdaki komut, komut sözdiziminin bir açıklamasını ve InstallUtil.exe'ye ilişkin seçenekleri görüntüler.
installutil /?
Aşağıdaki komut, komut sözdiziminin bir açıklamasını ve InstallUtil.exe'ye ilişkin seçenekleri görüntüler. Ayrıca, yükleyicinin özelliğine yardım metni atanmışsa içinde yükleyici bileşenleri myAssembly.exe tarafından desteklenen seçeneklerin Installer.HelpText bir açıklamasını ve listesini görüntüler.
installutil /? myAssembly.exe
Aşağıdaki komut, derlemesindeki myAssembly.exeyükleyici bileşenlerini yürütür.
installutil myAssembly.exe
Aşağıdaki komut, anahtar ve tam adı kullanarak yükleyici bileşenlerini bir derlemede /AssemblyName yürütür.
installutil /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"
Aşağıdaki komut, dosya adıyla belirtilen bir derlemede ve tanımlayıcı adla belirtilen bir derlemede yükleyici bileşenlerini yürütür. Seçenek geçersiz kılınamayacağından, dosya adıyla belirtilen tüm derlemelerin komut satırında tanımlayıcı adla belirtilen derlemelerin /AssemblyName önüne geçilmesi gerektiğini unutmayın.
installutil myAssembly.exe /AssemblyName "myAssembly, Culture=neutral, PublicKeyToken=0038abc9deabfle5, Version=4.0.0.0"
Aşağıdaki komut, derlemesindeki myAssembly.exekaldırıcı bileşenlerini yürütür.
installutil /u myAssembly.exe
Aşağıdaki komut, ve myAssembly2.exederlemelerinde myAssembly1.exe kaldırıcı bileşenlerini yürütür.
installutil myAssembly1.exe /u myAssembly2.exe
Komut satırındaki /u seçeneğin konumu önemli olmadığından, bu aşağıdaki komutla eşdeğerdir.
installutil /u myAssembly1.exe myAssembly2.exe
Aşağıdaki komut, derlemedeki myAssembly.exe yükleyicileri yürütür ve ilerleme bilgilerinin öğesine myLog.InstallLogyazılacağını belirtir.
installutil /LogFile=myLog.InstallLog myAssembly.exe
Aşağıdaki komut, derlemesindeki myAssembly.exeyükleyicileri yürütür, ilerleme bilgilerinin öğesine yazılması myLog.InstallLoggerektiğini belirtir ve sistem kayıt defterinde güncelleştirmelerin yapılması gerektiğini belirtmek için yükleyicilerin özel /reg seçeneğini kullanır.
installutil /LogFile=myLog.InstallLog /reg=true myAssembly.exe
Aşağıdaki komut, derlemesindeki myAssembly.exeyükleyicileri yürütür, kullanıcının e-posta adresini belirtmek için yükleyicinin özel /email seçeneğini kullanır ve günlük dosyasının çıkışını gizler.
installutil /LogFile= /email=admin@mycompany.com myAssembly.exe
Aşağıdaki komut için myAssembly.exe myLog.InstallLog yükleme ilerleme durumunu yazar ve için myTestAssembly.exe ilerleme durumunu öğesine myTestLog.InstallLogyazar.
installutil /LogFile=myLog.InstallLog myAssembly.exe /LogFile=myTestLog.InstallLog myTestAssembly.exe
