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/active-directory/app-provisioning/export-import-provisioning-configuration.md
+9-8Lines changed: 9 additions & 8 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
-
title: 'Export or import your provisioning configuration by using the Microsoft Graph API | Microsoft Docs'
3
-
description: Learn how to export and import provisioning configuration using the Microsoft Graph API.
2
+
title: 'Export your provisioning configuration and roll back to a known good state for disaster recovery.| Microsoft Docs'
3
+
description: Learn how to export your provisioning configuration and roll back to a known good state for disaster recovery.
4
4
services: active-directory
5
5
author: cmmdesai
6
6
documentationcenter: na
@@ -13,12 +13,13 @@ ms.devlang: na
13
13
ms.topic: article
14
14
ms.tgt_pltfrm: na
15
15
ms.workload: identity
16
-
ms.date: 09/09/2019
16
+
ms.date: 03/19/2020
17
17
ms.author: chmutali
18
18
19
19
ms.collection: M365-identity-device-management
20
20
---
21
21
# Export your provisioning configuration and roll back to a known good state
22
+
22
23
## Export and import your provisioning configuration from the Azure portal
23
24
24
25
### How can I export my provisioning configuration?
@@ -37,14 +38,14 @@ Exporting and saving your configuration allows you to roll back to a previous ve
37
38
## Export and import your provisioning configuration by using the Microsoft Graph API
38
39
You can use the Microsoft Graph API and the Microsoft Graph Explorer to export your User Provisioning attribute mappings and schema to a JSON file and import it back into Azure AD. You can also use the steps captured here to create a backup of your provisioning configuration.
39
40
40
-
## Step 1: Retrieve your Provisioning App Service Principal ID (Object ID)
41
+
###Step 1: Retrieve your Provisioning App Service Principal ID (Object ID)
41
42
42
-
1. Launch the [Azure portal](https://portal.azure.com), and navigate to the Properties section of your provisioning application. For e.g., if you want to export your *Workday to AD User Provisioning application* mapping navigate to the Properties section of that app.
43
+
1. Launch the [Azure portal](https://portal.azure.com), and navigate to the Properties section of your provisioning application. For example, if you want to export your *Workday to AD User Provisioning application* mapping navigate to the Properties section of that app.
43
44
1. In the Properties section of your provisioning app, copy the GUID value associated with the *Object ID* field. This value is also called the **ServicePrincipalId** of your App and it will be used in Microsoft Graph Explorer operations.
44
45
45
46

1. Click on the "Sign-In with Microsoft" button and sign-in using Azure AD Global Admin or App Admin credentials.
@@ -53,7 +54,7 @@ You can use the Microsoft Graph API and the Microsoft Graph Explorer to export y
53
54
54
55
1. Upon successful sign-in, you will see the user account details in the left-hand pane.
55
56
56
-
## Step 3: Retrieve the Provisioning Job ID of the Provisioning App
57
+
###Step 3: Retrieve the Provisioning Job ID of the Provisioning App
57
58
58
59
In the Microsoft Graph Explorer, run the following GET query replacing [servicePrincipalId] with the **ServicePrincipalId** extracted from the [Step 1](#step-1-retrieve-your-provisioning-app-service-principal-id-object-id).
59
60
@@ -75,7 +76,7 @@ In the Microsoft Graph Explorer, run the following GET query, replacing [service
75
76
76
77
Copy the JSON object from the response and save it to a file to create a backup of the schema.
77
78
78
-
## Step 5: Import the Provisioning Schema
79
+
###Step 5: Import the Provisioning Schema
79
80
80
81
> [!CAUTION]
81
82
> Perform this step only if you need to modify the schema for configuration that cannot be changed using the Azure portal or if you need to restore the configuration from a previously backed up file with valid and working schema.
0 commit comments