Featureupgrade (Übersicht)

Letzte Änderung: Freitag, 9. Juli 2010

Gilt für: SharePoint Foundation 2010

In Microsoft SharePoint Foundation besitzt jedes Feature eine Versionsnummer, die in der entsprechenden Feature.xml-Datei angegeben ist. Wenn ein Feature in einem angegebenen Bereich aktiviert wird, wird eine Featureinstanz erstellt, die dieser Version des Features zugeordnet ist. Mithilfe der Featureversionen in SharePoint Foundation können Features und die ihnen zugeordneten Instanzen problemlos nachverfolgt werden. Wenn Sie dann eine neue Version eines Features bereitstellen, wird von SharePoint Foundation erkannt, dass die zugeordnete Featureinstanz ebenfalls aktualisiert werden muss, da die Versionsnummer der Instanz niedriger ist als die neue Versionsnummer in der aktuellen Feature.xml-Datei.

Hinweis
Abgesehen von Dateien zur Lösungsbereitstellung oder zum Lösungsupgrade sollten Sie niemals eine Featuredatei im Ordner FEATURES speichern, da das Featureupgrade eine erweiterte Bereitstellungsoption darstellt, bei der der XML-Code des Features während der Bereitstellung nicht überprüft wird.

Wenn Sie ein Featureupgrade ausführen, werden zu aktualisierende Featureinstanzen ebenfalls entsprechend den Upgradeaktionen in der neuen Feature.xml-Datei aktualisiert. In SharePoint Foundation werden neue QueryFeatures-Methoden verwendet, die auf Objekte der obersten Ebene wie SPWebApplication und SPSite angewendet werden können, um die zu aktualisierenden Featureinstanzen abhängig von ihren Versionsnummern zu bestimmen. Die neue Feature.xml-Datei enthält einen Abschnitt, in dem die Upgradeaktionen angegeben werden können, die erforderlich sind, um eine bestimmte Featureinstanz von einer früheren Version auf die aktuelle Version zu aktualisieren. Von der Upgradeinfrastruktur wird eine Abfrage nach der Menge der zu aktualisierenden Featureinstanzen gestellt und dann jede dieser Featureinstanzen aktualisiert. Diese Aktivität kann deklarative Upgradeaktionen sowie benutzerdefinierten Upgradecode umfassen. In SharePoint Foundation wird die Versionsnummer für jede Featureinstanz nachverfolgt.

Features werden in der folgenden Reihenfolge aktualisiert: zuerst auf Serverfarmebene, anschließend auf Webanwendungsebene, dann in Websitesammlungen und schließlich auf bestimmten Websites. Auf der Websiteebene werden Featureinstanzen beginnend mit Stammwebsites und anschließend der Hierarchie der untergeordneten Websites folgend aktualisiert. Features werden in der Reihenfolge der Abhängigkeit aktualisiert, d. h. abhängige Features werden nach den Features, von denen sie abhängig sind, aktualisiert.

Bei Auftreten eines Fehlers während des Upgrades wird das Upgrade für die angegebene Featureinstanz beendet und der Fehler in ULS-Protokollen und in einer Upgrade.log-Datei aufgezeichnet. (ULS-Protokolle enthalten in der Regel mehr Informationen über den Fehler.) Das Upgrade wird in der Zwischenzeit auf anderen Featureinstanzen weiterhin ausgeführt. Nach Abschluss des ersten Upgrades und vor dem Neustart des Prozesses haben Administratoren Gelegenheit zum Ermitteln und Lösen von Problemen, die das Upgrade von Features verhindert haben. Wenn dann der Upgradeprozess erneut initiiert wird, werden von SharePoint Foundation alle Upgradeaktionen für die Features wiederholt, deren Upgrade zuvor einen Fehler geliefert hat, sodass der Upgradeprozess für alle Features und Featureinstanzen erfolgreich abgeschlossen werden kann.

Hinweis
Das Featureupgrade wird unter den Anmeldeinformationen eines Farmadministrators ausgeführt.