Execute Jobs

There are two ways to run Client Commands: one is through the Query Management interface in the Console, and the other is through the ACMP Kiosk.

5

Execute a Query that includes the clients on which you want to execute a Client Command. Select the desired target clients and click// Run Job//s [[image:XWiki.Images.WebHome@clientcommandphase_execute_zoom30.png||alt="ClientCommandPhase_Execute" height="10" width="10"]]. In the dialog that appears, you can select the Client Commands, Job Collections, system jobs, or Windows Update Collections to be executed. To do this, double-click each job you want to run. You can also drag and drop the jobs into the right pane.

6

7

(% style="text-align:center" %)

8

[[image:ACMP.65.ACMP-Solutions.Jobs.WebHome@Manueller Job.PNG||alt="Jobs zur Ausführung auswählen" height="593" width="1008"]]

9

Select jobs to execute

10

11

Among the jobs displayed, you can define the execution as a test and then specify which [[test ring>>doc:ACMP.610.ACMP-Solutions.System.Einstellungen.Windows Update Management.WebHome||anchor="HTestandRelease"]] should be used for the test. Clicking //Next// takes you to the next page of the wizard, where you can set the [[start conditions>>doc:||anchor="HStartConditions"]] for the execution. If you do not want to set any start conditions, you can execute the jobs by clicking //Run//. The execution affects all previously selected Clients.

12

13

14

= Quick Execution via the Ribbon Bar =

15

16

Frequently used Client Commands can also be executed directly from the Query, provided that the option “Display in the //Query Actions// ribbon bar” has been selected in the [[Client Command Properties>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.Client Command Eigenschaften .WebHome||anchor="HClientCommand-SpecificProperties"]].

17

18

19

[[image:65_Client Commands_Jobs ausführen_1028.png||alt="4_64_Client Commands_Command über Abfrageverwaltung starten_1077.png" data-xwiki-image-style-alignment="center"]]

20

21

22

Execute Client Commands directly from the interface

= Quick Execution via the Context Menu =

29

30

Another way to quickly execute client commands is through the context menu of each client. The //Quick Command// menu item lists all client commands that have been explicitly enabled as Quick Commands. These commands are executed on all selected clients.

(% style="text-align:center" %)

35

[[image:XWiki.Images.WebHome@hmfile_hash_45c1e468.png||alt="Client Commands über das Kontextmenü ausführen" height="368" width="606"]]

36

Execute Client Commands via the Context Menu

37

38

39

Quick Commands are executed directly on the clients you have selected. You cannot specify a start condition.

40

41

42

If you have enabled client execution log storage in the [[Client Command options>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome]] , you can view these logs in the Client Details under Client Commands Logs or open them via the [[Job>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HJobMonitor"]]- or [[Client Monitor>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome||anchor="HClientMonitor"]].

= Start Conditions =

Unless you have specified otherwise in the start conditions, client commands will begin executing immediately.

49

50

You can read more about continuing to configure the start conditions and all related details in the [[start conditions>>doc:ACMP.610.ACMP-Solutions.Jobs.WebHome||anchor="HStartconditions"]] section.

= Delaying a Job =

Job delay is disabled by default and is not intended to affect the user or the execution of a potential job at this time. To customize the settings, you must first enable the //Users may delay job execution// checkbox.

57

58

59

[[image:63_ClientCommands_Jobausfühen_761.png||data-xwiki-image-style-alignment="center"]]

Allow job delay

Now that the prior activation has taken place, you can configure additional settings.

67

68

For example, specify how often the user is allowed to delay the job, or whether you want to set no restrictions (the user may delay execution as often as desired). Then specify which option should be used during shutdown. To do this, select whether the user is allowed to delay execution until the next shutdown or whether this is prohibited. Add a description that will be displayed to the logged-in user whenever a job is delayed. Click //Execute// to save your settings.

69

70

== **Configure the Job Delay Dialog** ==

71

72

The job delay dialog that appears can be customized. For example, you can insert a logo in the upper-right corner or replace the background with your own image.

73

74

To make these changes, first navigate to the agent installation directory //ACMPClient// (e.g., C:\Program Files (x86)\ACMPClient). Now copy the graphics for the logo and the background into that directory. Please note the following specifications for the two graphics:

75

76

|(% style="width:127px" %)Background|(% style="width:1237px" %)File name: JobDelayDialogBackground.bmp (the native resolution should be 592x193 pixels)

77

|(% style="width:127px" %)Logo|(% style="width:1237px" %)File name: JobDelayDialogBanner.bmp (the native resolution should be 110x42 pixels)

78

79

80

If you want to restore the original factory settings without any customized background or logo settings, you can simply delete the two images from the directory.

== Configure the Shutdown Dialog ==

86

87

Similar to the job delay dialog, you can also customize the shutdown dialog. To do this, the ShutdownDialog.exe interface loads the corresponding image files, allowing you to customize the interface and appearance to your corporate design. Note that a picture must be placed next to the clients for this purpose, which can be deployed via a Client Command. The Client Command places the picture file next to the client in the agent installation directory or in the directory where ACMPClientService.exe is located.

88

89

To make changes, first navigate to the agent installation directory //ACMPClient// (e.g., C:\Program Files (x86)\ACMPClient) and place the desired pictures there. The pictures should have the following dimensions:

90

91

|(% style="width:127px" %)Background|File name: ShutdownDialogBackground.bmp (The native resolution should be 600x330 pixels. The default color is a deep blue).

92

|(% style="width:127px" %)Banner|File name: ShutdownDialogBanner.bmp (The native resolution should be 110x42 pixels. The default is the ACMP logo).

93

94

author	version	line-number	content
		1	{{aagon.floatingbox/}}
		2
		3
		4	There are two ways to run Client Commands: one is through the Query Management interface in the Console, and the other is through the ACMP Kiosk.
		5	Execute a Query that includes the clients on which you want to execute a Client Command. Select the desired target clients and click// Run Job//s [[image:XWiki.Images.WebHome@clientcommandphase_execute_zoom30.png\|\|alt="ClientCommandPhase_Execute" height="10" width="10"]]. In the dialog that appears, you can select the Client Commands, Job Collections, system jobs, or Windows Update Collections to be executed. To do this, double-click each job you want to run. You can also drag and drop the jobs into the right pane.
		6
		7	(% style="text-align:center" %)
		8	[[image:ACMP.65.ACMP-Solutions.Jobs.WebHome@Manueller Job.PNG\|\|alt="Jobs zur Ausführung auswählen" height="593" width="1008"]]
		9	Select jobs to execute
		10
		11	Among the jobs displayed, you can define the execution as a test and then specify which [[test ring>>doc:ACMP.610.ACMP-Solutions.System.Einstellungen.Windows Update Management.WebHome\|\|anchor="HTestandRelease"]] should be used for the test. Clicking //Next// takes you to the next page of the wizard, where you can set the [[start conditions>>doc:\|\|anchor="HStartConditions"]] for the execution. If you do not want to set any start conditions, you can execute the jobs by clicking //Run//. The execution affects all previously selected Clients.
		12
		13
		14	= Quick Execution via the Ribbon Bar =
		15
		16	Frequently used Client Commands can also be executed directly from the Query, provided that the option “Display in the //Query Actions// ribbon bar” has been selected in the [[Client Command Properties>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.Client Command Eigenschaften .WebHome\|\|anchor="HClientCommand-SpecificProperties"]].
		17
		18	{{figure}}
		19	[[image:65_Client Commands_Jobs ausführen_1028.png\|\|alt="4_64_Client Commands_Command über Abfrageverwaltung starten_1077.png" data-xwiki-image-style-alignment="center"]]
		20
		21	{{figureCaption}}
		22	Execute Client Commands directly from the interface
		23	{{/figureCaption}}
		24	{{/figure}}
		25
		26
		27
		28	= Quick Execution via the Context Menu =
		29
		30	Another way to quickly execute client commands is through the context menu of each client. The //Quick Command// menu item lists all client commands that have been explicitly enabled as Quick Commands. These commands are executed on all selected clients.
		31
		32
		33
		34	(% style="text-align:center" %)
		35	[[image:XWiki.Images.WebHome@hmfile_hash_45c1e468.png\|\|alt="Client Commands über das Kontextmenü ausführen" height="368" width="606"]]
		36	Execute Client Commands via the Context Menu
		37
		38	{{aagon.infobox}}
		39	Quick Commands are executed directly on the clients you have selected. You cannot specify a start condition.
		40	{{/aagon.infobox}}
		41
		42	If you have enabled client execution log storage in the [[Client Command options>>doc:ACMP.610.ACMP-Solutions.Desktop Automation.Client Commands.Client Command erstellen.Client Commands neu hinzufügen.Client Command Editor.Menüleiste.WebHome]] , you can view these logs in the Client Details under Client Commands Logs or open them via the [[Job>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome\|\|anchor="HJobMonitor"]]- or [[Client Monitor>>doc:ACMP.610.Arbeiten mit der ACMP Console.Aufbau der Console.Ribbonleiste.Monitore.WebHome\|\|anchor="HClientMonitor"]].
		43
		44
		45
		46	= Start Conditions =
		47
		48	Unless you have specified otherwise in the start conditions, client commands will begin executing immediately.
		49
		50	You can read more about continuing to configure the start conditions and all related details in the [[start conditions>>doc:ACMP.610.ACMP-Solutions.Jobs.WebHome\|\|anchor="HStartconditions"]] section.
		51
		52
		53
		54	= Delaying a Job =
		55
		56	Job delay is disabled by default and is not intended to affect the user or the execution of a potential job at this time. To customize the settings, you must first enable the //Users may delay job execution// checkbox.
		57
		58	{{figure}}
		59	[[image:63_ClientCommands_Jobausfühen_761.png\|\|data-xwiki-image-style-alignment="center"]]
		60
		61	{{figureCaption}}
		62	Allow job delay
		63	{{/figureCaption}}
		64	{{/figure}}
		65
		66	Now that the prior activation has taken place, you can configure additional settings.
		67
		68	For example, specify how often the user is allowed to delay the job, or whether you want to set no restrictions (the user may delay execution as often as desired). Then specify which option should be used during shutdown. To do this, select whether the user is allowed to delay execution until the next shutdown or whether this is prohibited. Add a description that will be displayed to the logged-in user whenever a job is delayed. Click //Execute// to save your settings.
		69
		70	== Configure the Job Delay Dialog ==
		71
		72	The job delay dialog that appears can be customized. For example, you can insert a logo in the upper-right corner or replace the background with your own image.
		73
		74	To make these changes, first navigate to the agent installation directory //ACMPClient// (e.g., C:\Program Files (x86)\ACMPClient). Now copy the graphics for the logo and the background into that directory. Please note the following specifications for the two graphics:
		75
		76	\|(% style="width:127px" %)Background\|(% style="width:1237px" %)File name: JobDelayDialogBackground.bmp (the native resolution should be 592x193 pixels)
		77	\|(% style="width:127px" %)Logo\|(% style="width:1237px" %)File name: JobDelayDialogBanner.bmp (the native resolution should be 110x42 pixels)
		78
		79	{{aagon.infobox}}
		80	If you want to restore the original factory settings without any customized background or logo settings, you can simply delete the two images from the directory.
		81	{{/aagon.infobox}}
		82
		83
		84
		85	== Configure the Shutdown Dialog ==
		86
		87	Similar to the job delay dialog, you can also customize the shutdown dialog. To do this, the ShutdownDialog.exe interface loads the corresponding image files, allowing you to customize the interface and appearance to your corporate design. Note that a picture must be placed next to the clients for this purpose, which can be deployed via a Client Command. The Client Command places the picture file next to the client in the agent installation directory or in the directory where ACMPClientService.exe is located.
		88
		89	To make changes, first navigate to the agent installation directory //ACMPClient// (e.g., C:\Program Files (x86)\ACMPClient) and place the desired pictures there. The pictures should have the following dimensions:
		90
		91	\|(% style="width:127px" %)Background\|File name: ShutdownDialogBackground.bmp (The native resolution should be 600x330 pixels. The default color is a deep blue).
		92	\|(% style="width:127px" %)Banner\|File name: ShutdownDialogBanner.bmp (The native resolution should be 110x42 pixels. The default is the ACMP logo).
		93
		94

Wiki source code of Jobs ausführen