Einstellungen für die Verteilung
Auf der Seite Verteilung > Einstellungen konfigurieren Sie die Zuordnungen von Rückgabecodes für Apps. Ausführbare Dateien und Skriptpaketaktionen können beim Beenden einen positiven oder negativen numerischen Code zurückgeben, der auf verschiedene Ergebnisse hinweist. Diese Rückgabecodes wirken sich auf den App-Status aus und bestimmen, ob eine Aktion erfolgreich ist, fehlschlägt oder einen Neustart erfordert.
Verwenden Sie benutzerdefinierte Rückgabecodezuordnungen, um das Ergebnis von EXE-, MSI- und Skriptaktionen anzupassen. Beispiel: Das Dienstprogramm Robocopy von Microsoft verfügt über mehrere Rückgabecodes, die auf einen erfolgreichen Vorgang hinweisen. Standardmäßig weist ein ausführbarer Rückgabecode ungleich Null auf einen Fehler hin. Sie könnten eine benutzerdefinierte Rückgabecodezuordnung für Robocopy erstellen, durch die diese Rückgabecodes ungleich Null einer Erfolgsmeldung zuordnet, sodass die Paketverarbeitung fortgesetzt werden kann.
Die Rückgabecodes werden bei jeder Verteilung in einem Protokoll auf dem Gerät gespeichert. Weitere Informationen zu den Protokollen und dazu, wie Sie diese aufrufen, finden Sie unter Erkennungsregel und Aktionsprotokollierung.
Zusätzlich zur Speicherung der numerischen Rückgabecodes im Protokoll können Sie diese informativen Zeichenfolgen zuordnen. Die Zeichenfolgen zur Beschreibung der Rückgabecodes werden ebenfalls im Protokoll angezeigt.
Es gibt drei Typen von Rückgabecodevorlagen:
- Neue Vorlagen, die Sie erstellen.
- Geklonte Ausfertigungen einer vorhandenen Vorlage. Zum Klonen einer vorhandenen Vorlage verwenden Sie das Optionenmenü (
) rechts neben der Vorlage.
- Standardvorlagen, die Sie weder bearbeiten, noch löschen können, abgesehen von der Tatsache, dass Sie eine als Standardvorlage festlegen können. Eine geklonte Ausfertigung können Sie bearbeiten.
Dies sind die Standardvorlagen für Rückgabecodes. Das Standardverhalten für nicht zugeordnete Rückgabecodes in diesen Vorlagen ist "Fehler".
- Systemvorlage – Standard-MSI: Enthält den standardisierten Satz mit MSI-Rückgabecodes. Diese sind für Sie bereits vorkonfiguriert.
- Systemvorlage – Standard-EXE: Enthält eine Rückgabecodezuordnung für die Zahl Null, die für einen erfolgreichen Vorgang steht.
- Systemvorlage – Standard-PowerShell: Enthält zwei Rückgabecodezuordnungen. Die Zahl Null steht für einen erfolgreichen Vorgang und die Zahl Eins für Fehler.
Eine Vorlage jedes Vorlagentyps, also MSI, EXE und PowerShell, kann als Standard festgelegt werden. Die Liste Rückgabecodezuordnungen enthält eine Spalte, aus der die Standardvorlagen hervorgehen. Um einen Standard zu ändern, bearbeiten Sie die Vorlage und wählen Sie die betreffende Option.
Wenn Sie eine Paketaktion erstellen, die eine Rückgabecodevorlage unterstützt, wird die Standardvorlage für Sie vorausgewählt. Wenn Sie die Standardvorlage nicht verwenden möchten, wählen Sie eine andere Vorlage für den betreffenden Aktionstyp aus. Die von Ihnen an den Vorlagen vorgenommenen Änderungen werden wirksam, wenn das Verteilungsmodul das nächste Mal auf dem Client ausgeführt wird.
Die MSI-Rückgabecodevorlagen beinhalten eine Rückgabecodezuordnung für 3010, Vorgang war erfolgreich – Neustart erforderlich. Dieses Ergebnis entspricht einem erfolgreichen Vorgang, wobei im Geräteprotokoll für diese Verteilung zusätzlich vermerkt wird, dass ein Neustart erforderlich sein wird. Der Bereitstellungsstatus zeigt für dieses Paket ebenfalls "Erfolgreich (Neustart erforderlich)" an.
So erstellen oder bearbeiten Sie eine Rückgabecodevorlage:
- Wählen Sie Neu erstellen und den gewünschten Vorlagentyp oder wählen Sie eine bereits vorhandene Vorlage aus. Die vorkonfigurierten Systemvorlagen sind schreibgeschützt.
- Geben Sie einen Vorlagennamen und eine Beschreibung ein.
- Wählen Sie bei Als Standardvorlage festlegen den Wert Wahr aus, wenn diese Vorlage als Standardvorlage für den von Ihnen gewählten Typ (z. B. EXE oder PowerShell) fungieren soll.
- Wählen Sie für nicht zugeordnete Rückgabecodes Standardergebnis aus. Der Standard ist Fehler. Das von Ihnen ausgewählte Ergebnis wird für jeden Rückgabecode aus der Aktion generiert, der nicht in der Liste der Rückgabecodes enthalten ist. Beispiel: Wenn Sie Fehler wählen (empfohlen), dann bewirken alle Rückgabecodes, die nicht in der Liste aufgeführt sind, dass die Aktion als fehlgeschlagen zurückgegeben wird. Wenn Sie Erfolg wählen, werden alle anderen Rückgabecodes als erfolgreich zurückgegeben.
- Geben Sie den Text der Standardmeldung an, die für das von Ihnen gewählte Standardergebnis für nicht zugeordnete Rückgabecodes angezeigt wird.
- Wählen Sie + Rückgabecode hinzufügen aus.
- Geben Sie die Zahl des Rückgabecodes oder den Zahlenbereich als Ganzzahl (keine Dezimalstellen), das Ergebnis (Fehler oder Erfolg) und den Text der Meldung ein, die zusammen mit dem Rückgabecode protokolliert werden soll. Bei Eingabe eines Zahlenbereichs trennen Sie die Zahlen mit zwei Punkten, z. B. 15..30.
- Wählen Sie Speichern.
- Wiederholen Sie die Schritte 7 und 8 für jeden gewünschten Rückgabecode.
- Wenn Sie fertig sind, schließen Sie den Bereich Neue Zuordnung hinzufügen und wählen Sie Speichern.
