Merge pull request #83747 from v-krghan/adminpage

Adminpage

Author: GitHubber17

articles/iot-central/TOC.yml

@@ -100,16 +100,20 @@
 
   - name : Administration
     items:
-      - name: Administer your application
-        href: howto-administer.md  
+      - name: Manage your application
+        href: howto-administer.md 
+      - name: Manage users and roles
+        href: howto-manage-users-roles.md 
+      - name: View your bill
+        href: howto-view-bill.md
+      - name: Customize application UI
+        href: howto-customize-ui.md  
       - name: Prepare and upload image
         href: howto-prepare-images.md
       - name: Configure application dashboard
         href: howto-configure-homepage.md
       - name: Use dashboard tiles
         href: howto-use-tiles.md
-      - name: Customize application UI
-        href: howto-customize-ui.md
       - name: Use application templates
         href: howto-use-app-templates.md
       - name: Manage from the Azure portal

articles/iot-central/howto-administer.md

@@ -1,6 +1,6 @@
 ---
-title: Administer an Azure IoT Central application | Microsoft Docs
-description: As an administrator, how to administer your Azure IoT Central application
+title: Manage your Azure IoT Central application | Microsoft Docs
+description: As an administrator, how to manage your Azure IoT Central application by changing application name, URL, upload image, copy, and delete an application
 author: viv-liu
 ms.author: viviali
 ms.date: 04/26/2019
@@ -10,27 +10,14 @@ services: iot-central
 manager: peterpr
 ---
 
-# Administer your IoT Central application
+# Manage your IoT Central application
 
-After you create an IoT Central application, you can go to the **Administration** section to:
+This article describes how, as an administrator, you can manage application by changing application name and URL, uploading image, also you can learn how to copy, and delete an application in your Azure IoT Central application.
 
-- Manage application settings
-- Manage users
-- Manage roles
-- View your bill
-- Convert your Trial to Pay-As-You-Go
-- Export data
-- Manage device connection
-- Use access tokens for developer tools
-- Customize the UI of your application
-- Customize help links in the application
-- Manage IoT Central programmatically
+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. 
 
-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 [Manage Users](#manage-users) section in this article explains more about how to assign the **Administrator** role to other users.
+## Change application name and URL
 
-## Manage application settings
-
-### Change application name and URL
 In the **Application Settings** page, you can change the name and URL of your application, then select **Save**.
 
 ![Application settings page](media/howto-administer/image0-a.png)
@@ -40,10 +27,12 @@ If your administrator creates a custom theme for your application, this page inc
 > [!Note]
 > 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.
 
-### Prepare and upload image
+## Prepare and upload image
+
 To change the application image, see [Prepare and upload images to your Azure IoT Central application](howto-prepare-images.md).
 
-### Copy an application
+## Copy an application
+
 You can create a copy of any application, minus any device instances, device data history, and user data. The copy is a Pay-As-You-Go application that you'll be charged for. You can't create a Trial application in this way.
 
 Select **Copy**. In the dialog box, enter the details for the new Pay-As-You-Go application. Then select **Copy** to confirm that you want to continue. Learn more about the fields in this form in [Create an application](quick-deploy-iot-central.md) quickstart.
@@ -54,111 +43,18 @@ After the app copy operation succeeds, you can navigate to the new application u
 
 ![Application settings page](media/howto-administer/appcopy3a.png)
 
-Copying an application also copies the definition of rules and email action. Some actions like Flow, Logic Apps etc. are tied to specific rules via the Rule ID. When a rule is copied to a different application, it gets its own Rule ID. In this case, users will have to create a new action and then associate the new rule with it. In general, it is a good idea to check the rules and actions to make sure they are up to date in the new app.
+Copying an application also copies the definition of rules and email action. Some actions like Flow, Logic Apps etc. are tied to specific rules via the Rule ID. When a rule is copied to a different application, it gets its own Rule ID. In this case, users will have to create a new action and then associate the new rule with it. In general, it is a good idea to check the rules and actions to make sure they are up-to-date in the new app.
 
 > [!WARNING]
 > If a dashboard includes tiles that display information about specific devices, then those tiles show **The requested resource was not found** in the new application. You must reconfigure these tiles to display information about devices in your new application.
 
-### Delete an application
+## Delete an application
 
 Use the **Delete** button to permanently delete your IoT Central application. This action permanently deletes all data that's associated with the application.
 
 > [!Note]
 > 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).
 
-## Manage users
-
-### Add users
-
-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.
-
-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).
-
-1. To add a user to an IoT Central application, go to the **Users** page in the **Administration** section.
-
-    ![List of users](media/howto-administer/image1.png)
-
-1. To add a user, on the **Users** page, choose **+ Add user**.
-
-1. Choose a role for the user from the **Role** drop-down menu. Learn more about roles in the [Manage roles](#manage-roles) section of this article.
-
-    ![Role selection](media/howto-administer/image3.png)
-
-    > [!NOTE]
-    >  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**.
-
-### Edit the roles that are assigned to users
-
-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.
-
-### Delete users
-
-To delete users, select one or more check boxes on the **Users** page. Then select **Delete**.
-
-## Manage roles
-
-Roles enable you to control who within your organization can perform various tasks in IoT Central. There are three roles you can assign to users of your application.
-
-### Administrator
-
-Users in the **Administrator** role have access to all functionality in an application.
-
-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.
-
-### Application Builder
-
-Users in the **Application Builder** role can do everything in an application except administer the application. Builders can create, edit, and delete device templates and devices, manage device sets, and run analytics and jobs. Builders won't have access to the **Administration** section of the application.
-
-### Application Operator
-
-Users in the **Application Operator** role can't make changes to device templates and can't administer the application. Operators can add and delete devices, manage device sets, and run analytics and jobs. Operators won't have access to the **Application Builder** and **Administration** pages.
-
-## View your bill
-
-To view your bill, go to the **Billing** page in the **Administration** section. The Azure billing page opens in a new tab, where you can see the bill for each of your Azure IoT Central applications.
-
-### Convert your Trial to Pay-As-You-Go
-
-You can convert your Trial application to a Pay-As-You-Go application. Here are the differences between these types of applications.
-
-- **Trial** applications are free for seven days before they expire. They can be converted to Pay-As-You-Go at any time before they expire.
-- **Pay-As-You-Go** applications are charged per device, with the first five devices free.
-
-Learn more about pricing on the [Azure IoT Central pricing page](https://azure.microsoft.com/pricing/details/iot-central/).
-
-To complete this self-service process, follow these steps:
-
-1. Go to the **Billing** page in the **Administration** section.
-
-    ![Trial state](media/howto-administer/freetrialbilling.png)
-
-1. Select **Convert to Pay-As-You-Go**.
-
-    ![Convert trial](media/howto-administer/convert.png)
-
-1. Select the appropriate Azure Active Directory, and then the Azure subscription to use for your Pay-As-You-Go application.
-
-1. After you select **Convert**, your application is now a Pay-As-You-Go application and you start getting billed.
-
-## Export data
-
-You can enable **Continuous data export** to export measurements, devices, and device templates data to your Azure Blob storage account. Learn more about how to [export your data](howto-export-data.md).
-
-## Manage device connection
-
-Connect devices at scale in your application using the keys and certificates here. Learn more about [connecting devices](concepts-connectivity.md).
-
-## Use access tokens
-
-Generate access tokens to use them in developer tools. Currently the only developer tool available is the IoT Central explorer for monitoring device messages and changes in properties and settings. Learn more about the [IoT Central explorer](howto-use-iotc-explorer.md).
-
-## Customize your application
-
-For more information about changing the colors and icons in your application, see [Customize the Azure IoT Central UI](./howto-customize-ui.md).
-
-## Customize help
-
-For more information about adding custom help links in your application, see [Customize the Azure IoT Central UI](./howto-customize-ui.md).
 
 ## Manage programatically
 
@@ -178,8 +74,5 @@ To learn more, see the following GitHub repositories and packages:
 | Go | [https://github.com/Azure/azure-sdk-for-go](https://github.com/Azure/azure-sdk-for-go) | [https://github.com/Azure/azure-sdk-for-go](https://github.com/Azure/azure-sdk-for-go)
 
 ## Next steps
-
-Now that you've learned how to administer your Azure IoT Central application, here is the suggested next step:
-
-> [!div class="nextstepaction"]
-> [Set up the device template](howto-set-up-template.md)
+ 
+Now that you've learned about how to administer your Azure IoT Central application, the suggested next step is to learn about [Manage users and roles](howto-manage-users-roles.md) in Azure IoT Central.

articles/iot-central/howto-customize-ui.md

@@ -15,9 +15,10 @@ manager: philmea
 
 # Customize the Azure IoT Central UI 
 
-*This article applies to administrators.*
+This article describes how, as an administrator, you can 
+customize the UI of your application by applying custom themes and modifying the help links to point to your own custom help resources. 
 
-IoT Central lets you customize the UI of your application by applying custom themes and modifying the help links to point to your own custom help resources. The following screenshot shows a page using the standard theme:
+The following screenshot shows a page using the standard theme:
 
 ![Standard IoT Central theme](./media/howto-customize-ui/standard-ui.png)
 
@@ -37,7 +38,7 @@ On this page, you can customize the following aspects of your application:
 
 A PNG image, no larger than 1 MB, with a transparent background. This logo displays to the left on the IoT Central application title bar.
 
-If your logo image includes the name of your application, you can hide the application name text. For more information, see [Manage application settings](./howto-administer.md#manage-application-settings).
+If your logo image includes the name of your application, you can hide the application name text. For more information, see [Manage your Application](./howto-administer.md#change-application-name-and-url).
 
 ### Browser icon (favicon)
 

articles/iot-central/howto-manage-users-roles.md

@@ -0,0 +1,70 @@
+---
+title: Manage users and roles in Azure IoT Central application | Microsoft Docs
+description: As an administrator, how to manage users and roles in your Azure IoT Central application
+author: v-krghan
+ms.author: v-krghan
+ms.date: 07/29/2019
+ms.topic: conceptual
+ms.service: iot-central
+services: iot-central
+manager: philmea
+---
+
+# Manage users and roles in your IoT Central application
+
+This article describes how, as an administrator, you can add, edit, and delete users in your Azure IoT Central application and also how to manage roles in your Azure IoT Central application.
+
+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.
+
+
+## Add users
+
+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.
+
+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).
+
+1. To add a user to an IoT Central application, go to the **Users** page in the **Administration** section.
+
+    ![List of users](media/howto-administer/image1.png)
+
+1. To add a user, on the **Users** page, choose **+ Add user**.
+
+1. Choose a role for the user from the **Role** drop-down menu. Learn more about roles in the [Manage roles](#manage-roles) section of this article.
+
+    ![Role selection](media/howto-administer/image3.png)
+
+    > [!NOTE]
+    >  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**.
+
+### Edit the roles that are assigned to users
+
+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.
+
+> [!NOTE]
+> The roles assigned are specific to IoT Central application and cannot be managed from the Azure Portal.
+
+## Delete users
+
+To delete users, select one or more check boxes on the **Users** page. Then select **Delete**.
+
+## Manage roles
+
+Roles enable you to control who within your organization can perform various tasks in IoT Central. There are three roles you can assign to users of your application.
+
+### Administrator
+
+Users in the **Administrator** role have access to all functionality in an application.
+
+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.
+
+### Application Builder
+
+Users in the **Application Builder** role can do everything in an application except administer the application. Builders can create, edit, and delete device templates and devices, manage device sets, and run analytics and jobs. Builders won't have access to the **Administration** section of the application.
+
+### Application Operator
+
+Users in the **Application Operator** role can't make changes to device templates and can't administer the application. Operators can add and delete devices, manage device sets, and run analytics and jobs. Operators won't have access to the **Application Builder** and **Administration** pages.
+
+## Next steps
+
+Now that you've learned about how to manage users and roles in your Azure IoT Central, the suggested next step is to learn about [View your bill](howto-view-bill.md) in Azure IoT Central.

articles/iot-central/howto-view-bill.md

@@ -0,0 +1,48 @@
+---
+title: View your bill and convert trial to pay as you go in Azure IoT Central application | Microsoft Docs
+description: As an administrator, learn how to view your bill and covert from trial to pay as you go in your Azure IoT Central application
+author: v-krghan
+ms.author: v-krghan
+ms.date: 07/26/2019
+ms.topic: conceptual
+ms.service: iot-central
+services: iot-central
+manager: philmea
+---
+
+# View your bill in IoT Central application
+
+This article describes how, as an administrator, you can view your bill in Azure IoT Central application in the administration section and also how you can convert your trial version to pay-as-you-go.
+
+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.
+
+## View your bill
+
+To view your bill, go to the **Billing** page in the **Administration** section. The Azure billing page opens in a new tab, where you can see the bill for each of your Azure IoT Central applications.
+
+## Convert your Trial to Pay-As-You-Go
+
+- **Trial** applications are free for seven days before they expire. They can be converted to Pay-As-You-Go at any time before they expire.
+- **Pay-As-You-Go** applications are charged per device, with the first five devices free, per subscription.
+
+Learn more about pricing on the [Azure IoT Central pricing page](https://azure.microsoft.com/pricing/details/iot-central/).
+
+In the billing section, you can convert your trial applications into pay-as-you-go.
+
+To complete this self-service process, follow these steps:
+
+1. Go to the **Billing** page in the **Administration** section.
+
+    ![Trial state](media/howto-administer/freetrialbilling.png)
+
+1. Select **Convert to Pay-As-You-Go**.
+
+    ![Convert trial](media/howto-administer/convert.png)
+
+1. Select the appropriate Azure Active Directory, and then the Azure subscription to use for your Pay-As-You-Go application.
+
+1. After you select **Convert**, your application is now a Pay-As-You-Go application and you start getting billed.
+
+## Next steps
+
+Now that you've learned about how to view your bill in Azure IoT Central application, the suggested next step is to learn about [Customize application UI](howto-customize-ui.md) in Azure IoT Central.