Bereitstellen einer Office-Lösung mithilfe von ClickOnce

Sie können Ihre Office-Lösung in weniger Schritten bereitstellen, wenn Sie ClickOnce verwenden. Wenn Sie Updates veröffentlichen, erkennt und installiert Ihre Lösung diese automatisch. ClickOnce erfordert jedoch, dass Sie Ihre Lösung für jeden Benutzer eines Computers separat installieren. Daher sollten Sie windows Installer (.msi) verwenden, wenn mehrere Benutzer Ihre Lösung auf demselben Computer ausführen.

Inhalt

• Veröffentlichen der Lösung

• Entscheiden Sie, wie Sie der Lösung Vertrauen gewähren möchten

• Benutzer bei der Installation der Lösung unterstützen

• Platzieren Sie das Dokument einer Lösung auf dem Computer des Endbenutzers (nur Anpassungen auf Dokumentebene)

• Platzieren Sie das Dokument einer Lösung auf einem Server, auf dem SharePoint ausgeführt wird (nur Anpassungen auf Dokumentebene)

• Erstellen eines benutzerdefinierten Installationsprogramms

• Veröffentlichen eines Updates

• Ändern des Installationsorts einer Lösung

• Zurücksetzen einer Lösung auf eine frühere Version

  Weitere Informationen zum Bereitstellen einer Office-Lösung durch Erstellen einer Windows Installer-Datei finden Sie unter Bereitstellen einer Office-Lösung mithilfe von Windows Installer.

Lösung veröffentlichen

Sie können Ihre Lösung mithilfe des Veröffentlichungs-Assistenten oder des Project-Designers veröffentlichen. In diesem Verfahren verwenden Sie den Project Designer , da er den vollständigen Satz von Veröffentlichungsoptionen bereitstellt. Siehe Assistent zum Veröffentlichen (Office-Entwicklung in Visual Studio)

So veröffentlichen Sie die Lösung

1. Wählen Sie im Projektmappen-Explorer den Knoten aus, der für Ihr Projekt benannt ist.

2. Wählen Sie auf der Menüleiste "Project", "ProjectName-Eigenschaften" aus.

3. Wählen Sie im Project Designer die Registerkarte " Veröffentlichen " aus, die in der folgenden Abbildung dargestellt wird.

   

4. Geben Sie im Feld " Speicherort des Veröffentlichungsordners" (FTP-Server oder Dateipfad) den Pfad des Ordners ein, in den der Project Designer die Lösungsdateien kopieren soll.

   Sie können einen der folgenden Pfadtypen eingeben.

   • Ein lokaler Pfad (z. B. C:\FolderName\FolderName).

   • Ein UNC-Pfad (Uniform Naming Convention) zu einem Ordner in Ihrem Netzwerk (z. B. \\ServerName\FolderName).

   • Ein relativer Pfad (z. B. PublishFolder\, bei dem es sich um den Ordner handelt, in dem das Projekt standardmäßig veröffentlicht wird).

5. Geben Sie im Feld "URL des Installationsordners " den vollqualifizierten Pfad des Speicherorts ein, an dem Endbenutzer Ihre Lösung finden.

   Wenn Sie die Position noch nicht kennen, geben Sie nichts in dieses Feld ein. ClickOnce sucht standardmäßig nach Updates im Ordner, aus dem Ihre Benutzer die Lösung installieren.

6. Wählen Sie die Schaltfläche "Voraussetzungen" aus.

7. Stellen Sie im Dialogfeld "Voraussetzungen " sicher, dass das Kontrollkästchen " Setupprogramm zum Installieren der erforderlichen Komponenten erstellen" aktiviert ist.

8. Aktivieren Sie in der Liste " Auswählen der erforderlichen Komponenten " die Kontrollkästchen für Windows Installer 4.5 und das entsprechende .NET Framework-Paket.

   Wenn Ihre Lösung beispielsweise auf .NET Framework 4.5 ausgerichtet ist, aktivieren Sie die Kontrollkästchen für Windows Installer 4.5 und Microsoft .NET Framework 4.5 Full.

9. Wenn Ihre Lösung auf .NET Framework 4.5 ausgerichtet ist, aktivieren Sie auch das Kontrollkästchen Visual Studio 2010 Tools for Office Runtime .

   Hinweis

   Dieses Kontrollkästchen wird standardmäßig nicht angezeigt. Um dieses Kontrollkästchen anzuzeigen, müssen Sie ein Bootstrapper-Paket erstellen. Siehe Erstellen eines Bootstrapperpakets für ein Office 2013 VSTO-Add-In mit Visual Studio 2012.

10. Unter "Installationsspeicherort für erforderliche Komponenten angeben" wählen Sie eine der angezeigten Optionen aus und klicken Sie dann auf die Schaltfläche OK.

    In der folgenden Tabelle sind die einzelnen Optionen beschrieben.

    Option	Description
    Herunterladen der Voraussetzungen von der Website des Komponentenanbieters	Der Benutzer wird aufgefordert, diese Erforderlichen vom Anbieter herunterzuladen und zu installieren.
    Herunterladen von Voraussetzungen vom selben Speicherort wie meine Anwendung	Die erforderliche Software wird mit der Lösung installiert. Wenn Sie diese Option auswählen, kopiert Visual Studio alle erforderlichen Pakete an den Veröffentlichungsort für Sie. Damit diese Option funktioniert, müssen sich die erforderlichen Pakete auf dem Entwicklungscomputer befinden.
    Laden Sie die Voraussetzungen von folgender Stelle herunter	Visual Studio kopiert alle erforderlichen Pakete an den von Ihnen angegebenen Speicherort, und installiert sie mit der Lösung.

    Siehe Dialogfeld "Voraussetzungen".

11. Wählen Sie die Schaltfläche "Updates " aus, geben Sie an, wie oft das VSTO-Add-In oder die Anpassung jedes Endbenutzers nach Updates suchen soll, und wählen Sie dann die Schaltfläche "OK " aus.

    Hinweis

    Wenn Sie eine CD oder ein Wechseldatenträger verwenden, wählen Sie die Optionsschaltfläche Nie auf Updates überprüfen aus.

    Informationen zum Veröffentlichen eines Updates finden Sie unter Veröffentlichen eines Updates.

12. Wählen Sie die Schaltfläche "Optionen " aus, überprüfen Sie die Optionen im Dialogfeld "Optionen ", und wählen Sie dann die Schaltfläche "OK " aus.

13. Klicken Sie auf die Schaltfläche " Jetzt veröffentlichen ".

    Visual Studio fügt dem Veröffentlichungsordner, den Sie weiter oben in diesem Verfahren angegeben haben, die folgenden Ordner und Dateien hinzu.

    • Der Ordner "Anwendungsdateien ".

    • Das Setupprogramm.

    • Ein Bereitstellungsmanifest, das auf das Bereitstellungsmanifest der neuesten Version verweist.

      Der Ordner "Anwendungsdateien" enthält einen Unterordner für jede version, die Sie veröffentlichen. Jeder versionsspezifische Unterordner enthält die folgenden Dateien.

    • Ein Anwendungsmanifest.

    • Ein Bereitstellungsmanifest.

    • Anpassungsbaugruppen.

      Die folgende Abbildung zeigt die Struktur des Veröffentlichungsordners für ein Outlook-VSTO-Add-In.

      

    Hinweis

    ClickOnce fügt die .deploy-Erweiterung an Assemblys an, sodass eine gesicherte Installation von Internet Information Services (IIS) die Dateien aufgrund einer unsicheren Erweiterung nicht blockiert. Wenn der Benutzer die Lösung installiert, entfernt ClickOnce die Deploy-Erweiterung .

14. Kopieren Sie die Lösungsdateien an den Installationsspeicherort, den Sie weiter oben in diesem Verfahren angegeben haben.

Entscheiden Sie, wie Sie der Lösung Vertrauen gewähren möchten

Bevor eine Lösung auf Benutzercomputern ausgeführt werden kann, müssen Sie entweder vertrauen, oder Benutzer müssen auf eine Vertrauensaufforderung reagieren, wenn sie die Lösung installieren. Um der Lösung eine Vertrauensstellung zu gewähren, signieren Sie die Manifeste mithilfe eines Zertifikats, das einen bekannten und vertrauenswürdigen Herausgeber identifiziert. Sehen Sie sich die Lösung als vertrauenswürdig an, indem Sie die Anwendungs- und Bereitstellungsmanifeste signieren.

Wenn Sie eine Anpassung auf Dokumentebene bereitstellen und das Dokument in einen Ordner auf dem Computer des Benutzers einfügen oder das Dokument auf einer SharePoint-Website verfügbar machen möchten, stellen Sie sicher, dass Office dem Speicherort des Dokuments vertraut. Siehe Vertrauen zu Dokumenten gewähren.

Benutzer bei der Installation der Lösung unterstützen

Benutzer können die Lösung installieren, indem Sie das Setupprogramm ausführen, das Bereitstellungsmanifest öffnen oder während der Anpassung auf Dokumentebene das Dokument direkt öffnen. Als bewährte Methode sollten Benutzer Ihre Lösung mithilfe des Setupprogramms installieren. Die anderen beiden Ansätze stellen nicht sicher, dass die erforderliche Software installiert ist. Wenn Benutzer das Dokument vom Installationsspeicherort aus öffnen möchten, müssen sie es der Liste der vertrauenswürdigen Speicherorte im Trust Center der Office-Anwendung hinzufügen.

Öffnen des Dokuments einer Dokumentebenenanpassung

Benutzer können das Dokument einer Anpassung auf Dokumentebene direkt vom Installationsspeicherort aus öffnen oder das Dokument auf ihren lokalen Computer kopieren und dann die Kopie öffnen.

Als bewährte Methode sollten Benutzer eine Kopie des Dokuments auf ihren Computern öffnen, sodass mehrere Benutzer nicht versuchen, dieselbe Kopie gleichzeitig zu öffnen. Um diese Vorgehensweise zu erzwingen, können Sie Ihr Setupprogramm so konfigurieren, dass das Dokument auf Benutzercomputer kopiert wird. Siehe Dokument einer Lösung auf dem Computer des Endbenutzers ablegen (nur Anpassungen auf Dokumentebene).

Installieren Sie die Lösung, indem Sie das Bereitstellungsmanifest auf einer IIS-Website öffnen.

Benutzer können eine Office-Lösung installieren, indem Sie das Bereitstellungsmanifest aus dem Web öffnen. Eine gesicherte Installation von Internetinformationsdienste (INTERNET Information Services, IIS) blockiert jedoch Dateien mit der Erweiterung VSTO . Der MIME-Typ muss in IIS definiert werden, bevor Sie eine Office-Lösung mithilfe von IIS bereitstellen können.

So fügen Sie den VSTO-MIME-Typ zu IIS 6.0 hinzu

1. Wählen Sie auf dem Server, auf dem IIS 6.0 ausgeführt wird, Start>Alle Programme>Verwaltung>Internetinformationsdienste (IIS) Manager.

2. Wählen Sie den Computernamen, den Ordner "Websites " oder die Website aus, die Sie konfigurieren.

3. Wählen Sie auf der Menüleiste "Aktionseigenschaften>" aus.

4. Wählen Sie auf der Registerkarte "HTTP-Header" die Schaltfläche "MIME-Typen " aus.

5. Wählen Sie im Fenster "MIME-Typen " die Schaltfläche " Neu " aus.

6. Geben Sie im MIME-Typfenster.vsto als Erweiterung ein, geben Sie "application/x-ms-vsto " als MIME-Typ ein, und wenden Sie dann die neuen Einstellungen an.

   Hinweis

   Damit die Änderungen wirksam werden, müssen Sie den World Wide Web Publishing Service neu starten oder warten, bis der Arbeitsprozess neu gestartet wird. Anschließend müssen Sie den Datenträgercache des Browsers leeren und dann erneut versuchen, die VSTO-Datei zu öffnen.

So fügen Sie den VSTO-MIME-Typ zu IIS 7.0 hinzu

1. Wählen Sie auf dem Server, auf dem IIS 7.0 ausgeführt wird, Start>Alle Programme>Zubehör.

2. Öffnen Sie das Kontextmenü für die Eingabeaufforderung, und wählen Sie dann "Als Administrator ausführen" aus.

3. Geben Sie im Feld "Öffnen" den folgenden Pfad ein, und wählen Sie dann die Schaltfläche "OK " aus.

   %windir%\system32\inetsrv
   

4. Geben Sie den folgenden Befehl ein, und wenden Sie dann die neuen Einstellungen an.

   set config /section:staticContent /+[fileExtension='.vsto',mimeType='application/x-ms-vsto']
   

   Hinweis

   Damit die Änderungen wirksam werden, müssen Sie den World Wide Web Publishing Service neu starten oder warten, bis der Worker-Prozess neu gestartet wird. Anschließend müssen Sie den Datenträgercache des Browsers leeren und dann erneut versuchen, die VSTO-Datei zu öffnen.

Platzieren Sie das Dokument einer Lösung auf dem Computer des Endbenutzers (nur Anpassungen auf Dokumentebene)

Sie können das Dokument Ihrer Lösung auf den Computer des Endbenutzers kopieren, indem Sie eine Aktion nach der Bereitstellung erstellen. Auf diese Weise muss der Benutzer das Dokument nach der Installation der Lösung nicht manuell vom Installationsspeicherort auf seinen Computer kopieren. Sie müssen eine Klasse erstellen, die die Aktion nach der Bereitstellung definiert, die Lösung erstellen und veröffentlichen, das Anwendungsmanifest ändern und das Anwendungs- und Bereitstellungsmanifest erneut signieren.

Bei den folgenden Verfahren wird davon ausgegangen, dass ihr Projektname ExcelWorkbook ist und Sie die Lösung in einem erstellten Ordner mit dem Namen "C:\publish " auf Ihrem Computer veröffentlichen.

Erstellen einer Klasse, die die Aktion nach der Bereitstellung definiert

1. Wählen Sie in der Menüleiste Datei>Hinzufügen>Neues Projekt aus.

2. Wählen Sie im Dialogfeld " Neues Projekt hinzufügen " im Bereich "Installierte Vorlagen " den Ordner "Windows" aus.

3. Wählen Sie im Bereich "Vorlagen " die Vorlage " Klassenbibliothek " aus.

4. Geben Sie im Feld "Name" FileCopyPDA ein, und wählen Sie dann die Schaltfläche "OK" aus.

5. Wählen Sie im Projektmappen-Explorer das FileCopyPDA-Projekt aus.

6. Wählen Sie auf der Menüleiste "Projektverweis> hinzufügen" aus.

7. Fügen Sie auf der Registerkarte .NET Verweise auf Microsoft.VisualStudio.Tools.Applications.Runtime und Microsoft.VisualStudio.Tools.Applications.ServerDocument.

8. Benennen Sie die Klasse in FileCopyPDA, und ersetzen Sie dann den Inhalt der Datei durch den Code. Dieser Code führt die folgenden Aufgaben aus:

   • Kopiert das Dokument auf den Desktop des Benutzers.

   • Ändert die _AssemblyLocation-Eigenschaft von einem relativen Pfad zu einem vollqualifizierten Pfad für das Bereitstellungsmanifest.

   • Löscht die Datei, wenn der Benutzer die Lösung deinstalliert.

     • C#
     • VB

     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;
                 }
             }
         }
     }
     

   ---

Erstellen und Veröffentlichen der Lösung

1. Öffnen Sie im Projektmappen-Explorer das Kontextmenü für das FileCopyPDA-Projekt , und wählen Sie dann "Erstellen" aus.

2. Öffnen Sie das Kontextmenü für das ExcelWorkbook-Projekt , und wählen Sie dann "Erstellen" aus.

3. Öffnen Sie das Kontextmenü für das ExcelWorkbook-Projekt , und wählen Sie dann "Verweis hinzufügen" aus.

4. Wählen Sie im Dialogfeld " Verweis hinzufügen " die Registerkarte "Projekte " und dann " FileCopyPDA" und dann die Schaltfläche "OK " aus.

5. Wählen Sie im Projektmappen-Explorer das ExcelWorkbook-Projekt aus.

6. Wählen Sie auf der Menüleiste "Projekt>neuer Ordner" aus.

7. Geben Sie Daten ein, und wählen Sie dann die EINGABETASTE aus.

8. Wählen Sie im Projektmappen-Explorer den Ordner "Daten " aus.

9. Wählen Sie in der Menüleiste "Projekt>Vorhandenes Element hinzufügen" aus.

10. Navigieren Sie im Dialogfeld " Vorhandenes Element hinzufügen " zum Ausgabeverzeichnis für das ExcelWorkbook-Projekt , wählen Sie die ExcelWorkbook.xlsx Datei aus, und klicken Sie dann auf die Schaltfläche "Hinzufügen ".

11. Wählen Sie im Projektmappen-Explorer die ExcelWorkbook.xlsx Datei aus.

12. Ändern Sie im Eigenschaftenfenster die Eigenschaft "Buildaktion" in "Inhalt" und die Eigenschaft "In Ausgabeverzeichnis kopieren" in "Kopieren, wenn neuer".

    Wenn Sie diese Schritte abgeschlossen haben, ähnelt Ihr Projekt der folgenden Abbildung.

    

13. Veröffentlichen Sie das ExcelWorkbook-Projekt .

Ändern des Anwendungsmanifests

1. Öffnen Sie das Projektmappenverzeichnis "c:\publish" mithilfe des Datei-Explorers.

2. Öffnen Sie den Ordner "Anwendungsdateien ", und öffnen Sie dann den Ordner, der der neuesten veröffentlichten Version Ihrer Lösung entspricht.

3. Öffnen Sie die Datei ExcelWorkbook.dll.manifest in einem Text-Editor wie Notepad (Editor).

4. Fügen Sie nach dem </vstav3:update> Element den folgenden Code hinzu. Verwenden Sie für das Klassenattribute des <vstav3:entryPoint> Elements die folgende Syntax: NamespaceName.ClassName. Im folgenden Beispiel sind die Namespace- und Klassennamen identisch, sodass der resultierende Einstiegspunktname lautet 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>
   

Erneutes Signieren der Anwendungs- und Bereitstellungsmanifesten

1. Kopieren Sie im Ordner %USERPROFILE%\Documents\Visual Studio 2013\Projects\ExcelWorkbook\ExcelWorkbook die Zertifikatdatei ExcelWorkbook_TemporaryKey.pfx , und fügen Sie sie dann in den Ordner PublishFolder\Application Files\ExcelWorkbook_MostRecentPublishedVersion ein.

2. Öffnen Sie die Visual Studio-Eingabeaufforderung, und ändern Sie dann verzeichnisse in den Ordner "c:\publish\Application Files\ExcelWorkbook_MostRecentPublishedVersion " (z. B. "c:\publish\Application Files\ExcelWorkbook_1_0_0_4").

3. Signieren Sie das geänderte Anwendungsmanifest, indem Sie den folgenden Befehl ausführen:

   mage -sign ExcelWorkbook.dll.manifest -certfile ExcelWorkbook_TemporaryKey.pfx
   

   Die Meldung "ExcelWorkbook.dll.manifest erfolgreich signiert" wird angezeigt.

4. Wechseln Sie zum Ordner "c:\publish ", und aktualisieren Sie das Bereitstellungsmanifest, und signieren Sie es, indem Sie den folgenden Befehl ausführen:

   mage -update ExcelWorkbook.vsto -appmanifest "Application Files\Ex
   celWorkbookMostRecentVersionNumber>\ExcelWorkbook.dll.manifest" -certfile "Application Files\ExcelWorkbookMostRecentVersionNumber>\ExcelWorkbook_TemporaryKey.pfx"
   

   Hinweis

   Ersetzen Sie im vorherigen Beispiel MostRecentVersionNumber durch die Versionsnummer der zuletzt veröffentlichten Version Ihrer Lösung (z. B. 1_0_0_4).

   Die Meldung "ExcelWorkbook.vsto erfolgreich signiert" wird angezeigt.

5. Kopieren Sie die Datei "ExcelWorkbook.vsto " in das Verzeichnis "c:\publish\Application Files\ExcelWorkbook_MostRecentVersionNumber ".

Platzieren Sie das Dokument einer Lösung auf einem Server, auf dem SharePoint ausgeführt wird (nur Anpassungen auf Dokumentebene)

Sie können Ihre Anpassung auf Dokumentebene mithilfe von SharePoint für Endbenutzer veröffentlichen. Wenn Benutzer zur SharePoint-Website wechseln und das Dokument öffnen, installiert die Laufzeit die Lösung automatisch aus dem freigegebenen Netzwerkordner auf dem lokalen Computer des Benutzers. Nachdem die Lösung lokal installiert wurde, funktioniert die Anpassung auch dann weiterhin, wenn das Dokument an eine andere Stelle kopiert wird, z. B. den Desktop.

So platzieren Sie das Dokument auf einem Server, auf dem SharePoint ausgeführt wird

1. Fügen Sie das Lösungsdokument zu einer Dokumentbibliothek auf einer SharePoint-Website hinzu.

2. Führen Sie die Schritte für eine der folgenden Ansätze aus:

   • Verwenden Sie das Office-Konfigurationstool, um den Server, auf dem SharePoint ausgeführt wird, dem Trust Center in Word oder Excel auf allen Benutzercomputern hinzuzufügen.

     Siehe Sicherheitsrichtlinien und -einstellungen in Office 2010.

   • Stellen Sie sicher, dass jeder Benutzer die folgenden Schritte ausführt.

     1. Öffnen Sie auf dem lokalen Computer Word oder Excel, wählen Sie die Registerkarte "Datei " und dann die Schaltfläche " Optionen " aus.

     2. Wählen Sie im Dialogfeld Trust Center die Schaltfläche "Vertrauenswürdige Speicherorte " aus.

     3. Aktivieren Sie das Kontrollkästchen "Vertrauenswürdige Speicherorte zulassen" in meinem Netzwerk (nicht empfohlen), und wählen Sie dann die Schaltfläche " Neuen Speicherort hinzufügen " aus.

     4. Geben Sie im Feld "Pfad " die URL der SharePoint-Dokumentbibliothek ein, die das hochgeladene Dokument enthält (z. B http://SharePointServerName/TeamName/ProjectName/DocumentLibraryName. ).

        Fügen Sie nicht den Namen der Standardwebseite hinzu, z. B. default.aspx oder AllItems.aspx.

     5. Aktivieren Sie das Kontrollkästchen "Unterordner dieses Speicherorts sind ebenfalls vertrauenswürdig ", und klicken Sie dann auf die Schaltfläche "OK ".

        Wenn Benutzer das Dokument von der SharePoint-Website öffnen, wird das Dokument geöffnet, und die Anpassung wird installiert. Benutzer können das Dokument auf ihren Desktop kopieren. Die Anpassungen werden weiterhin ausgeführt, da die Eigenschaften im Dokument auf den Netzwerkstandort des Dokuments verweisen.

Erstellen eines benutzerdefinierten Installationsprogramms

Sie können ein benutzerdefiniertes Installationsprogramm für Ihre Office-Lösung erstellen, anstatt das Setupprogramm zu verwenden, das für Sie erstellt wird, wenn Sie die Lösung veröffentlichen. Sie können z. B. ein Anmeldeskript verwenden, um die Installation zu starten, oder Sie können eine Batchdatei verwenden, um die Lösung ohne Benutzerinteraktion zu installieren. Diese Szenarien funktionieren am besten, wenn die erforderlichen Komponenten bereits auf Endbenutzercomputern installiert sind.

Rufen Sie im Rahmen Ihres benutzerdefinierten Installationsprozesses das Installationstool für Office-Lösungen (VSTOInstaller.exe) auf, das standardmäßig an folgendem Speicherort installiert ist:

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

Wenn sich das Tool nicht an diesem Speicherort befindet, können Sie den RegistrierungsschlüsselHKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\VSTO Runtime Setup\v4\InstallerPath oder HKEY_LOCAL_MACHINE\SOFTWARE\Wow6432Node\Microsoft\VSTO Runtime Setup\v4\InstallerPath verwenden, um den Pfad zu diesem Tool zu finden.

Sie können die folgenden Parameter mit VSTOinstaller.exeverwenden.

Wenn Sie VSTOinstaller.exeausführen, werden möglicherweise die folgenden Fehlercodes angezeigt.

Veröffentlichen eines Updates

Um eine Lösung zu aktualisieren, veröffentlichen Sie sie erneut mithilfe des Project-Designers oder des Veröffentlichungs-Assistenten, und kopieren Sie dann die aktualisierte Lösung an den Installationsspeicherort. Wenn Sie die Dateien an den Installationsspeicherort kopieren, stellen Sie sicher, dass Sie die vorherigen Dateien überschreiben.

Wenn die Lösung das nächste Mal nach einem Update sucht, wird sie die neue Version automatisch finden und laden.

Ändern Sie den Installationsort einer Lösung

Sie können den Installationspfad nach der Veröffentlichung einer Lösung hinzufügen oder ändern. Möglicherweise möchten Sie den Installationspfad aus einem oder mehreren der folgenden Gründe ändern:

• Das Setupprogramm wurde kompiliert, bevor der Installationspfad bekannt war.

• Die Lösungsdateien wurden an einen anderen Speicherort kopiert.

• Der Server, auf dem die Installationsdateien gehostet werden, hat einen neuen Namen oder Speicherort.

  Um den Installationspfad einer Lösung zu ändern, müssen Sie das Setupprogramm aktualisieren, und dann müssen Benutzer sie ausführen. Bei Anpassungen auf Dokumentebene müssen Benutzer auch eine Eigenschaft in ihrem Dokument aktualisieren, um auf den neuen Speicherort zu verweisen.

So ändern Sie den Installationspfad im Setupprogramm

1. Öffnen Sie ein Eingabeaufforderungsfenster , und ändern Sie dann Verzeichnisse in den Installationsordner.

2. Führen Sie das Setupprogramm aus, und schließen Sie den /url Parameter ein, der den neuen Installationspfad als Zeichenfolge verwendet.

   Das folgende Beispiel zeigt, wie Sie den Installationspfad auf einen Speicherort auf der Fabrikam-Website ändern. Sie können jedoch diese URL durch den Pfad ersetzen, den Sie wünschen:

   setup.exe /url="http://www.fabrikam.com/newlocation"
   

   Hinweis

   Wenn eine Meldung angezeigt und angegeben wird, dass die Signatur der ausführbaren Datei ungültig ist, ist das Zertifikat, das zum Signieren der Lösung verwendet wurde, nicht mehr gültig, und der Herausgeber ist unbekannt. Daher müssen Benutzer bestätigen, dass sie der Quelle der Lösung vertrauen, bevor sie sie installieren können.

   Hinweis

   Führen Sie zum Anzeigen des aktuellen Werts der URL aus setup.exe /url.

   Für Anpassungen auf Dokumentebene müssen Benutzer das Dokument öffnen und dann die _AssemblyLocation Eigenschaft aktualisieren. Die folgenden Schritte beschreiben, wie Benutzer diese Aufgabe ausführen können.

So aktualisieren Sie die _AssemblyLocation-Eigenschaft in einem Dokument

1. Wählen Sie auf der Registerkarte "Datei " die Option "Info" aus, die in der folgenden Abbildung dargestellt wird.

   

2. Wählen Sie in der Liste "Eigenschaften " die Option "Erweiterte Eigenschaften" aus, die in der folgenden Abbildung dargestellt wird.

   

3. Wählen Sie auf der Registerkarte " Benutzerdefiniert " in der Liste "Eigenschaften " _AssemblyLocation aus, wie in der folgenden Abbildung dargestellt.

   

   Das Feld "Wert" enthält den Bereitstellungsmanifestbezeichner.

4. Geben Sie vor dem Bezeichner den vollqualifizierten Pfad des Dokuments ein, gefolgt von einer Leiste, im Format "|" (z. B. File://ServerName/FolderName/FileName|74744e4b-e4d6-41eb-84f7-ad20346fe2d9).

   Weitere Informationen zum Formatieren dieses Bezeichners finden Sie in der Übersicht über benutzerdefinierte Dokumenteigenschaften.

5. Klicken Sie auf die Schaltfläche "OK ", und speichern Sie das Dokument, und schließen Sie es.

6. Führen Sie das Setupprogramm ohne den Parameter "/url" aus, um die Lösung am angegebenen Speicherort zu installieren.

Zurücksetzen einer Lösung auf eine frühere Version

Wenn Sie ein Rollback einer Lösung ausführen, stellen Sie Benutzer wieder auf eine frühere Version dieser Lösung zurück.

So führen Sie ein Rollback einer Lösung durch

1. Öffnen Sie den Installationsordner der Lösung.

2. Löschen Sie im Veröffentlichungsordner der obersten Ebene das Bereitstellungsmanifest (die VSTO-Datei ).

3. Suchen Sie den Unterordner für die Version, auf die Sie einen Rollback ausführen möchten.

4. Kopieren Sie das Bereitstellungsmanifest aus diesem Unterordner in den Veröffentlichungsordner der obersten Ebene.

   Wenn Sie beispielsweise ein Rollback für eine Lösung namens "OutlookAddIn1 " von Version 1.0.0.1 auf Version 1.0.0.0 ausführen möchten, kopieren Sie die Datei "OutlookAddIn1.vsto " aus dem Ordner "OutlookAddIn1_1_0_0_0 ". Fügen Sie die Datei in den Veröffentlichungsordner der obersten Ebene ein, und überschreiben Sie das versionsspezifische Bereitstellungsmanifest für OutlookAddIn1_1_0_0_1 , das bereits vorhanden war.

   Die folgende Abbildung zeigt die Struktur des Veröffentlichungsordners in diesem Beispiel.

   

   Wenn ein Benutzer das nächste Mal die Anwendung oder das angepasste Dokument öffnet, wird die Änderung des Bereitstellungsmanifests erkannt. Die frühere Version der Office-Lösung wird aus dem ClickOnce-Cache ausgeführt.

Verwandte Inhalte

• Bereitstellen einer Office-Lösung
• Veröffentlichen von Office-Lösungen
• Vorgehensweise: Veröffentlichen einer Office-Lösung mithilfe von ClickOnce
• Anleitung: Installieren einer ClickOnce Office-Lösung
• Vorgehensweise: Veröffentlichen einer Office-Lösung auf Dokumentebene auf einem SharePoint-Server mithilfe von ClickOnce
• Erstellen eines benutzerdefinierten Installers für eine ClickOnce-Office-Lösung