Skip to content

Commit f171d25

Browse files
authored
Merge pull request #53264 from rjagiewich/iot-central-how-to-administer
edit pass - IOT central how to administer
2 parents 9b7b5a5 + 2970a9b commit f171d25

File tree

1 file changed

+51
-51
lines changed

1 file changed

+51
-51
lines changed

articles/iot-central/howto-administer.md

Lines changed: 51 additions & 51 deletions
Original file line numberDiff line numberDiff line change
@@ -10,9 +10,9 @@ services: iot-central
1010
manager: peterpr
1111
---
1212

13-
# How to administer your application
13+
# Administer your IOT Central application
1414

15-
After you create a Microsoft Azure IoT Central application, you can use the **Administration** section of the Azure IoT Central user interface to administer it. To navigate to the **Administration** section, choose **Administration** on the left navigation menu.
15+
After you create a Microsoft Azure IoT Central application, you can use the **Administration** section of the Azure IoT Central user interface to administer it. To go to the **Administration** section, select **Administration** on the left navigation menu.
1616

1717
The **Administration** section enables you to:
1818

@@ -24,51 +24,51 @@ The **Administration** section enables you to:
2424

2525
- Manage application settings
2626

27-
- Extend a free trial
27+
- Offer a free trial
2828

29-
In the **Administration** section, there is a secondary navigation menu with links to the various administration tasks.
29+
In the **Administration** section, a secondary navigation menu has links to the various administration tasks.
3030

31-
To access and use the **Administration** section, you must be in the **Administrator** role in the Azure IoT Central application. If you create an Azure IoT Central application, you are automatically assigned to the **Administrator** role for that application. The *Managing Users* section in this article explains more about how to assign the **Administrator** role to other users.
31+
To access and use the **Administration** section, you must be in the **Administrator** role for an Azure IoT Central application. If you create an Azure IoT Central application, you're automatically assigned to the **Administrator** role for that application. The *Managing Users* section in this article explains more about how to assign the **Administrator** role to other users.
3232

3333
## Change application name
3434

35-
To change the name of your application, use the secondary navigation menu to navigate to the **Application Settings** page in the **Administration** section.
35+
To change the name of your application, use the secondary navigation menu to go to the **Application Settings** page in the **Administration** section.
3636

37-
On the **Application Settings** page, enter a name of your choice in the **Application Name** field, and then choose **Save**.
37+
On the **Application Settings** page, enter a name of your choice in the **Application Name** field. Then select **Save**.
3838

3939
## Change the application URL
4040

4141
To change the URL for your application, use the secondary navigation menu to navigate to the **Application Settings** page in the **Administration** section.
4242

43-
![Application Settings Page](media\howto-administer\image0-a.png)
43+
![Application settings page](media\howto-administer\image0-a.png)
4444

45-
On the **Application Settings** page, enter the URL of your choice in the **URL** field, and then choose **Save**. Your URL can be at most 200 characters in length. If the URL is not available, you see a validation error
45+
On the **Application Settings** page, enter the URL of your choice in the **URL** field, and then select **Save**. Your URL can be at most 200 characters in length. If the URL isn't available, you see a validation error.
4646

4747
> [!Note]
48-
> If you change your URL, your old URL can be taken by another Azure IoT Central customer. In that case, it is no longer available for you to use. When you change your URL, the old URL no longer works and you must notify your users about the new URL to use.
48+
> If you change your URL, your old URL can be taken by another Azure IoT Central customer. If that happens, it is no longer available for you to use. When you change your URL, the old URL no longer works, and you need to notify your users about the new URL to use.
4949
5050
## Change the application image
5151

5252
For more information about using images in an Azure IoT Central application, see [Prepare and upload images to your Azure IoT Central application](howto-prepare-images.md).
5353

5454
## Copy an application
5555

56-
You can create a copy of any application, minus any device instances, device data history, and user data. The copy will be a paid application that you'll be charged for. You cannot create a trial application by copying another application.
56+
You can create a copy of any application, minus any device instances, device data history, and user data. The copy will be a paid application that you're charged for. You can't create a trial application by copying another application.
5757

58-
To copy an application, navigate to the **Application Settings** page and click the **Copy** button.
58+
To copy an application, go to the **Application Settings** page. Then select the **Copy** button.
5959

60-
![Application Settings page](media\howto-administer\appCopy1.png)
60+
![Application settings page](media\howto-administer\appCopy1.png)
6161

62-
Clicking the **Copy** button will open a dialog in which you can select a name, URL, AAD directory, subscription and Azure region for the new application that will be created by copying your application. Select values for each of those fields and then click the **Copy** button to confirm that you want to proceed. You can learn more about what to enter for those values in the article about [how to create an application](howto-create-application.md).
62+
Selecting the **Copy** button opens a dialog box in which you can select a name, URL, Azure AD directory, subscription, and Azure region for the new application that will be created by copying your application. Select values for each of those fields. Then select the **Copy** button to confirm that you want to proceed. You can learn more about what to enter for those values in this article about [how to create an application](howto-create-application.md).
6363

64-
![Application Settings page](media\howto-administer\appCopy2.png)
64+
![Application settings page](media\howto-administer\appCopy2.png)
6565

66-
Once the app copy operation succeeds, you will be able to navigate to the new application that was created by copying your application by clicking the link that appears on the **Application Settings** page.
66+
After the app copy operation succeeds, you can go to the new application that was created by copying your application. To go to the app, select the link that appears on the **Application Settings** page.
6767

68-
![Application Settings page](media\howto-administer\appCopy3.png)
68+
![Application settings page](media\howto-administer\appCopy3.png)
6969

7070
> [!Note]
71-
> Copying an application will copy the definition of rules or actions. However, since users that have access to your original app aren't copied to the copied app, you'll have to manually add users to actions such as email for which users are a pre-requisite.
71+
> Copying an application also copies the definition of rules or actions. But because users who have access to your original app aren't copied to the copied app, you have to manually add users to actions such as email for which users are a pre-requisite.
7272
7373
## Delete an application
7474

@@ -77,17 +77,17 @@ To delete your application, use the secondary navigation menu to navigate to the
7777
Choose **Delete**.
7878

7979
> [!Note]
80-
> Deleting an application irrecoverably deletes all data associated with the application. To delete an application, you must also have the rights to delete resources in the Azure subscription you chose when you created the application. To learn more, see [Use Role-Based Access Control to manage access to your Azure subscription resources](https://docs.microsoft.com/azure/active-directory/role-based-access-control-configure).
80+
> Deleting an application permanently deletes all data that's associated with that application. To delete an application, you must also have permissions to delete resources in the Azure subscription you chose when you created the application. To learn more, see [Use role-based access control to manage access to your Azure subscription resources](https://docs.microsoft.com/azure/active-directory/role-based-access-control-configure).
8181
8282
## Roles in Azure IoT Central
8383

84-
Roles enable you to control who, within your organization, can perform various Azure IoT Central tasks. Azure IoT Central has three roles you can assign to users of your application. Roles are assigned by each application. The same user can have different roles in different applications. You can assign the same user can to multiple roles within an application.
84+
Roles enable you to control who within your organization can perform various Azure IoT Central tasks. Azure IoT Central has three roles you can assign to users of your application. Roles are assigned by each application. The same user can have different roles in different applications. You can assign the same user to multiple roles within an application.
8585

8686
### Administrator
8787

8888
Users in the **Administrator** role have access to all functionality in an Azure IoT Central application.
8989

90-
The user creating an application is automatically assigned to the **Administrator** role. There must always be at least one user in the **Administrator** role.
90+
The user who creates an application is automatically assigned to the **Administrator** role. There must always be at least one user in the **Administrator** role.
9191

9292
### Application Builder
9393

@@ -103,74 +103,74 @@ Application administrators can assign users to the roles in the application.
103103

104104
### Add users
105105

106-
Every user must have a user account before they can sign in and access an Azure IoT Central application. Microsoft Accounts (MSAs) and Azure Active Directory (AAD) accounts are supported in Azure IoT Central. Azure Active Directory groups are not currently supported in Azure IoT Central.
106+
Every user must have a user account before they can sign in and access an Azure IoT Central application. Microsoft Accounts (MSAs) and Azure Active Directory (Azure AD) accounts are supported in Azure IoT Central. Azure Active Directory groups aren't currently supported in Azure IoT Central.
107107

108-
To learn more, see [Microsoft account help](https://support.microsoft.com/products/microsoft-account?category=manage-account) and [Quickstart: Add new users to Azure Active Directory](https://docs.microsoft.com/azure/active-directory/add-users-azure-active-directory).
108+
For more information, see [Microsoft account help](https://support.microsoft.com/products/microsoft-account?category=manage-account) and [Quickstart: Add new users to Azure Active Directory](https://docs.microsoft.com/azure/active-directory/add-users-azure-active-directory).
109109

110-
1. To add a user account to an Azure IoT Central application, use the secondary navigation menu to navigate to the **Users** page in the **Administration** section.
110+
1. To add a user account to an Azure IoT Central application, use the secondary navigation menu to go to the **Users** page in the **Administration** section.
111111

112-
![List of Users](media\howto-administer\image1.png)
112+
![List of users](media\howto-administer\image1.png)
113113

114-
1. On the **Users** page, choose **+ Add user** to add a user.
114+
1. To add a user, on the **Users** page, choose **+ Add user**.
115115

116-
![Add User](media\howto-administer\image2.png)
116+
![Add user](media\howto-administer\image2.png)
117117

118-
1. When you add a user to your Azure IoT Central application, choose a role for the user from the **Role** drop-down. Learn more about roles in the *Roles in Azure IoT Central* section of this article.
118+
1. Choose a role for the user from the **Role** drop-down menu. Learn more about roles in the *Roles in Azure IoT Central* section of this article.
119119

120-
![Role Selection](media\howto-administer\image3.png)
120+
![Role selection](media\howto-administer\image3.png)
121121

122122
> [!NOTE]
123-
> To add users in bulk, enter the User IDs of all the users you'd like to add separated by semi-colons. Choose a role from the **Role** drop-down and choose **Save**.
123+
> To add users in bulk, enter the user IDs of all the users you'd like to add separated by semi-colons. Choose a role from the **Role** drop-down menu. Then select **Save**.
124124
125125
1. After you add a user, an entry appears for that user on the **Users** page.
126126

127-
![User List](media\howto-administer\image4.png)
127+
![User list](media\howto-administer\image4.png)
128128

129-
### Edit the roles assigned to users
129+
### Edit the roles that are assigned to users
130130

131-
Roles cannot be changed once assinged. To change the role assigned to a user, delete the user and add the user again with a different role.
131+
Roles can't be changed after they are assigned. To change the role that's assigned to a user, delete the user, and then add the user again with a different role.
132132

133133
### Delete users
134134

135-
To delete users, check one or more checkboxes on the **Users** page and then choose **Delete**.
135+
To delete users, select one or more check boxes on the **Users** page. Then select **Delete**.
136136

137137
## View your bill
138138

139-
To view your bill, navigate to the **Billing** page in the **Administration** section and choose **Billing**. The Azure billing page opens in a new tab and you can see the bill for each of your Azure IoT Central applications.
139+
To view your bill, go to the **Billing** page in the **Administration** section. Then select **Billing**. The Azure billing page opens in a new tab, where you can see the bill for each of your Azure IoT Central applications.
140140

141141
## Convert your trial to a paid application
142142

143-
Once you've evaluated IoT Central, you can convert your trial to a paid application. To complete this self-service process, follow these steps:
143+
After you've evaluated IoT Central, you can convert your trial to a paid application. To complete this self-service process, follow these steps:
144144

145-
1. Use the secondary navigation menu to navigate to the **Billing** page in the **Administration** section. If you haven't extended your trial, the page looks like the following:
145+
1. Use the secondary navigation menu to go to the **Billing** page in the **Administration** section. If you haven't extended your trial, the page looks like the following screenshot:
146146

147147
![Free trial state](media/howto-administer/freetrial.png)
148148

149-
2. Click **Convert to Paid**. If you haven't extended your trial, the pop-up looks like the following:
150-
151-
In the pop-up select the appropriate Azure Active Directory tenant and then the Azure Subscription that you want to use for your IoT Central application.
149+
2. Select **Convert to Paid**. If you haven't extended your trial, the pop-up window looks like the following screenshot:
152150

153151
![Extend free trial](media/howto-administer/extend.png)
154152

155-
3. After you click **Convert**, your trial is converted to a paid application and you start getting billed.
153+
3. In the pop-up window, select the appropriate Azure Active Directory tenant, and then the Azure subscription to use for your IoT Central application.
154+
155+
3. After you select **Convert**, your trial coverts to a paid application and you start getting billed.
156156

157157
## Extend your free trial
158158

159-
By default, all free trials are available for 7 days. If you'd like to increase your trial to 30 days, you follow these steps:
159+
By default, all free trials are available for seven days. If you'd like to increase your trial to 30 days, follow these steps:
160160

161-
1. Use the secondary navigation menu to navigate to the **Billing** page in the **Administration** section:
161+
1. Use the secondary navigation menu to go to the **Billing** page in the **Administration** section.
162162

163-
1. Click **Extend Trial**. In the pop-up select the appropriate Azure Active Directory tenant and then the Azure Subscription to use for your IoT Central application:
163+
1. Select **Extend Trial**. In the pop-up window, select the appropriate Azure Active Directory tenant and then the Azure subscription to use for your IoT Central application.
164164

165-
1. Then click **Extend**. Your trial is now valid for 30 days.
165+
1. Then select **Extend**. Your trial is now valid for 30 days.
166166

167-
## Utilize the Azure SDKs to do control plane operations
167+
## Use the Azure SDKs for control plane operations
168168

169-
IoT Central Azure Resource Manager SDK packages are available for Node, Python, C#, Ruby, Java, and Go. These libraries support control plane operations for IoT Central, allowing you to create, list, update, or delete IoT Central applications. They also provide helpers for dealing with authentication and error handling that is specific to each language.
169+
IoT Central Azure Resource Manager SDK packages are available for Node, Python, C#, Ruby, Java, and Go. These libraries support control plane operations for IoT Central, which enable you to create, list, update, or delete IoT Central applications. They also provide helpers for dealing with authentication and error handling that is specific to each language.
170170

171-
Examples of using the Azure Resource Manager SDKs can be found at [https://github.com/emgarten/iotcentral-arm-sdk-examples](https://github.com/emgarten/iotcentral-arm-sdk-examples).
171+
You can find examples of how to use the Azure Resource Manager SDKs at [https://github.com/emgarten/iotcentral-arm-sdk-examples](https://github.com/emgarten/iotcentral-arm-sdk-examples).
172172

173-
To learn more take a look at these packages on GitHub.
173+
To learn more, take a look at these packages on GitHub.
174174

175175
| Language | Repository | Package |
176176
| ---------| ---------- | ------- |
@@ -183,7 +183,7 @@ To learn more take a look at these packages on GitHub.
183183

184184
## Next steps
185185

186-
Now that you have learned how to administer your Azure IoT Central application, here is the suggested next step:
186+
Now that you've learned how to administer your Azure IoT Central application, here is the suggested next step:
187187

188188
> [!div class="nextstepaction"]
189-
> [Set up the device template](howto-set-up-template.md)
189+
> [Set up the device template](howto-set-up-template.md)

0 commit comments

Comments
 (0)