Freigeben über


Festlegen von XML-Versionsnummern für HelpInfo

In diesem Thema wird erläutert, wie Sie die Versionsnummern in einer aktualisierbaren Hilfeinformationsdatei festlegen und erhöhen, die häufig als "HelpInfo-XML-Datei" bezeichnet wird.

Festlegen von XML-Versionsnummern für HelpInfo

Die Versionsnummern in einer HelpInfo-XML-Datei sind für den Betrieb der aktualisierbaren Hilfe von entscheidender Bedeutung. Die Cmdlets Update-Help und Save-Help laden neue Hilfedateien nur herunter, wenn die Versionsnummer für eine Benutzeroberflächenkultur in der HelpInfo-XML-Remotedatei größer als die Versionsnummer für diese Benutzeroberflächenkultur in der lokalen HelpInfo XML ist oder keine lokale HelpInfo-XML-Datei vorhanden ist.

Die HelpInfo-XML-Datei verwendet die vierteilige Versionsnummer, die in der System.Version-Klasse des Microsoft-.NET Framework definiert ist. Das Format ist N1.N2.N3.N4. Modulautoren können ein beliebiges Versionsnummernschema verwenden, das von der System.Version-Klasse zugelassen wird. Die aktualisierbare Hilfe erfordert nur, dass die Versionsnummer für eine Benutzeroberflächenkultur erhöht wird, wenn eine neue Version der CAB-Datei für diese Benutzeroberflächenkultur an den Speicherort hochgeladen wird, der vom HelpContentURI-Element in der HelpInfo-XML-Datei angegeben wird.

Das folgende Beispiel zeigt die Elemente der HelpInfo-XML-Datei für die kultur der deutschen Ui (de-DE), wenn die Version 2.15.0.10 ist.

<UICulture>
  <UICultureName>de-DE</UICultureName>
  <UICultureVersion>2.15.0.10</UICultureVersion>
</UICulture>

Die Versionsnummer für eine Benutzeroberflächenkultur spiegelt die Version der CAB-Datei für diese Benutzeroberflächenkultur wider. Die Versionsnummer gilt für die gesamte CAB-Datei. Sie können keine verschiedenen Versionsnummern für verschiedene Dateien in der CAB-Datei festlegen. Die Versionsnummer für jede Benutzeroberflächenkultur wird unabhängig ausgewertet und muss nicht mit den Versionsnummern für andere Benutzeroberflächenkulturen verknüpft sein, die das Modul unterstützt.