You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: articles/iot-central/core/howto-run-a-job.md
+29-25Lines changed: 29 additions & 25 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,6 +1,6 @@
1
1
---
2
2
title: Create and run jobs in your Azure IoT Central application | Microsoft Docs
3
-
description: Azure IoT Central jobs allow for bulk device management capabilities, such as updating a device property, setting, or executing a command.
3
+
description: Azure IoT Central jobs allow for bulk device management capabilities, such as updating properties or executing a command.
4
4
ms.service: iot-central
5
5
services: iot-central
6
6
author: sarahhubbard
@@ -12,57 +12,61 @@ manager: peterpr
12
12
13
13
# Create and run a job in your Azure IoT Central application
14
14
15
-
You can use Microsoft Azure IoT Central to manage your connected devices at scale using jobs. Jobs let you do bulk updates to device properties and commands. This article walks you through how to get started using jobs in your own application.
16
-
15
+
You can use Microsoft Azure IoT Central to manage your connected devices at scale using jobs. Jobs let you do bulk updates to device properties and run commands. This article shows you how to get started using jobs in your own application.
17
16
18
17
## Create and run a job
19
18
20
-
This section shows you how to create and run a job. It shows you how to increase the fan speed for multiple refrigerated vending machines.
19
+
This section shows you how to create and run a job. It shows you how to set the light threshold for a group of logistic gateway devices.
21
20
22
-
1. Navigate to Jobs from the navigation pane.
21
+
1. Navigate to **Jobs** from the left pane.
23
22
24
-
2. Select **+ New** to create a new job.
23
+
2. Select **+ New** to create a new job:
25
24
26
-
25
+
> [!div class="mx-imgBorder"]
26
+
> 
27
27
28
28
3. Enter a name and description to identify the job you're creating.
29
29
30
-
4. Select the device group you want your job to apply to. You can see how many devices your job configuration will be applied to in the Summary section.
31
-
32
-
5. Next, choose the type of job to define (property or command). Set up the job configuration by selection the property and setting new values or choose a command. It is possible to add multiple properties at a time.
30
+
4. Select the target device group you want your job to apply to. You can see how many devices your job configuration applies to in the **Summary** section.
5. Next, choose either **Property** or **Command** as the type of job to configure. To set up a **Property**job configuration, select a property and set its new value. To set up a **Command**, or choose the command to run. A property job can set multiple properties:
35
33
36
-
6. On the right-hand side, choose the devices you'd like to run the job on. By selecting the top check box, all devices are selected in the entire device set. By selecting the check box near **Name**, all devices on the current page are selected.
7. After selecting your devices, choose **Run** or **Save**. The job now appears on your main **Jobs** page. On this view, you can see your currently running job and the history of any previously run jobs. Your running job always shows up at the top of the list. Your saved job can be opened again at any time to continue editing or to run.
37
+
6. After selecting your devices, choose **Run** or **Save**. The job now appears on your main **Jobs** page. On this page, you can see your currently running job and the history of any previously run or saved jobs. Your saved job can be opened again at any time to continue editing it or to run it:
> You can view the history of your previously run jobs for up to 30 days.
43
+
> You can view up 30 days of history for your previously run jobs.
44
44
45
-
7. To get an overview of your job, select the job to view from the list. This overview contains the job details, devices, and device status values. From this overview, you can also select **Download Job Details** to download a .csv file of your job details, including the devices and their status values. This information can be useful for troubleshooting.
45
+
7. To get an overview of your job, select the job to view from the list. This overview contains the job details, devices, and device status values. From this overview, you can also select **Download Job Details** to download a CSV file of your job details, including the devices and their status values. This information can be useful for troubleshooting:
To stop a running job, select it and choose**Stop**. The job status changes to reflect the job is stopped.
52
+
To stop one of your running jobs, open it and select**Stop**. The job status changes to reflect the job is stopped. The **Summary** section shows which devices have completed, failed, or are still pending:
To run a job that's currently stopped, select the stopped job. Choose**Run** on the panel. The job status changes to reflect the job is now running again.
59
+
To run a job that's currently stopped, select it, and then select**Run**. The job status changes to reflect the job is now running again. The **Summary** section continues to update with the latest progress:
To copy an existing job you've created, open a job that has been created and select **Copy**. A new copy of the job configuration opens for you to edit. You can save or run the new job.
66
+
To copy one of your existing jobs, open it and select **Copy**. A copy of the job configuration opens for you to edit, and **Copy** is appended to the end of the job name. You can save or run the new job:
@@ -85,7 +89,7 @@ The status message is followed by an overview of the devices in the job. The fol
85
89
86
90
### View the device status
87
91
88
-
To view the status of the job and all the affected devices, select the job. To download a .csv file that includes the job details, including the list of devices and their status values, select **Download job details**. Next to each device name, you see one of the following status messages:
92
+
To view the status of the job and all the affected devices, select the job. To download a CSV file that includes the job details, including the list of devices and their status values, select **Download job details**. Next to each device name, you see one of the following status messages:
0 commit comments