ClickOnce Kullanarak Office Çözümü Dağıtma

Makale
06/10/2015

Dağıtabilirsiniz, Office 2013 veya Office 2010 ClickOnce'ı kullanırsanız, daha az adım çözümde.Güncelleştirmeleri yayımlarsanız, çözümünüz bunları otomatik olarak algılar ve yükler.Bununla birlikte, ClickOnce, çözümünüzü bir bilgisayarın her kullanıcısı için ayrı ayrı yüklemenizi gerektirir.Bu nedenle, aynı bilgisayarda çözümünüzü birden fazla kullanıcı çalıştıracaksa Windows Installer (.msi) kullanmayı düşünmelisiniz.

Bu konuda

ClickOnce'ı kullanarak bir çözüm yayımlama
Çözüme güven vermek istediğiniz nasıl karar
Kullanıcıların çözümü yüklemek Yardım
(Yalnızca belge düzeyi özelleştirmeler) son kullanıcının bilgisayarına bir çözüm belgenin put
SharePoint (yalnızca belge düzeyi özelleştirmeler) çalışan bir sunucuya bir çözüm belgenin put
Özel bir yükleyici oluşturun
Bir güncelleştirme yayımlama
Çözüm yükleme konumunu değiştir
Bir çözüm önceki bir sürümüne geri

Bir Windows Installer dosyası oluşturarak Office çözümünü dağıtma hakkında daha fazla bilgi için Windows Installer Kullanarak Office Çözümü Dağıtma.

Çözümü yayımlama

Çözümünüzün kullanarak yayımlayabilirsiniz Yayımla Sihirbazı veya Proje Tasarımcısı.Bu yordamda, kullanacağınız Proje Tasarımcısı çünkü Yayınlama seçenekleri tam kümesi sağlar.Bakın Yayımlama Sihirbazı (Visual Studio'da Office Geliştirme).

Çözümü yayımlamak için

İçindeki Çözüm Gezgini, projeniz için adlı düğümü seçin.
Menü çubuğunda seçin Proje, ProjectName özellikleri.
İçindeki Proje Tasarımcısı, seçin Yayımlama sekmesi, aşağıda gösterilmiştir.
İçindeki yayımlama klasörü konumu (ftp sunucusu veya dosya yolu) kutusunda, istediğiniz klasörün yolunu girin Proje Tasarımcısı çözüm dosyalarını kopyalamak için.

Aşağıdaki yol türlerinden herhangi birini girebilirsiniz.
- Yerel yol (örneğin, C:\FolderName\FolderName).
- Bir klasöre ağınız üzerindeki bir Evrensel Adlandırma Kuralı (UNC) yolu (örneğin, \\ServerName\FolderName).
- Göreli yolu (örneğin, PublishFolder\, içine proje yayımlanıyor varsayılan olarak klasörü olduğu).
İçindeki yükleme klasörü URL'i kutusuna, son kullanıcıların nerede çözümünüzün konumunun tam yolunu girin.

Konumu henüz bilmiyorsanız, bu alana hiçbir şey girmeyin.Varsayılan olarak, ClickOnce, kullanıcılarınızın çözümü yüklediği klasörde güncelleştirmeleri arar.
Önkoşullar düğmesini seçin.
İçindeki önkoşulları iletişim kutusunda, emin Önkoşul bileşenlerini yüklemek için Kurulum programını oluşturun onay kutusunun seçili.
İçindeki yüklemek için hangi Önkoşullar seçin listesinde, onay kutularını seçin Windows Installer 4.5 ve uygun .NET Framework paketi.

Örneğin, varsa, çözüm hedefleri .NET Framework 4,5, onay kutularını işaretleyin Windows Installer 4.5 ve Microsoft .NET Framework 4.5 tam.
.NET Framework 4.5, çözümünüzün hedefler, ayrıca seçin Office çalışma zamanı için Visual Studio 2010 Araçları onay kutusu.

[!NOT]

Varsayılan olarak bu onay kutusu görünmez.Bu onay kutusunu göstermek için bir Önyükleyici paketi oluşturmanız gerekir.Bakın ile Visual Studio 2012 için Office 2013 VSTO eklenti önyükleyici paket oluşturma.

Altında Önkoşullar için yükleme konumu belirtmek, görünür ve ardından seçin seçeneklerden birini Tamam düğmesine tıklayın.

Aşağıdaki tabloda her bir seçenek açıklanmaktadır.

Seçenek	Açıklama
Bileşen satıcısının web sitesinden önkoşulları	Kullanıcı bu önkoşulları satıcıdan yükleyip istenir.
Uygulamam ile aynı konumdan önkoşulları karşıdan yükleyin	Önkoşul yazılımı çözümle birlikte yüklenir.Bu seçeneği tercih ederseniz, Visual Studio sizin için önkoşul paketlerinin tümünü yayımlama konumuna kopyalar.Bu seçeneğin çalışması için önkoşul paketleri geliştirme bilgisayarında olmalıdır.
Aşağıdaki konumdan önkoşulları karşıdan yükleyin	Visual Studio tüm önkoşul belirttiğiniz konuma kopyalar ve bunları Çözümle yükler.

Bakın Önkoşullar İletişim Kutusu.

Seçin güncelleştirmeleri düğmesini, ne sıklıkta her son kullanıcının eklenti veya güncelleştirmeleri denetlemek ve seçmeniz özelleştirme istediğinizi belirtin Tamam düğmesine tıklayın.

[!NOT]

Bir CD ya da bir çıkarılabilir sürücü kullanarak dağıtma seçin hiçbir zaman güncelleştirmeleri denetlemek için seçenek düğmesi.

Bir güncelleştirme yayımlama hakkında daha fazla bilgi için bkz: bir güncelleştirme yayımlama.
Seçin Seçenekleri düğmesini, seçenekleri gözden Seçenekleri iletişim kutusunu işaretleyin ve sonra seçin Tamam düğmesine tıklayın.
Seçin Şimdi Yayımla düğmesine tıklayın.

Visual Studio bu yordamda belirtilen klasörü yayımlanıyor için aşağıdaki klasörleri ve dosyaları ekler.
- Uygulama dosyaları klasör.
- Kurulum programı.
- En son sürümün dağıtım bildirimine işaret eden bir dağıtım bildirimi.
Uygulama dosyaları yayımlama her sürümü için bir alt klasör içerir.Her bir sürüme özgü alt klasörde aşağıdaki dosyalar bulunur.
- Uygulama bildirimi.
- Dağıtım bildirimi.
- Özelleştirme derlemeleri.
Aşağıdaki resimde bir Outlook eklentisi için yayımlama klasörünün yapısı gösterilmektedir.

[!NOT]

Güvenliği sağlanmış bir Internet Information Services (IIS) yüklemesinin güvenli olmayan bir uzantı nedeniyle dosyaları engellememesi için, ClickOnce derlemelerin sonuna .deploy uzantısını ekler.Kullanıcı çözümü yüklediğinde ClickOnce .deploy uzantısını kaldırır.
Bu yordamda belirtilen yükleme konumu için Çözüm dosyaları kopyalayın.

Çözüme nasıl güven kazandırmak istediğinize karar verme

Bir çözümün kullanıcı bilgisayarları üzerinde çalışması için önce, sizin güven kazandırmanız ya da kullanıcıların çözümü yükledikleri sırada bir güvenlik istemine yanıt vermeleri gerekir.Çözüme güven kazandırmak için, bilinen ve güvenilir bir yayımcıyı tanımlayan bir sertifika kullanarak bildirimleri imzalayın.Bakın Uygulama ve Dağıtım imzalama tarafından çözüm güvenen bildirimlerini.

Belge düzeyinde bir özelleştirmeyi dağıtıyorsanız ve belgeyi kullanıcının bilgisayarında bir klasöre koymak ya da belgeyi bir SharePoint sitesi üzerinde kullanıma sunmak isterseniz, Office'in belge konumunu güvenilir kabul ettiğinden emin olun.Bakın Belgelere Güven Verme.

Kullanıcıların çözümü yüklemesine yardımcı olma

Kullanıcılar kurulum programını çalıştırarak, dağıtım bildirimini açarak veya belge düzeyinde bir özelleştirme olması durumunda belgeyi doğrudan açarak çözümü yükleyebilirler.En iyi uygulama olarak, kullanıcılar çözümünüzü kurulum programını kullanarak yüklemelidir.Diğer iki yaklaşım önkoşul yazılımının yüklenmesini garanti etmez.Kullanıcılar belgeyi yükleme konumundan açmak isterse, Office uygulamasının Güven Merkezi'nde bu konumu güvenilir konumlar listesine eklemeleri gerekir.

Belge düzeyinde bir özelleştirmenin belgesini açma

Kullanıcıların doğrudan yükleme konumu veya yerel bilgisayarlarında belge kopyalama ve kopyalama açarak belge düzeyi özelleştirme belgenin açabilirsiniz.

En iyi uygulama olarak, kullanıcılar belgenin bir kopyasını kendi bilgisayarlarında açmalıdır; böylece birden fazla kullanıcı aynı anda aynı kopyayı açmaya çalışmaz.Bu uygulamayı zorunlu tutmak için, kurulum programınızı, belgeyi kullanıcı bilgisayarlarına kopyalayacak şekilde yapılandırabilirsiniz.Bakın belge son kullanıcılara bilgisayarda (yalnızca belge düzeyi özelleştirmeler) Put.

Bir IIS web sitesinden dağıtım bildirimini açarak çözümü yükleme

Kullanıcılar, web'ten dağıtım bildirimini açmak suretiyle bir Office çözümünü yükleyebilirler.Ancak, güvenliği sağlanmış bir Internet Information Services (IIS) yüklemesi .vsto uzantılı dosyaları engelleyecektir.Bir Office çözümünü IIS kullanarak dağıtabilmeniz için önce MIME türü IIS'de tanımlanmalıdır.

IIS 6.0'a .vsto MIME türünü eklemek için

IIS 6.0 çalıştıran sunucuda seçin Başlat, Tüm Programlar, Yönetim Araçları, Internet Information Services (IIS) Yöneticisi.
Bilgisayar adı seçin Web siteleri klasör veya yapılandırma web sitesi.
Menü çubuğunda seçin Eylem, özellikleri.
Üzerinde HTTP üstbilgilerine sekmesinde, seçin MIME türleri düğmesine tıklayın.
İçindeki MIME türleri penceresinde seçin Yeni düğmesine tıklayın.
İçindeki MIME türü penceresinde girin .vsto uzantısı girin application/x-ms-vsto MIME olarak yazın ve ardından yeni ayarları uygulamak.

[!NOT]

Değişikliklerin etkili olması için, World Wide Web Yayımlama Hizmeti'ni yeniden başlatmalı veya çalışan işleminin tekrar geri dönmesini beklemelisiniz.Bundan sonra tarayıcının disk önbelleğini temizlemeli ve .vsto dosyasını yeniden açmayı denemelisiniz.

IIS 7.0 için .vsto MIME türü eklemek için

IIS 7. 0'ı çalıştıran sunucuda seçin Başlat, Tüm Programlar, Donatılar.
Kısayol menüsünü açmak Komut İstemi, ve sonra seçin yönetici olarak çalıştır.
İçindeki Açık kutusuna aşağıdaki yolu girin ve ardından seçin Tamam düğmesine tıklayın.
```
%windir%\system32\inetsrv 
```
Aşağıdaki komutu girin ve ardından yeni ayarları uygulayın.
```
set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
```
[!NOT]

Değişikliklerin etkili olması için, World Wide Web Yayımlama Hizmeti'ni yeniden başlatmalı veya çalışan işleminin tekrar geri dönmesini beklemelisiniz.Bundan sonra tarayıcının disk önbelleğini temizlemeli ve .vsto dosyasını yeniden açmayı denemelisiniz.

Bir çözümün belgesini son kullanıcının bilgisayarına koyma (yalnızca belge düzeyinde özelleştirmeler)

Çözümünüzün belgesini, bir dağıtım sonrası eylemi kullanarak son kullanıcının bilgisayarına kopyalayabilirsiniz.Böylece, çözümünüzü yükledikten sonra kullanıcı, belgeyi yükleme konumundan kendi bilgisayarına el ile kopyalamak zorunda kalmaz.Dağıtım sonrası eylemi tanımlayan bir sınıf oluşturmanız, çözümü derlemeniz ve yayımlamanız, uygulama bildirimini değiştirmeniz, uygulamayı ve dağıtım bildirimini yeniden imzalamanız gerekecektir.

Aşağıdaki yordamlar, proje adı olduğunu varsayar ExcelWorkbook ve çözümü yayımlama C:\publish bilgisayarınızdaki dizin.

Dağıtım sonrası eylemi tanımlayan bir sınıf oluşturma

Menü çubuğunda, Dosya, Ekle, Yeni Proje seçeneğini belirleyin.
İçindeki Yeni Proje Ekle iletişim kutusunda yüklü şablonlar bölmesinde seçin Windows klasör.
İçindeki şablonları bölmesinde seçin Sınıf Kitaplığı şablonu.
İçindeki adı alanına, FileCopyPDA, ve sonra seçin Tamam düğmesine tıklayın.
İçindeki Çözüm Gezgini, seçin FileCopyPDA proje.
Menü çubuğunda Proje, Başvuru Ekle seçeneğini belirleyin.
Üzerinde .NET sekmesinde, başvuruları Microsoft.VisualStudio.Tools.Applications.Runtime'a ve Microsoft.VisualStudio.Tools.Applications.ServerDocument'a ekleyin.

Sınıf için Yeniden Adlandır FileCopyPDA, ve ardından dosyanın içeriğini kod ile değiştirin.Bu kod aşağıdaki görevleri gerçekleştirir:

Belgeyi kullanıcının masaüstüne kopyalar.
Değişiklikleri _AssemblyLocation göreli bir yol özelliğine dağıtım bildirimi için tam yol.
Kullanıcı çözümü kaldırırsa, dosyayı siler.

Imports Microsoft.VisualStudio.Tools.Applications.Deployment
Imports Microsoft.VisualStudio.Tools.Applications

Public Class FileCopyPDA
    Implements IAddInPostDeploymentAction

    Sub Execute(ByVal args As AddInPostDeploymentActionArgs) Implements IAddInPostDeploymentAction.Execute
        Dim dataDirectory As String = "Data\ExcelWorkbook.xlsx" 
        Dim file As String = "ExcelWorkbook.xlsx" 
        Dim sourcePath As String = args.AddInPath
        Dim deploymentManifestUri As Uri = args.ManifestLocation
        Dim destPath As String = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory)
        Dim sourceFile As String = System.IO.Path.Combine(sourcePath, dataDirectory)
        Dim destFile As String = System.IO.Path.Combine(destPath, file)

        Select Case args.InstallationStatus
            Case AddInInstallationStatus.InitialInstall, AddInInstallationStatus.Update
                System.IO.File.Copy(sourceFile, destFile)
                ServerDocument.RemoveCustomization(destFile)
                ServerDocument.AddCustomization(destFile, deploymentManifestUri)
                Exit Select 
            Case AddInInstallationStatus.Uninstall
                If System.IO.File.Exists(destFile) Then
                    System.IO.File.Delete(destFile)
                End If 
                Exit Select 
        End Select 
    End Sub

using Microsoft.VisualStudio.Tools.Applications.Deployment;
using Microsoft.VisualStudio.Tools.Applications;
using System.IO;

namespace FileCopyPDA
{
    public class FileCopyPDA : IAddInPostDeploymentAction
    {
        public void Execute(AddInPostDeploymentActionArgs args) 
        {
            string dataDirectory = @"Data\ExcelWorkbook.xlsx";
            string file = @"ExcelWorkbook.xlsx";
            string sourcePath = args.AddInPath;
            Uri deploymentManifestUri = args.ManifestLocation;
            string destPath = Environment.GetFolderPath(Environment.SpecialFolder.DesktopDirectory);
            string sourceFile = System.IO.Path.Combine(sourcePath, dataDirectory);
            string destFile = System.IO.Path.Combine(destPath, file);

            switch (args.InstallationStatus)
            {
                case AddInInstallationStatus.InitialInstall:
                case AddInInstallationStatus.Update:
                    File.Copy(sourceFile, destFile);
                    ServerDocument.RemoveCustomization(destFile);
                    ServerDocument.AddCustomization(destFile, deploymentManifestUri);
                    break;
                case AddInInstallationStatus.Uninstall:
                    if (File.Exists(destFile))
                    {
                        File.Delete(destFile);
                    }
                    break;
            }
        }

Çözümü derleme ve yayımlama

İçindeki Çözüm Gezgini, açmak için kısayol menüsünü FileCopyPDA proje ve ardından seçin Yapı.
Kısayol menüsünü açmak ExcelWorkbook proje ve ardından seçin Yapı.
Kısayol menüsünü açmak ExcelWorkbook proje ve ardından seçin Başvuru Ekle.
İçindeki Başvuru Ekle iletişim kutusunda projeleri sekmesinde, seçin FileCopyPDA, ve ardından seçin Tamam düğmesine tıklayın.
İçindeki Çözüm Gezgini, seçin ExcelWorkbook proje.
Menü çubuğunda seçin Proje, Yeni klasör.
Data sözcüğünü girin ve ardından Enter tuşuna basın.
İçindeki Çözüm Gezgini, seçin veri klasör.
Menü çubuğunda seçin Proje, Varolan Öğe Ekle.
İçindeki Varolan Öğe Ekle iletişim kutusunda, için çıktı dizini göz atın ExcelWorkbook seçin, proje ExcelWorkbook.xlsx dosya ve ardından seçin Ekle düğmesine tıklayın.
İçindeki Çözüm Gezgini seçin ExcelWorkbook.xlsx dosya.
İçindeki özellikleri penceresinde değişiklik Yapı eylemi özelliğini İçerik ve Çıkış dizine kopyalayın özelliğini yeniyse kopyalamak.

Bu adımları tamamladığınızda projeniz aşağıdaki gösterimi andıracaktır.
Yayımlama ExcelWorkbook proje.

Uygulama bildiriminde değişiklik yapma

Açık c:\publish kullanarak dizin Dosya Gezgini.
Açık Uygulama dosyaları sürümü, çözümünüzün yayımlanan klasör ve en son karşılık gelen klasörü açın.
Açık ExcelWorkbook.dll.manifest Notepad gibi bir metin düzenleyicisi dosyasında.

Sonra </vstav3:update> öğesi kodu ekleyin.Sınıf özniteliği için <vstav3:entryPoint> öğesi, aşağıdaki sözdizimini kullanın: İsimUzayıAdı.SınıfAdı.Elde edilen giriş noktası adı için aşağıdaki örnekte, ad alanı ve sınıf adları aynıdır FileCopyPDA.FileCopyPDA.

<vstav3:postActions>
  <vstav3:postAction>
    <vstav3:entryPoint
      class="FileCopyPDA.FileCopyPDA">
      <assemblyIdentity
        name="FileCopyPDA"
        version="1.0.0.0"
        language="neutral"
        processorArchitecture="msil" />
    </vstav3:entryPoint>
    <vstav3:postActionData>
    </vstav3:postActionData>
  </vstav3:postAction>
</vstav3:postActions>

Uygulama ve dağıtım bildirimlerini yeniden imzalama

İçindeki %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook klasörü, kopyalama ExcelWorkbook_TemporaryKey.pfx içine yapıştırın ve sertifika dosyası yayınklasörü \Application Files\ExcelWorkbookMostRecentPublishedVersion klasör.
Visual Studio komut istemini açın ve ardından dizinleri Değiştir c:\publish\Application Files\ExcelWorkbookMostRecentPublishedVersion klasörü (örneğin, c:\publish\Application Files\ExcelWorkbook_1_0_0_4).
Aşağıdaki komutu çalıştırarak değiştirilmiş uygulama bildirimini imzalayın:
```
mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
```
"ExcelWorkbook.dll.manifest başarıyla imzalandı" iletisi görüntülenir.
Değiştirin c:\publish klasörü ve ardından güncelleştirme ve oturum dağıtım bildirim aşağıdaki komutu çalıştırarak:
```
mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
```
[!NOT]

Önceki örnekte MostRecentVersionNumber çözümünüzün yayımlanan en son sürümünün sürüm numarası ile değiştirmek (örneğin, 1_0_0_4).

"ExcelWorkbook.vsto başarıyla imzalandı" iletisi görüntülenir.
ExcelWorkbook.vsto dosyaya kopyalamak c:\publish\Application Files\ExcelWorkbookMostRecentVersionNumber dizini.

Bir çözümün belgesini SharePoint çalıştıran bir sunucuya koyma (yalnızca belge düzeyinde özelleştirmeler)

Belge düzeyinde özelleştirmenizi SharePoint kullanarak son kullanıcılara yayımlayabilirsiniz.Kullanıcılar SharePoint sitesine gidip belgeyi açtığında, çalışma zamanı çözümü paylaşılan ağ klasöründen kullanıcının yerel bilgisayarına otomatik olarak yükler.Çözüm yerel olarak yüklendikten sonra, belge başka bir yere (örneğin, masaüstüne) kopyalansa bile özelleştirme işlevini yerine getirmeye devam eder.

Belgeyi SharePoint çalıştıran bir sunucuya koymak için

Çözüm belgesini SharePoint sitesindeki bir belge kitaplığına ekleyin.
Aşağıdaki yaklaşımlardan biri için adımları uygulayın:
- SharePoint çalıştıran sunucuyu, tüm bilgisayarlarda Word veya Excel'deki Güven Merkezi'ne eklemek için Office Yapılandırma Aracı'nı kullanın.
  
  Bakın güvenlik ilkeleri ve Office 2010 ayarları.
- Her kullanıcının aşağıdaki adımları uygulamasını sağlayın.
  1. Yerel bilgisayarda, açık Word veya Excel seçin Dosya sekmesini tıklatın ve ardından seçin Seçenekleri düğmesine tıklayın.
  2. İçindeki Güven Merkezi iletişim kutusunda Güvenilen Konumlar düğmesine tıklayın.
  3. Seçin güvenilir konumlara izin ver (önerilmez) ağı onay kutusunu işaretleyin ve sonra seçin Yeni konumu Ekle düğmesine tıklayın.
  4. İçindeki yolu kutusunda, karşıya yüklediğiniz belgeyi içeren SharePoint belge kitaplığı URL'si girin (örneğin, http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName).
    
    Varsayılan Web sayfasının adını eklemeyin (default.aspx veya AllItems.aspx gibi).
  5. Seçin Bu konumun alt klasörleri güvenilir de onay kutusunu işaretleyin ve sonra seçin Tamam düğmesine tıklayın.
    
    Kullanıcılar belgeyi SharePoint sitesinden açtığında, belge açılır ve özelleştirme yüklenir.Kullanıcılar belgeyi kendi masaüstlerine kopyalayabilir.Belgedeki özellikler belgenin ağ konumuna işaret ettiğinden, özelleştirme çalışmaya devam edecektir.

Özel bir yükleyici oluşturma

Çözümü yayımladığınızda sizin için oluşturulan kurulum programını kullanmak yerine, Office çözümünüz için özel bir yükleyici oluşturabilirsiniz.Örneğin, yüklemeyi başlatmak için bir oturum açma komut dosyası kullanabilir veya çözümü, kullanıcı etkileşimi olmadan yüklemek için bir toplu iş dosyası kullanabilirsiniz.Bu senaryolar en çok, önkoşullar son kullanıcı bilgisayarlarında zaten yüklü olduğunda işe yarar.

Özel yükleme işleminin bir parçası şu konumda varsayılan olarak yüklenen Office çözümleri (VSTOInstaller.exe) için yükleyici aracını çağırırsınız.

%commonprogramfiles%\microsoft shared\VSTO\10.0\VSTOInstaller.exe

Araç bu konumda yoksa, HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath veya HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath kayıt defteri anahtarını kullanarak bu aracın yolunu bulabilirsiniz.

VSTOinstaller.exe ile birlikte aşağıdaki parametreleri kullanabilirsiniz.

ParameTRe	Tanım
/Install veya /I	Çözümü yükler.Bu seçeneğin ardından bir dağıtım bildiriminin konumunu vermelisiniz.Yerel bilgisayarda bulunan bir Evrensel Adlandırma Kuralı (UNC) dosya paylaşımı yolu belirtebilirsiniz.Yerel yol belirtebilirsiniz (C:\FolderName\PublishFolder), göreli bir yol (Publish\), veya tam bir konum (\\ServerName\FolderName veya https://ServerName/KlasörAdı).
/Uninstall veya /U	Çözümü kaldırır.Bu seçeneğin ardından bir dağıtım bildiriminin konumunu vermelisiniz.Bir yol yerel bilgisayarda bulunan bir UNC dosya paylaşımı olabilir belirtebilirsiniz.Yerel yol belirtebilirsiniz (c:\FolderName\PublishFolder), göreli bir yol (Publish\), veya tam bir konum (\\ServerName\FolderName veya https://ServerName/KlasörAdı).
/Silent veya /S	Kullanıcıdan bir şey girmesini istemeden veya ileti görüntülemeden yükler veya kaldırır.Güven istemi gerekiyorsa, özelleştirme yüklenmez ya da güncelleştirilmez.
/Help veya /?	Yardım bilgilerini görüntüler.

VSTOinstaller.exe dosyasını çalıştırdığınızda aşağıdaki hata kodları görünebilir.

Hata Kodu	Tanım
0	Çözüm başarıyla yüklendi ya da kaldırıldı veya VSTOInstaller Yardımı görüntülendi.
-100	Bir veya daha fazla komut satırı seçeneği geçerli değil veya bir kereden fazla ayarlandı.Daha fazla bilgi için girin "vstoinstaller /?" veya bakın Özel yükleyici ClickOnce Office çözüm oluşturma.
-101	Bir veya daha fazla komut satırı seçeneği geçerli değil.Daha fazla bilgi için "vstoinstaller /?" girin.
-200	Dağıtım bildirimi URI'si geçerli değil.Daha fazla bilgi için "vstoinstaller /?" girin.
-201	Dağıtım bildirimi geçerli olmadığından çözüm yüklenemedi.Bakın Office Çözümleri İçin Dağıtım Bildirimleri.
-202	Uygulama bildiriminin Office için Visual Studio Araçları bölümü geçerli olmadığından çözüm yüklenemedi.Bakın Office Çözümleri İçin Uygulama Bildirimleri.
-203	Bir indirme hatası oluştuğundan çözüm yüklenemedi.Dağıtım bildiriminin URI'sini veya ağ dosya konumunu denetleyin ve sonra yeniden deneyin.
-300	Bir güvenlik özel durumu oluştuğundan çözüm yüklenemedi.Bakın Office Çözümleri Güvenliğini Sağlama.
-400	Çözüm yüklenemedi.
-401	Çözüm kaldırılması uygulanamadı.
-500	Çözüm yüklenemediğinden ya da kaldırılamadığından veya dağıtım bildirimi indirilemediğinden işlem iptal edildi.

Güncelleştirme yayımlama

Bir çözüm güncelleştirmek için yeniden kullanarak yayımlamadan Proje Tasarımcısı veya Yayımla Sihirbazı, ve sonra güncelleştirilmiş çözüm yükleme konumuna kopyalayın.Dosyaları yükleme konumuna kopyalarken, önceki dosyaların üzerine yazdığınızdan emin olun.

Çözüm, güncelleştirmeleri bir sonraki denetleyişinde otomatik olarak yeni sürümü bulup yükleyecektir.

Çözümün yükleme konumunu değiştirme

Bir çözüm yayımlandıktan sonra yükleme yolunu ekleyebilir veya değiştirebilirsiniz.Yükleme yolunu değiştirmek istemenizin nedeni şunlardan biri veya daha fazlası olabilir:

Kurulum programı, henüz yükleme yolu bilinmezken derlenmiştir.
Çözüm dosyaları farklı bir konuma kopyalanmıştır.
Yükleme dosyalarını barındıran sunucu yeni bir ada veya konuma sahiptir.

Bir çözümün yükleme yolunu değiştirmek için kurulum programını güncelleştirmelisiniz; daha sonra da kullanıcıların bunu çalıştırması gerekir.Belge düzeyinde özelleştirmeler için, kullanıcıların ayrıca belgelerindeki bir özelliği de yeni konuma işaret edecek şekilde güncelleştirmeleri gerekir.

[!NOT]

Kullanıcılardan belge özelliklerini güncelleştirmelerini talep etmek istemiyorsanız, güncelleştirilen belgeyi yükleme konumundan almalarını isteyebilirsiniz.

Kurulum programındaki yükleme konumunu değiştirmek için

Açık bir Komut İstemi penceresi ve yükleme klasörü değişiklik dizinler.
Kurulum programı çalıştırın ve şunları /url parametresi, yeni yükleme yolu bir dize olarak alır.

Aşağıdaki örnekte, Fabrikam web sitesindeki bir konumun yükleme yolunun nasıl değiştirileceği gösterilmektedir; ancak siz bu URL'yi istediğiniz yol ile değiştirebilirsiniz:
```
setup.exe /url="http://www.fabrikam.com/newlocation"
```
[!NOT]

Bir ileti ekrana gelir ve yürütülebilir öğenin imzasının geçersiz kılınacağını belirtirse, çözümü imzalamak için kullanılan sertifika artık geçerli değil ve yayımcısı bilinmiyor demektir.Sonuç olarak, kullanıcıların, çözümü yüklemeden önce çözümün kaynağına güvendiklerini onaylamaları gerekecektir.

[!NOT]

URL geçerli değeri görüntülemek için Çalıştır setup.exe /url.

Belge düzeyi özelleştirmeler için kullanıcılar gerekir belgeyi açın ve ardından güncelleştirme kendi _AssemblyLocation özelliği.Aşağıdaki adımlarda kullanıcıların bu görevi nasıl yerine getirecekleri açıklanmaktadır.

Bir belgede _AssemblyLocation özelliğini güncelleştirmek için

Üzerinde Dosya sekmesinde, seçin bilgisi, hangi aşağıda gösterilmiştir.
İçindeki özellikleri listesinde, seçin Gelişmiş Özellikler, hangi aşağıda gösterilmiştir.
Üzerinde özel sekmesinde özellikleri listesinde, seçin _AssemblyLocation, aşağıdaki resimde gösterildiği gibi.

Değeri kutusu dağıtım bildirim tanımlayıcısını içerir.
Tanımlayıcı önce biçiminde bir çubuğu tarafından izlenen belgenin tam yolu girin yolu |Tanımlayıcısı (örneğin, File://ServerName/FolderName/FileName |74744e4b-e4d6-41eb-84f7-ad20346fe2d9.

Bu tanımlayıcı biçimlendirme hakkında daha fazla bilgi için Özel Belge Özelliklerine Genel Bakış.
Seçin Tamam button, kaydedin ve belgeyi kapatın.
Çözümü belirtilen konuma yüklemek için, kurulum programını /url parametresi olmadan çalıştırın.

Çözümü önceki bir sürüme geri alma

Bir çözüm geri olduğunda, bu çözümün önceki bir sürümünü kullanıcılara geri döndürün.

Bir çözümü geri almak için

Çözümün yükleme konumunu açın.
En üst düzey publish klasöründe dağıtım bildirimini (.vsto dosyası) silin.
Geri almak istediğiniz sürüme ait alt klasörü bulun.
O alt klasördeki dağıtım bildirimini üst düzey publish klasörüne kopyalayın.

Örneğin, bir çözüm çağrılan geri dönmek için OutlookAddIn1 sürümden 1.0.0.1 1.0.0.0 sürümü için dosya Kopyala OutlookAddIn1.vsto öğesinden Outlookaddın1_1_0_0_0 klasör.Dosyayı üst düzey Yapıştır yayımlamak için sürüme özgü dağıtım bildirimini üzerine klasör, Outlookadın1_1_0_0_1 idi zaten var..

Aşağıdaki resimde, bu örnekteki publish (yayımlama) klasörü yapısı gösterilmektedir.

Kullanıcının uygulamayı ya da özelleştirilmiş belgeyi bir sonraki açışında, dağıtım bildirimindeki değişiklik algılanır.Office çözümünün önceki sürümü ClickOnce önbelleğinden çalışır.

[!NOT]

Yerel veriler çözümün sadece bir önceki sürümü için kaydedilir.İki sürüm geri alırsanız, yerel veriler korunmaz.Yerel veri hakkında daha fazla bilgi için ClickOnce Uygulamalarında Yerel ve Uzak Veri Erişimi.