HelpInfo-XML-versienummers instellen

In dit onderwerp wordt uitgelegd hoe u de versienummers in een updatable Help Information-bestand, ook wel een 'HelpInfo XML-bestand' genoemd, in kunt stellen en verhogen.

HelpInfo-XML-versienummers instellen

De versienummers in een HELPInfo XML-bestand zijn essentieel voor de werking van de Help die kan worden updateerbaar. De cmdlets Update-Help en Save-Help downloaden nieuwe Help-bestanden alleen wanneer het versienummer voor een UI-cultuur in het externe XML-bestand HelpInfo groter is dan het versienummer voor die UI-cultuur in de lokale HelpInfo XML of als er geen lokaal HelpInfo XML-bestand is.

Het XML-bestand HelpInfo gebruikt het 4-delige versienummer dat is gedefinieerd in de klasse System.Version van de Microsoft .NET Framework. De indeling is N1.N2.N3.N4. Auteurs van modules kunnen elk versienummeringsschema gebruiken dat is toegestaan door de klasse System.Version. Voor help die kan worden bijwerkbaar, is alleen vereist dat het versienummer voor een UI-cultuur toeneemt wanneer een nieuwe versie van het CAB-bestand voor die UI-cultuur wordt geüpload naar de locatie die is opgegeven door het element HelpContentURI in het XML-bestand HelpInfo.

In het volgende voorbeeld ziet u de elementen van het XML-bestand HelpInfo voor de Duitse gebruikersinterfacecultuur (de-DE) wanneer de versie 2.15.0.10 is.

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

Het versienummer voor een UI-cultuur weerspiegelt de versie van het CAB-bestand voor die UI-cultuur. Het versienummer is van toepassing op het hele CAB-bestand. U kunt geen verschillende versienummers instellen voor verschillende bestanden in het CAB-bestand. Het versienummer voor elke UI-cultuur wordt onafhankelijk geëvalueerd en hoeft niet te worden gerelateerd aan de versienummers voor andere UI-culturen die door de module worden ondersteund.