Wiki-Quellcode von BITS Commands

Zuletzt geändert von Jannis Klein am 2024/03/19 17:59

version	line-number	content
2.1	1	{{aagon.priorisierung}}
	2	60
	3	{{/aagon.priorisierung}}
	4
	5	{{aagon.floatingbox/}}
3.2	6
	7	Ü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.
	8
	9	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.
	10
12.1	11	(% style="width:795px" %)
	12	\|(((
8.1	13	(% style="text-align:center" %)
11.1	14	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_21c3fb4a.png\|\|alt="Add job" height="449" width="398"]]
13.1	15
	16
11.1	17	Add Job
12.1	18	)))
3.2	19
	20	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]]
	21
3.3	22	= Add job =
3.2	23
	24	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.
	25
	26	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.
	27
	28	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.
	29
3.3	30	= Add file(s) to job =
3.2	31
	32	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.
	33
3.3	34
8.1	35	(% style="text-align:center" %)
3.2	36	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_6b109d3b.png\|\|alt="Add file(s) to job" height="510" width="458"]]
	37	Add file(s) to job
	38
	39
	40	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.
	41
	42	Über die nebenstehenden Button lassen sich zusätzliche Dateien hinzufügen oder entfernen.
	43
3.3	44	= Resume job =
3.2	45
	46	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:
	47
3.3	48	* 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.
	49	* Die zweite Option gibt einen Fehler aus, falls bei der Datenübertragung ein Fehler auftritt.
3.2	50
3.3	51	= Complete job =
3.2	52
3.3	53	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.
3.2	54
3.3	55	= Cancel job =
3.2	56
	57	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.
	58
	59	Das Kommando Complete job muss ebenfalls nicht mehr ausgeführt werden.
	60
3.3	61	= Suspend job =
3.2	62
3.3	63	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.
3.2	64
3.3	65	= Get job priority =
3.2	66
4.1	67	Ü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:
3.2	68
	69	0 = Vordergrund, 1 = Hoch, 2 = Normal, 3 = Niedrig
	70
3.3	71	= Set job priotity =
3.2	72
3.3	73	Ü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.
3.2	74
3.3	75	= Get job infos =
3.2	76
	77	Ü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:
	78
	79
	80	\|(((
	81	Name
	82
	83	Deskription
	84
	85	JobType
	86
	87	Owner
	88
	89	State
	90	)))\|(((
	91	Der Name des Jobs (Add job).
	92
	93	Eine Beschreibung des Jobs.
	94
	95	Der Typ ist DownloadJob oder UploadJob.
	96
	97	Die SID des Benutzers, der diesen Job erstellt hat.
	98
	99	siehe http:~/~/msdn.microsoft.com/en-us/library/aa362809(VS.85).aspx
	100	)))
	101
	102	Auf die Daten kann über die Variable in folgendem Format zugegriffen werden:
	103
3.3	104	%VariablenName.Information%
3.2	105
4.1	106	= Get Notify Command Line =
3.2	107
4.1	108	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.
3.2	109
4.1	110	= Set Notify Command Line =
3.2	111
4.1	112	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.
3.2	113
8.1	114	(% style="text-align:center" %)
4.1	115	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_5702cff9.png\|\|alt="Set Notify Command Line" height="449" width="456"]]
3.2	116	Set Notify Command Line
	117
	118	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.
	119
4.1	120	{{aagon.infobox}}
14.1	121	Weitere Informationen zu dem Tool BITSAdmin finden Sie unter folgender [[http:~~/~~/msdn.microsoft.com/en-us/library/aa362813(VS.85).aspx>>url:http://msdn.microsoft.com/en-us/library/aa362813(VS.85).aspx]]
4.1	122	{{/aagon.infobox}}
3.2	123
4.1	124	{{aagon.infobox}}
4.2	125	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. Eventuell hilft hier das Kommando Wait for Process aus dem Kapitel Kategorie Processes and Shell weiter.
4.1	126	{{/aagon.infobox}}
3.2	127
5.2	128	= Set Credentials =
3.2	129
5.2	130	Mit diesem Kommando können Sie dem Job Anmeldeinformationen übergeben, falls diese für den Server oder einen Proxy benötigt werden.
3.2	131
5.2	132	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.
	133
8.1	134	(% style="text-align:center" %)
5.2	135	[[image:https://manual.aagon.com/acmp/de/61/hmfile_hash_3b6c9501.png\|\|alt="Set Credentials" height="449" width="398"]]
	136	Set Credentials
	137
	138	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.
	139
	140	{{aagon.infobox}}
	141	BITS kann von Haus aus keine Credentials für UNC-Freigaben nutzen. Dort sollten Sie die Kommandos aus dem Kapitel Internet nutzen.
	142	{{/aagon.infobox}}
	143
5.3	144	{{aagon.infobox}}
15.1	145	Für die Auswahl des Schema finden Sie unter folgenden Links weitere [[http:~~/~~/msdn.microsoft.com/en-us/library/aa362793(VS.85).aspx>>url:http://msdn.microsoft.com/en-us/library/aa362793(VS.85).aspx]]
5.3	146	{{/aagon.infobox}}
5.2	147
6.1	148	= Remove Credentials =
5.3	149
6.1	150	Mit diesem Kommando können Sie Anmeldeinformationen eines Jobs wieder löschen. Dazu geben Sie die Job-ID an. Anschließend wählen Sie aus, ob es sich um Anmeldeinformationen für einen Server oder einen Proxy handelt. Zuletzt wählen Sie das Schema aus, dessen Informationen gelöscht werden sollen.
5.2	151
6.1	152	= Iterate jobs =
5.2	153
6.1	154	Mit diesem Kommando können Sie alle BITS Jobs schleifenartig durchlaufen. Dabei werden die Job-ID sowie der Jobname bei jedem Durchlauf für den jeweils aktuellen Job in entsprechenden Variablen gespeichert. Zusätzlich wählen Sie noch aus, ob nur die Jobs des aktuellen Benutzers oder die Jobs aller Benutzer durchlaufen werden sollen. Über untergeordnete Kommandos können Sie die Informationen weiter verarbeiten.
5.2	155
6.1	156	= Iterate files of job =
5.2	157
6.1	158	Über dieses Kommando können Sie alle Dateien (Add file(s) to job) eines Jobs (Job-ID) durchlaufen. Dabei wird der Dateipfad und -name der jeweiligen lokalen Datei sowie der Server-Datei in entsprechenden Variablen gespeichert. Über untergeordnete Kommandos können Sie die Informationen weiter verarbeiten.

Wiki-Quellcode von BITS Commands

Navigation