Instellingen App-distributie

Gebruik de pagina App-distributie > Instellingen om de toewijzingen voor de app-retourcode te configureren.. Uitvoerbare en scriptpakketacties kunnen een positieve of negatieve numerieke code retourneren bij het afsluiten waarbij verschillende resultaten worden aangegeven. Deze retourcodes beïnvloeden de app-status en bepalen of een actie gelukt, mislukt of een herstart vereist.

Gebruik aangepaste retourcodetoewijzingen om het resultaat van EXE-, MSI- en scriptacties aan te passen. Het Robocopy-hulpprogramma van Microsoft heeft bijvoorbeeld meerdere retourcodes die succes aangeven.Standaard wijst een niet-zero uitvoerbare retourcode op een fout.U kunt een aangepaste retourcodetoewijzing maken voor Robocopy die deze niet-zero retourcodes toewijst aan gelukt zodat de pakketverwerking kan doorgaan.

Retourcodes worden opgeslagen in een logboek op het apparaat als onderdeel van elke app-distributie. Meer informatie over logboeken en de toegang vindt u onder Detectieregel en actieregistratie.

Naast de numerieke codes die in het logboek zijn opgeslagen, kunt u die retourcodes toewijzen aan informatieve tekenreeksen. Deze tekenreeksen die de retourcodes beschrijven, zullen ook verschijnen in het logboek.

Er zijn drie types retourcodesjablonen.

  • Nieuwe sjablonen die u maakt.
  • Gekloonde kopieën van een bestaande sjabloon. Om een bestaande sjabloon te klonen, gebruikt u het optiemenu ( ) rechts van die sjabloon.
  • Standaardsjablonen die u niet kunt bewerken of verwijderen, anders dan het markeren van één sjabloon als een standaardsjabloon, other than marking one as a default template. U kunt een gekloonde kopie bewerken.

Dit zijn de standaard retourcodesjablonen. Het standaardgedrag voor niet toegewezen retourcodes in deze sjablonen is fout.

  • Systeemsjabloon - Standaard MSI: bevat de gestandaardiseerde set van MSI-retourcodes. Deze zijn vooraf geconfigureerd voor u.
  • Systeemsjabloon - Standaard EXE: bevat één retourcodetoewijzing voor het cijfer nul wat aangeeft dat het gelukt is.
  • Systeemsjabloon - Standaard PowerShell: bevat twee retourcodetoewijzingen. Het cijfer nul wijst op gelukt en het cijfer één op een fout.

Een van elk sjabloontype, MSI, EXE en PowerShell kunnen worden gemarkeerd als standaard. De lijst Retourcodetoewijzingen heeft een kolom die toont welke sjablonen standaarden zijn. Om een standaard te wijzigen, bewerkt u de sjabloon en en selecteert u die optie.

Wanneer u een pakketactie maakt die een retourcodesjabloon ondersteunt, wordt de standaard vooraf geselecteerd voor u. Als u de standaard niet wilt gebruiken, kunt u kiezen uit andere sjablonen voor dat actietype. Sjabloonwijzigingen die u aanbrengt, worden van kracht wanneer de app-distributie-engine de volgende keer wordt uitgevoerd op de client.

MSI-retourcodesjablonen bevatten een retourcodetoewijzing voor 3010, gelukt - Opnieuw opstarten vereist. Dit resultaat is hetzelfde als Gelukt, maar met een opmerking in het apparaatlogboek voor die distributie dat het op een bepaald punt opnieuw zal moeten worden opgestart.De implementatiestatus zal ook "Gelukt (herstart vereist)" tonen voor dat pakket.

Een retourcodesjabloon maken of bewerken

  1. Selecteer Nieuw maken en het sjabloontype dat u wilt, of selecteer een bestaande sjabloon. De vooraf geconfigureerde systeemsjablonen zijn alleen-lezen.
  2. Voer een Sjabloonnaam en een beschrijving in.
  3. Kies onder Hiervan de standaardsjabloon maken voor Waar als u deze sjabloon wilt gebruiken als de standaard voor het sjabloontype dat u hebt geselecteerd (zoals EXE of PowerShell).
  4. Selecteer het Standaardresultaat voor niet toegewezen retourcodes. De standaard is Mislukt. Het resultaat dat u selecteert is wat zal optreden voor elke retourcode die terugkeert van de actie die niet is weergegeven in de retourcodelijst. Als u bijvoorbeeld kiest voor Mislukt (aanbevolen), dan zullen alles retourcodes die niet in de lijst staan, ervoor zorgen dat de actie wordt geretourneerd als mislukt. Als u kiest voor Gelukt, worden alle retourcodes geretourneerd als gelukt.
  5. Geef de tekst voor het Standaardbericht op dat verschijnt voor uw geselecteerd standaard niet toegewezen retourcoderesultaat.
  6. Selecteer + voeg retourcode toe.
  7. Voer het nummer of nummerbereik voor de Retourcode in gehele getallen in (geen decimalen), Resultaat (Mislukt of Gelukt) en de Berichttekst die u wilt registreren samen met de retourcode. Om een nummerbereik in te voeren, scheidt u de cijfers door twee punten, zoals 15..30.
  8. Selecteer Opslaan.
  9. Herhaal stappen 7 en 8 voor elke gewenste retourcode.
  10. Wanneer u klaar bent, sluit u het paneel Nieuwe toewijzing toevoegen en selecteert u Opslaan.