Änderungen von Dokument BITS Commands

Zuletzt geändert von S F am 2024/03/19 17:56

Von Version < 3.2 >

bearbeitet von Jannis Klein
am 2021/11/17 08:56

Auf Version < 4.1 >

bearbeitet von Jannis Klein
am 2021/11/17 09:12

Änderungskommentar: Es gibt keinen Kommentar für diese Version

Rohform
Im Layout

Zusammenfassung

Seiteneigenschaften (1 geändert, 0 hinzugefügt, 0 gelöscht)

Details

Seiteneigenschaften

Inhalt

@@ -4,9 +4,10 @@
  {{aagon.floatingbox/}}
++= Allgemeines =
++
  Über die BITS Commands können Downloads sowie Uploads von Dateien über den BITS (Background Intelligent Transfer Service) verwaltet werden. Dabei werden die Downloads/Uploads als einzelne Jobs verwaltet. Bei der Übertragung von Dateien führt der BITS automatisch ein Loadbalancing durch, sodass die produktive Arbeit mit Netzressourcen ohne Performance-Einbußen möglich bleibt.
--
  Um einen Download oder Upload von Dateien per BITS durchzuführen, sind mindestens die Kommandos Add job, Add file(s) to job, Resume job und Complete job erforderlich. Alle weiteren Kommandos können optional eingesetzt werden.
@@ -17,88 +17,63 @@
  Da der BITS ein relativ neuer Service ist, hängt der korrekte Einsatz dieser Kommandos von dem Betriebssystem des jeweiligen Clients ab. Für die Kompatibilität lesen Sie bitte den Artikel unter: [[http:~~/~~/msdn.microsoft.com/en-us/library/aa363167(VS.85).aspx>>url:http://msdn.microsoft.com/en-us/library/aa363167(VS.85).aspx]]
--
  Für weitere Informationen über den BITS lesen Sie bitte den Artikel unter: [[http:~~/~~/msdn.microsoft.com/en-us/library/bb968799(VS.85).aspx>>url:http://msdn.microsoft.com/en-us/library/bb968799(VS.85).aspx]]
++= Add job =
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Add job>>path:javascript:HMToggle('toggle','TOGGLE0186A1','TOGGLE0186A1_ICON')]]
--
--|(((
  Mit diesem Kommando kann ein neuer BITS-Job erstellt werden. Erst über einen solchen Job kann ein Download bzw. Upload über den BITS durchgeführt werden.
--
  Geben Sie zunächst an, ob der Job einen Download oder einen Upload verwalten soll. Upload-Jobs können vom BITS aus nur eine einzige Datei hochladen. Anschließend geben Sie dem Job einen eindeutigen Namen.
--
  Zuletzt erstellen Sie eine Variable, welche Sie auswählen. In dieser Variablen wird die Job-ID gespeichert. Über diese ID können weitere BITS-Commands auf diesen Job zugreifen und ihn verwalten.
--)))
++= Add file(s) to job =
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Add file(s) to job>>path:javascript:HMToggle('toggle','TOGGLE0186A2','TOGGLE0186A2_ICON')]]
--
--|(((
  Mit diesem Kommando können einem Job Dateien, welche übertragen werden sollen, zugeordnet werden. Diese Dateien werden später durch den Job von einem Server herunter- oder auf einen Server hoch geladen.
++
  [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_6b109d3b.png||alt="Add file(s) to job" height="510" width="458"]]
++
  Add file(s) to job
  Geben Sie zunächst die Job-ID von dem Job an, dem Sie die Dateien zuordnen wollen. Anschließend geben Sie für jede Datei den lokalen Speicherort und den Speicherort auf einem Server an. Dabei muss auch der Dateiname auf dem Zielsystem angegeben werden.
--
  Über die nebenstehenden Button lassen sich zusätzliche Dateien hinzufügen oder entfernen.
--)))
++= Resume job =
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Resume job>>path:javascript:HMToggle('toggle','TOGGLE0186A3','TOGGLE0186A3_ICON')]]
--
--|(((
  Mit diesem Kommando wird ein Job gestartet, welcher die angegebenen Dateien (siehe Add file(s) to job) überträgt. Dazu geben Sie zunächst die Job-ID des entsprechenden Jobs an. Anschließend haben Sie zwei Optionen zur Verfügung:
++* Wählen Sie die Option Warte auf vollständige Übertragung, wird das Client Command erst fortgesetzt, wenn alle Dateien übertragen wurden. Ansonsten wird das Client Command direkt fortgesetzt.
++* Die zweite Option gibt einen Fehler aus, falls bei der Datenübertragung ein Fehler auftritt.
--|1.|Wählen Sie die Option Warte auf vollständige Übertragung, wird das Client Command erst fortgesetzt, wenn alle Dateien übertragen wurden. Ansonsten wird das Client Command direkt fortgesetzt.
++= Complete job =
--|2.|Die zweite Option gibt einen Fehler aus, falls bei der Datenübertragung ein Fehler auftritt.
--)))
++Dieses Kommando sorgt dafür, dass der angegebene Job (per Job-ID) korrekt abgeschlossen wird. Es sollte stets am Ende eines Jobs ausgeführt werden, um Komplikationen mit dem BITS zu vermeiden.
++= Cancel job =
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Complete job>>path:javascript:HMToggle('toggle','TOGGLE0186A4','TOGGLE0186A4_ICON')]]
--
--|Dieses Kommando sorgt dafür, dass der angegebene Job (per Job-ID) korrekt abgeschlossen wird. Es sollte stets am Ende eines Jobs ausgeführt werden, um Komplikationen mit dem BITS zu vermeiden.
--
--
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Cancel job>>path:javascript:HMToggle('toggle','TOGGLE0186A5','TOGGLE0186A5_ICON')]]
--
--|(((
  Mit diesem Kommando können Sie einen Job abbrechen. Dazu geben Sie einfach die Job-ID des entsprechenden Jobs an. Alle Kommandos, die sich nachträglich auf den Job beziehen, der mit diesem Kommando abgebrochen wird, geben einen Fehler aus, da der Job nicht mehr existiert.
  Das Kommando Complete job muss ebenfalls nicht mehr ausgeführt werden.
--)))
++= Suspend job =
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Suspend job>>path:javascript:HMToggle('toggle','TOGGLE0186A6','TOGGLE0186A6_ICON')]]
++Mit diesem Kommando können Sie die Ausführung eines Jobs unterbrechen. Dazu geben Sie die Job-ID des entsprechenden Jobs an. Eine Wiederaufnahme des Jobs ist mit dem Kommando Resume job möglich.
--|Mit diesem Kommando können Sie die Ausführung eines Jobs unterbrechen. Dazu geben Sie die Job-ID des entsprechenden Jobs an. Eine Wiederaufnahme des Jobs ist mit dem Kommando Resume job möglich.
++= Get job priority =
++Über dieses Kommando erhalten Sie eine Angabe über die aktuelle Priorität des angegebenen Jobs (Job-ID). Die Priorität wird als Integer-Wert in einer anzugebenden Variable gespeichert, welche folgende Werte annehmen kann:
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Get job priority>>path:javascript:HMToggle('toggle','TOGGLE0186A7','TOGGLE0186A7_ICON')]]
--
--|(((
--Über dieses Kommando erhalten Sie eine Angabe über die aktuelle Priorität des angegebenen Jobs (Job-ID). Die Priorität wird als Integer-Wert in einer anzugebenden Variable gespeichert, welche folgende Werte annehmen kann:
--
--
 = Vordergrund, 1 = Hoch, 2 = Normal, 3 = Niedrig
--)))
++= Set job priotity =
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Set job priotity>>path:javascript:HMToggle('toggle','TOGGLE0186A8','TOGGLE0186A8_ICON')]]
++Über dieses Kommando können Sie dem angegebenden Job (Job-ID) eine neue Priorität zuweisen. Wählen Sie dazu die entsprechende Priorität (Vordergrund, Hoch, Normal, Niedrig) über eine DropDown-Liste aus. Standardmäßig ist die Priorität auf Normal eingestellt.
--|Über dieses Kommando können Sie dem angegebenden Job (Job-ID) eine neue Priorität zuweisen. Wählen Sie dazu die entsprechende Priorität (Vordergrund, Hoch, Normal, Niedrig) über eine DropDown-Liste aus. Standardmäßig ist die Priorität auf Normal eingestellt.
++= Get job infos =
--
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Get job infos>>path:javascript:HMToggle('toggle','TOGGLE0186A9','TOGGLE0186A9_ICON')]]
--
--|(((
  Über dieses Kommando können Sie verschiedene Informationen über den angegebenen Job (Job-ID) in einer Variablen speichern lassen. Die Variable beinhaltet anschließend folgende Daten:
@@ -124,50 +124,35 @@
  siehe http:~/~/msdn.microsoft.com/en-us/library/aa362809(VS.85).aspx
  )))
--
  Auf die Daten kann über die Variable in folgendem Format zugegriffen werden:
++%VariablenName.Information%
--|%VariablenName.Information%
--)))
++= Get Notify Command Line =
++Mit diesem Kommando können Sie die Benachrichtigungsparameter auslesen, die evtl. für einen Job gesetzt sind (siehe Set Notify Command Line). Dazu geben Sie die Job-ID des Jobs an, dessen Parameter Sie auslesen möchten. Die Daten werden in einer Programmvariable sowie einer Parametervariable gespeichert, die Sie angeben müssen. Auf Grund der Architektur des BITS ist in der Parametervariablen am Anfang nochmals der Inhalt der Programmvariable in Anführungszeichen zu finden, wonach erst die Parameter aufgeführt sind.
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Get Notify Command Line>>path:javascript:HMToggle('toggle','TOGGLE0186AA','TOGGLE0186AA_ICON')]]
++= Set Notify Command Line =
--|Mit diesem Kommando können Sie die Benachrichtigungsparameter auslesen, die evtl. für einen Job gesetzt sind (siehe Set Notify Command Line). Dazu geben Sie die Job-ID des Jobs an, dessen Parameter Sie auslesen möchten. Die Daten werden in einer Programmvariable sowie einer Parametervariable gespeichert, die Sie angeben müssen. Auf Grund der Architektur des BITS ist in der Parametervariablen am Anfang nochmals der Inhalt der Programmvariable in Anführungszeichen zu finden, wonach erst die Parameter aufgeführt sind.
--
--
--|[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Set Notify Command Line>>path:javascript:HMToggle('toggle','TOGGLE0186AB','TOGGLE0186AB_ICON')]]
--
--|(((
  Mit diesem Kommando können Sie ein lokales Programm bzw. Skript oder ein Client Command angeben, welches automatisch aufgerufen wird, sobald der Job den Status BG_JOB_STATE_ERROR oder BG_JOB_STATE_TRANSFERED erreicht.
++
  [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_5702cff9.png||alt="Set Notify Command Line" height="449" width="456"]]
++
  Set Notify Command Line
  Falls Sie eine Unterscheidung zwischen den beiden Status vornehmen müssen, muss dies manuell in dem entsprechenden Programm/Skript oder dem angegebenen Client Command geschehen, da BITS selbst keinen Unterschied macht. Dafür können Sie die Job-ID als Parameter an das Programm/Skript oder das Client Command übergeben. Mit Hilfe des Tools BITSAdmin können Sie dann über die Job-ID den letzten Status abfragen. Evtl. benötigen Sie dazu ein zusätzliches Skript, welches die Unterscheidung treffen kann und anschließend erst das eigentliche Programm aufruft.
++{{aagon.infobox}}
++Weitere Informationen zu dem Tool BITSAdmin finden Sie unter folgender Adresse:http://msdn.microsoft.com/en-us/library/aa362813(VS.85).aspx
++{{/aagon.infobox}}
--|(((
--[[image:https://manual.aagon.com/acmp/de/61/hinweis.png||alt="Hinweis" height="32" width="32"]]
++{{aagon.infobox}}
++Das Client Command wartet nicht bis zur vollständigen Ausführung des angegebenen Programms/Skript oder Client Commands. Daher ist es nicht empfehlenswert, dort über die Job-ID und BITSAdmin auf den Job zuzugreifen, da die Gefahr besteht, dass der Job über das Kommando Complete Job zuvor abgeschlossen wurde. Evtl. hilft hier das Kommando Wait for Process aus dem Kapitel Kategorie Processes and Shell weiter.
++{{/aagon.infobox}}
--Hinweis:
--)))|(((
--Weitere Informationen zu dem Tool BITSAdmin finden Sie unter folgender Adresse:
--[[http:~~/~~/msdn.microsoft.com/en-us/library/aa362813(VS.85).aspx>>url:http://msdn.microsoft.com/en-us/library/aa362813(VS.85).aspx]]
--)))
--
--
--|(((
--[[image:https://manual.aagon.com/acmp/de/61/hinweis.png||alt="Hinweis" height="32" width="32"]]
--
--Hinweis:
--)))|Das Client Command wartet nicht bis zur vollständigen Ausführung des angegebenen Programms/Skript oder Client Commands. Daher ist es nicht empfehlenswert, dort über die Job-ID und BITSAdmin auf den Job zuzugreifen, da die Gefahr besteht, dass der Job über das Kommando Complete Job zuvor abgeschlossen wurde. Evtl. hilft hier das Kommando Wait for Process aus dem Kapitel [[Kategorie Processes and Shell>>url:https://manual.aagon.com/acmp/de/61/kategorieprocessesandshell.htm]] weiter.
--)))
--
--
  |[[image:https://manual.aagon.com/acmp/de/61/hmtoggle_arrow1.gif||alt="hmtoggle_arrow1" height="9" width="9"]]|[[Set Credentials>>path:javascript:HMToggle('toggle','TOGGLE0186AC','TOGGLE0186AC_ICON')]]
  |(((
@@ -177,12 +177,16 @@
  Wählen Sie zunächst aus, ob die Anmelde-informationen für einen Server oder einen Proxy bestimmt sind. Mehrere Anmeldeinformationen können genutzt werden, wenn Dateien von verschiedenen Servern geladen werden sollen.
  [[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_3b6c9501.png||alt="Set Credentials" height="449" width="398"]]
++
  Set Credentials
--
  Um die Anmeldeinformationen korrekt einzugeben, wählen Sie das Schema der Anmeldung aus (Basic, Digest, NTLM, Negotiate oder Passport). Anschließend geben Sie einen Benutzernamen und ein Passwort an.
++
++
++
++
  |(((
  [[image:https://manual.aagon.com/acmp/de/61/hinweis.png||alt="Hinweis" height="32" width="32"]]

Änderungen von Dokument BITS Commands

Zusammenfassung

Details

Navigation