Freigeben über

Gewusst wie: Bereitstellen einer Integritätsregel mit einem Lösungspaket

  • Artikel

Letzte Änderung: Dienstag, 15. November 2011

Gilt für: SharePoint Foundation 2010

Das Bereitstellen einer neuen Integritätsregel ist in einer Entwicklungsumgebung unkompliziert. Sie können die Assembly, die die Regel enthält, manuell installieren, indem Sie sie mithilfe des Tools für den globalen Assemblycache (Gacutil.exe) im globalen Assemblycache (Global Assembly Cache, GAC) Ihres Entwicklungsservers platzieren. Wenn Sie mit SharePoint-Integritätsanalyse ein SharePoint-Feature für die Registrierung der Regel erstellt haben, können Sie das Feature manuell installieren, indem Sie mithilfe von SharePoint-Verwaltungsshell das folgende Windows Powershell-Cmdlet ausführen: Install-SPFeature. Mithilfe des folgenden Windows Powershell-Cmdlets können Sie das Feature aktivieren und die Regel registrieren: Enable-SPFeature.

Das manuelle Verfahren ist in einer Produktionsumgebung, in der die Serverfarm wahrscheinlich aus mehreren Servern bestehen wird und zu erwarten ist, dass im Laufe der Zeit zusätzliche Server online geschaltet werden, nicht praktikabel. In einer Produktionsumgebung besteht der beste Ansatz darin, ein Lösungspaket zu verwenden. Sie können ein Lösungspaket einmal hochladen, und die Lösung wird an alle Server in der Farm weitergegeben. Sobald neue Server online geschaltet werden, erhalten diese die Lösung automatisch im Rahmen ihrer Bereitstellung.

In diesem Thema wird erklärt, wie Sie ein Lösungspaket erstellen können, das eine Integritätsregel enthält. Außerdem wird erläutert, wie Sie die Lösung in eine Serverfarm hochladen und sie dort bereitstellen. Es wird davon ausgegangen, dass Sie die unter Gewusst wie: Erstellen einer Integritätsregel und Gewusst wie: Erstellen eines Features zum Registrieren einer Integritätsregel beschriebenen Verfahren ausgeführt haben.

Erstellen des Lösungspakets

Ein Lösungspaket ist eine CAB-Datei mit der Dateierweiterung WSP, die alle Dateien enthält, die auf den Servern in der Farm bereitgestellt werden müssen. Da wir ein Lösungspaket verwenden, um eine Integritätsregel bereitzustellen, werden mit dem Paket zwei Dateien installiert: Feature.xml und die Assembly für die Regel. Jedes Lösungspaket muss auch eine Datei namens Manifest.xml enthalten, die Anweisungen zum Installieren der Lösung enthält.

Der erste Schritt beim Entwickeln eines Lösungspakets ist das Erstellen der Datei Manifest.xml. Der zweite Schritt besteht im Erstellen einer Diamond-Directive-Datei (Diamond Directive File, DDF), die dem Befehlszeilenprogramm Makecab.exe mitteilt, welche Dateien in die Ausgabe-CAB-Datei einbezogen werden sollen. Den letzten Schritt bildet das Kompilieren der CAB-Datei mithilfe von Makecab.exe.

So erstellen Sie die Manifestdatei für ein Lösungspaket

  1. Öffnen Sie Visual Studio als Administrator, indem Sie im Startmenü mit der rechten Maustaste auf das Programm klicken und dann Als Administrator ausführen auswählen.

  2. Öffnen Sie das Projekt, das den Code für die Integritätsregel enthält.

  3. Erstellen Sie einen Ordner Lösung.

    Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und wählen Sie Hinzufügen und anschließend Neuer Ordner aus. Geben Sie Lösung ein.

  4. Erstellen Sie eine Lösungsmanifestdatei.

    Klicken Sie mit der rechten Maustaste auf den Ordner Lösung, und wählen Sie Hinzufügen und anschließend Neues Element... aus. Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage XML-Datei aus. Geben Sie der Datei den Namen Manifest.xml. Klicken Sie dann auf Hinzufügen.

  5. Öffnen Sie die Datei Manifest.xml im Editor.

  6. Löschen Sie die erste (und einzige) Zeile in der Datei. Fügen Sie an dieser Stelle den folgenden Code über die Zwischenablage ein.

    <Solution SolutionId="00000000-0000-0000-0000-000000000000"
          xmlns="https://schemas.microsoft.com/sharepoint/">
  <FeatureManifests>
    <FeatureManifest Location="FeatureFolderName\feature.xml" />
  </FeatureManifests>
  <Assemblies>
    <Assembly DeploymentTarget="GlobalAssemblyCache"
              Location="AssemblyName.dll" />
  </Assemblies>
</Solution>

  7. Ersetzen Sie den Wert des SolutionId-Attributs durch eine neu generierte GUID (ohne Klammern).

    Sie können mithilfe des Tools GuidGen (Guidgen.exe) eine neue GUID abrufen. Wählen Sie in Visual Studio im Menü Extras den Befehl GUID erstellen aus. Wählen Sie im Dialogfeld GUID erstellen die Option 4. Registrierungsformat aus, und klicken Sie auf Kopieren. Fügen Sie den Inhalt der Zwischenablage zwischen den Anführungszeichen nach dem SolutionId-Attribut ein. Entfernen Sie die Klammern von der GUID.

  8. Ändern Sie den Wert des Location-Attributs des FeatureManifest-Elements, indem Sie "FeatureFolderName" durch den Namen des Ordners in Ihrer Lösung ersetzen, der die Datei Feature.xml enthält.

    Bei der Bereitstellung der Lösung wird ein gleichnamiger Ordner im Ordner %ProgramFiles%\Common Files\Microsoft Shared\web server extensions\14\TEMPLATE\FEATURES jedes Servers in der Farm erstellt.

  9. Ändern Sie den Wert des Location-Attributs des Assembly-Elements, indem Sie "AssemblyName.dll" durch den Dateinamen der Assembly der Regel ersetzen.

  10. Speichern Sie die Datei Manifest.xml.

So erstellen Sie eine Direktivendatei für das Lösungspaket

  1. Erstellen Sie einen Paketordner in Ihrem Visual Studio-Projekt.

    Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Projektnamen, und wählen Sie Hinzufügen und dann Neuer Ordner aus. Geben Sie Paket ein.

    Dies ist das Ausgabeverzeichnis für das Befehlszeilenprogramm Makecab.exe.

  2. Erstellen Sie im Ordner Lösung Ihres Visual Studio-Projekts eine Diamond-Directive-Datei (Diamond Directive File, DDF).

    Klicken Sie im Projektmappen-Explorer mit der rechten Maustaste auf den Ordner Lösung, wählen Sie Hinzufügen und dann Neues Element... aus. Wählen Sie im Dialogfeld Neues Element hinzufügen die Vorlage Textdatei aus. Geben Sie der Datei den Namen Cab.ddf. Klicken Sie anschließend auf Hinzufügen.

    Diese Datei wird mit dem Befehlszeilenprogramm Makecab.exe verwendet.

  3. Öffnen Sie die Datei Cab.ddf im Editor. Kopieren Sie das folgende Markup, und fügen Sie es in die Datei Cab.ddf ein.

    .OPTION EXPLICIT     ; Generate errors 
.Set CabinetNameTemplate=SolutionName.wsp
.set DiskDirectoryTemplate=CDROM ; All cabinets go in a single directory.
.Set CompressionType=MSZIP;** All files are compressed in cabinet files.
.Set UniqueFiles="ON"
.Set Cabinet=on
.Set DiskDirectory1=Package ; This is the output directory.

; Files to include.
Solution\manifest.xml manifest.xml
Features\FeatureFolderName\feature.xml FeatureFolderName\feature.xml
bin\Release\AssemblyName.dll AssemblyName.dll

  4. Ändern Sie den Wert des CabinetNameTemplate-Arguments, indem Sie "SolutionName" durch den Dateinamen ersetzen, den Sie für das Lösungspaket verwenden möchten. (Behalten Sie die Dateierweiterung WSP bei.)

  5. Ersetzen Sie "FeatureFolderName" (kommt zweimal vor) durch den Namen des Ordners in der Lösung, der die Datei Feature.xml enthält.

  6. Ersetzen Sie "AssemblyName.dll" (kommt zweimal vor) durch den Dateinamen der Assembly der Regel. Wenn der relative Pfad zur Assembly nicht "bin\Release\" lautet, ersetzen Sie diese Zeichenfolge außerdem durch den korrekten Pfad.

  7. Speichern Sie die Datei Cab.ddf.

So erstellen Sie die Lösungspaketdatei

  1. Öffnen Sie in Visual Studio eine Eingabeaufforderung.

  2. Navigieren Sie zu dem Verzeichnis für Ihr Visual Studio-Projekt.

    Die Dateipfade in der Datei Cab.ddf und in dem Befehl, der im nächsten Schritt ausgegeben wird, sind relativ zum Visual Studio-Projektverzeichnis.

  3. Geben Sie an der Eingabeaufforderung den folgenden Befehl ein:

    makecab /f solution\cab.ddf

    Im Ordner Paket wird ein Lösungspaket erstellt.

Hochladen und Bereitstellen der Lösung

Nachdem Sie ein neues Lösungspaket erstellt haben, sollten Sie es in einer SharePoint-Installation testen, vorzugsweise auf einem leeren Image und nicht auf Ihrem Entwicklungsserver. Dieser Schritt umfasst zwei Aufgaben: Zuerst müssen Sie das Lösungspaket in die Serverfarm hochladen. Danach müssen Sie die Lösung bereitstellen.

HinweisHinweis

Ihre Lösung enthält ein Feature, für das ein Bereich auf Serverfarmebene festgelegt wurde. Da ein Feature auf Farmebene bei der Installation automatisch aktiviert wird, müssen Sie keinen Befehl ausgeben, um es manuell zu aktivieren.

So laden Sie ein Lösungspaket in die Farm hoch und stellen es dort bereit

  1. Öffnen Sie SharePoint-Verwaltungsshell als Administrator, indem Sie mit der rechten Maustaste im Startmenü auf das Element klicken, dann auf Verwaltung klicken und dann Als Administrator ausführen auswählen.

  2. Geben Sie an der Eingabeaufforderung den folgenden Befehl ein, um die Lösung hochzuladen. (Geben Sie den vollständigen Pfad und Dateinamen für Ihr Lösungspaket ein.)

    add-spsolution -literalpath <full path and filename.wsp>

    Das Lösungspaket wird jetzt in die Serverfarm hochgeladen.

  3. Geben Sie an der Eingabeaufforderung den folgenden Befehl ein, um die Lösung bereitzustellen. (Geben Sie den korrekten Dateinamen der WSP-Datei ein.)

    install-spsolution -identity filename.wsp -force -gacdeployment

Die Integritätsregel ist jetzt installiert und registriert. Dies können Sie überprüfen, indem Sie in der Zentraladministration im Abschnitt Überwachung die Liste Regel der Integritätsanalyse durchsehen.

Siehe auch

Aufgaben

Gewusst wie: Erstellen einer Integritätsregel

Gewusst wie: Erstellen eines Features zum Registrieren einer Integritätsregel

Konzepte

Manuelles Erstellen einer Lösung

Weitere Ressourcen

Automating Solution Package Creation for Windows SharePoint Services by Using MSBuild