Upgraden einer Farmlösung
Letzte Änderung: Dienstag, 11. Januar 2011
Gilt für: SharePoint Foundation 2010
In diesem Thema werden die Upgrademethoden für Farmlösungen beschrieben.
Zwei Upgrademethoden
Für das Upgraden einer Farmlösung gibt es zwei Methoden. Die verwendete Methode hängt davon ab, welche Änderungen in der neueren Version der Lösung vorgenommen wurden.
Ersetzung: Die alte Version der Lösung wird zurückgezogen und optional aus dem Farmlösungsspeicher entfernt. Die neue Version wird dann dem Lösungsspeicher hinzugefügt und bereitgestellt. Es ist nicht notwendig, dass das neue Lösungspaket (WSP-Datei) denselben Namen oder dieselbe GUID wie die alte Version aufweist. Wenn jedoch die alte Version zurückgezogen, aber nicht aus dem Lösungsspeicher entfernt wird, ist für die neue Version ein anderer Dateiname und eine andere GUID erforderlich. Diese Art von Upgrade muss verwendet werden, wenn die neue Version der Lösung von der installierten Version in einem der folgenden Punkten abweicht.
Mit der neuen Version wird ein Feature entfernt, das in der alten Version vorhanden war, oder ein Feature hinzugefügt, das in der alten Version nicht vorhanden war.
In der neuen Version wird die ID eines Features geändert.
In der neuen Version wird der Geltungsbereich eines Features geändert.
Die neue Version weist eine geänderte Version eines Featureempfängers auf.
In der neuen Version wird eine neue Datei elements.xml hinzugefügt, eine Datei elements.xml entfernt oder der Inhalt einer vorhandenen Datei elements.xml geändert.
In der neuen Version wird einer Datei Feature.xml ein neues Property-Element hinzugefügt, ein Property-Element aus einer Datei Feature.xml entfernt oder der Wert eines Property-Elements in einer Datei Feature.xml geändert.
Ausführliche Informationen zur Zurückziehung und Bereitstellung finden Sie unter Deinstallieren und Zurückziehen einer Farmlösung und Installieren und Bereitstellen einer Farmlösung.
Update: Eine neue Version des Lösungspakets wird mit einem anderen Dateinamen, aber derselben GUID wie in der alten Version installiert und bereitgestellt. Die Bereitstellungsinfrastruktur von Microsoft SharePoint Foundation erkennt, dass die GUIDs identisch sind. Die alte Version wird automatisch zurückgezogen, bevor die neue Version bereitgestellt wird. Falls in der Lösung Features vorhanden sind, weisen die neue und die alte Version dieselben Features auf, die außerdem aktiviert bleiben. Darin enthaltene Assemblys und bestimmte andere Dateien werden jedoch mit den neuen Versionen aus dem neuen Lösungspaket aktualisiert.
Bei jedem erfolgreichen Upgrade einer Lösung wird die vorherige Version der Lösung gesichert und im Konfigurationsspeicher gespeichert. Diese Sicherung wird vom Lösungsframework im Falle eines Upgradefehlers verwendet. Pro Lösung wird nur eine einzelne Sicherungskopie gespeichert.
Farmadministratoren führen ein Upgrade vom Typ "Update" mit dem Befehl Update-SPSolution in der SharePoint-Verwaltungsshell aus.
Programmgesteuerte Aktualisierung
Das Ausführen eines Upgrades vom Typ Ersetzung ist identisch mit dem programmgesteuerten Zurückziehen der alten Lösung und dem anschließenden Hinzufügen und Bereitstellen der neuen Version. Für die programmgesteuerte Ausführung eines Upgrades vom Typ Update wird vom Code eine der Überladungen der SPSolution.Upgrade()-Methode aufgerufen. Zum Ausführen dieser Methode muss im Lösungsspeicher eine Lösung vorhanden sein. Die Lösung kann, muss aber nicht bereits bereitgestellt sein.
Wenn die Lösung nicht bereitgestellt ist, rufen Sie die SPSolution.Upgrade(String)-Methode auf, um die Lösung im Lösungsspeicher zu aktualisieren. Wenn die Lösung bereitgestellt ist, rufen Sie die SPSolution.Upgrade(String, DateTime)-Methode auf, um den Zeitgeberauftrag für das Upgrade zu starten. In beiden Fällen wird ein Backup der alten Lösungsversion erstellt.