De werking van Help die kan worden bijgewerkt

In dit onderwerp wordt uitgelegd hoe Help kan worden bijgewerkt met het XML-bestand en CAB-bestanden van Helpinfo voor elke module en bijgewerkte help voor gebruikers wordt geïnstalleerd.

Het Update-Help proces

In de volgende lijst worden de acties van de Cmdlet Update-Help beschreven wanneer een gebruiker een opdracht uitvoert om de Help-bestanden voor een module in een bepaalde UI-cultuur bij te werken.

1. Update-Help haalt het EXTERNE HelpInfo XML-bestand op van de locatie die is opgegeven door de waarde van de HelpInfoURI-sleutel in het modulemanifest en valideert het bestand op basis van het schema. (Als u het schema wilt weergeven, raadpleegt u Het XML-schema van HelpInfo.) Zoek vervolgens Update-Help naar een lokaal HelpInfo XML-bestand voor de module in de modulemap op de computer van de gebruiker.

2. Update-Help Vergelijkt het versienummer van de Help-bestanden voor de opgegeven UI-cultuur in de externe en lokale HelpInfo XML-bestanden voor de module. Als het versienummer van het externe bestand groter is dan het versienummer in het lokale bestand of als er geen lokaal HelpInfo XML-bestand voor de module is, Update-Help bereidt u zich voor om nieuwe Help-bestanden te downloaden.

3. Update-Help selecteert het CAB-bestand voor de module op de locatie die is opgegeven door het element HelpContentUri in het externe XML-bestand van HelpInfo. Het maakt gebruik van de modulenaam, module-GUID en UI-cultuur om het CAB-bestand te identificeren.

4. Update-Help downloadt het CAB-bestand, pakt het uit, valideert de Help-inhoudsbestanden en slaat de Help-inhoudsbestanden op in de taalspecifieke submap van de modulemap op de computer van de gebruiker.

5. Update-Help maakt een lokaal HELPInfo XML-bestand door het externe HelpInfo XML-bestand te kopiëren. Hiermee wordt het lokale XML-bestand helpinfo bewerkt, zodat het alleen elementen bevat voor het CAB-bestand dat is geïnstalleerd. Vervolgens wordt het lokale XML-bestand met HelpInfo opgeslagen in de modulemap en wordt de update afgesloten.

Het Save-Help proces

In de volgende lijst worden de acties van de cmdlets Save-Help en Update-Help beschreven wanneer een gebruiker opdrachten uitvoert om de Help-bestanden in een bestandsshare bij te werken en deze bestanden vervolgens gebruiken om de Help-bestanden op de computer van de gebruiker bij te werken.

De Save-Help cmdlet voert de volgende acties uit als reactie op een opdracht om de Help-bestanden voor een module op te slaan in een bestandsshare die is opgegeven door de parameter DestinationPath .

1. Save-Help haalt het EXTERNE HelpInfo XML-bestand op van de locatie die is opgegeven door de waarde van de HelpInfoURI-sleutel in het modulemanifest en valideert het bestand op basis van het schema. (Als u het schema wilt weergeven, raadpleegt u Het XML-schema van HelpInfo.) Zoek vervolgens Save-Help naar een lokaal HelpInfo XML-bestand in de map die is opgegeven door de parameter DestinationPath in de Save-Help opdracht.

2. Save-Help Vergelijkt het versienummer van de Help-bestanden voor de opgegeven UI-cultuur in de externe en lokale HelpInfo XML-bestanden voor de module. Als het versienummer van het externe bestand groter is dan het versienummer van het lokale bestand, of als er geen lokaal HelpInfo XML-bestand voor de module in de DestinationPath-map is, Save-Help bereidt u zich voor om nieuwe Help-bestanden te downloaden.

3. Save-Help selecteert het CAB-bestand voor de module op de locatie die is opgegeven door het element HelpContentUri in het externe XML-bestand van HelpInfo. Het maakt gebruik van de modulenaam, module-GUID en UI-cultuur om het CAB-bestand te identificeren.

4. Save-Help downloadt het CAB-bestand en slaat het op in de map DestinationPath . (Er worden geen taalspecifieke submappen gemaakt.)

5. Save-Help maakt een lokaal HELPInfo XML-bestand door het externe HelpInfo XML-bestand te kopiëren. Hiermee wordt het lokale XML-bestand HelpInfo bewerkt, zodat het alleen elementen bevat voor het CAB-bestand dat is opgeslagen. Vervolgens wordt het lokale XML-bestand met HelpInfo opgeslagen in de DestinationPath-map en wordt de update afgesloten.

   De Update-Help cmdlet voert de volgende acties uit als reactie op een opdracht om de Help-bestanden op de computer van een gebruiker bij te werken vanuit de bestanden in een bestandsshare die is opgegeven door de parameter SourcePath .

6. Update-Help haalt het externe HelpInfo XML-bestand op uit de SourcePath-map . Vervolgens wordt gezocht naar een lokaal HelpInfo XML-bestand in de modulemap op de computer van de gebruiker.

7. Update-Help Vergelijkt het versienummer van de Help-bestanden voor de opgegeven UI-cultuur in de externe en lokale HelpInfo XML-bestanden voor de module. Als het versienummer van het externe bestand groter is dan het versienummer van het lokale bestand, of als er geen lokaal XML-bestand met HelpInfo is, Update-Help bereidt u zich voor om nieuwe Help-bestanden te installeren.

8. Update-Help selecteert het CAB-bestand voor de module in de SourcePath-map . Het maakt gebruik van de modulenaam, module-GUID en UI-cultuur om het CAB-bestand te identificeren.

9. Update-Help Pak het CAB-bestand uit, valideert de Help-inhoudsbestanden en slaat de Help-inhoudsbestanden op in de taalspecifieke submap van de modulemap op de computer van de gebruiker.

10. Update-Help maakt een lokaal HELPInfo XML-bestand door het externe HelpInfo XML-bestand te kopiëren. Hiermee wordt het lokale XML-bestand helpinfo bewerkt, zodat het alleen elementen bevat voor het CAB-bestand dat is geïnstalleerd. Vervolgens wordt het lokale XML-bestand met HelpInfo opgeslagen in de modulemap en wordt de update afgesloten.