configure-app-properties-with Microsoft Graph

Author: omondiatieno

articles/active-directory/manage-apps/add-application-portal-configure.md

@@ -11,6 +11,8 @@ ms.workload: identity
 ms.date: 09/22/2021
 ms.author: jomondi
 ms.reviewer: ergreenl
+zone_pivot_groups: enterprise-apps-minus-aad-powershell
+
 #Customer intent: As an administrator of an Azure AD tenant, I want to configure the properties of an enterprise application.
 ---
 
@@ -31,14 +33,96 @@ Application properties control how the application is represented and how the ap
 
 To configure the application properties:
 
+:::zone pivot="portal"
+
 1. Go to the [Azure Active Directory Admin Center](https://aad.portal.azure.com) and sign in using one of the roles listed in the prerequisites.
 1. In the left menu, select **Enterprise applications**. The **All applications** pane opens and displays a list of the applications in your Azure AD tenant. Search for and select the application that you want to use.
 1. In the **Manage** section, select **Properties** to open the **Properties** pane for editing.
-1. Configure the properties based on the needs of your application. 
+1. On the **Properties** pane, you may want to configure the following properties for your application:
+   - Logo
+   - User sign in options
+   - App visibility
+   - Reply URL
+   
+:::zone-end
+
+:::zone pivot="ms-powershell"
+
+Use the following Microsoft Graph PowerShell script to configure basic application properties.
+
+You'll need to consent to the `Application.ReadWrite.All` permission.
+
+```powershell
+
+Import-Module Microsoft.Graph.Applications
+
+$params = @{
+	Tags = @(
+		"HR"
+		"Payroll"
+		"HideApp"
+	)
+	Info = @{
+		LogoUrl = "https://cdn.pixabay.com/photo/2016/03/21/23/25/link-1271843_1280.png"
+		MarketingUrl = "https://www.contoso.com/app/marketing"
+		PrivacyStatementUrl = "https://www.contoso.com/app/privacy"
+		SupportUrl = "https://www.contoso.com/app/support"
+		TermsOfServiceUrl = "https://www.contoso.com/app/termsofservice"
+	}
+	Web = @{
+		HomePageUrl = "https://www.contoso.com/"
+		LogoutUrl = "https://www.contoso.com/frontchannel_logout"
+		RedirectUris = @(
+			"https://localhost"
+		)
+	}
+	ServiceManagementReference = "Owners aliases: Finance @ [email protected]; The Phone Company HR consulting @ [email protected];"
+}
+
+Update-MgApplication -ApplicationId $applicationId -BodyParameter $params
+```
+:::zone-end
+
+:::zone pivot="ms-graph"
+
+To configure the basic properties of an application, sign in to [Graph Explorer](https://developer.microsoft.com/graph/graph-explorer) with one of the roles listed in the prerequisite section.
+
+You'll need to consent to the `Application.ReadWrite.All` permission.
+
+Run the following Microsoft Graph query to configure basic application properties.
+
+```http
+PATCH https://graph.microsoft.com/v1.0/applications/0d0021e2-eaab-4b9f-a5ad-38c55337d63e/
+Content-type: application/json
+
+{
+    "tags": [
+        "HR",
+        "Payroll",
+        "HideApp"
+    ],
+    "info": {
+        "logoUrl": "https://cdn.pixabay.com/photo/2016/03/21/23/25/link-1271843_1280.png",
+        "marketingUrl": "https://www.contoso.com/app/marketing",
+        "privacyStatementUrl": "https://www.contoso.com/app/privacy",
+        "supportUrl": "https://www.contoso.com/app/support",
+        "termsOfServiceUrl": "https://www.contoso.com/app/termsofservice"
+    },
+    "web": {
+        "homePageUrl": "https://www.contoso.com/",
+        "logoutUrl": "https://www.contoso.com/frontchannel_logout",
+        "redirectUris": [
+            "https://localhost"
+        ]
+    },
+    "serviceManagementReference": "Owners aliases: Finance @ [email protected]; The Phone Company HR consulting @ [email protected];"
+}
+```
+:::zone-end
 
 ## Use Microsoft Graph to configure application properties
 
-You can also configure properties of both app registrations and enterprise applications (service principals) through Microsoft Graph. These can include basic properties, permissions, and role assignments. For more information, see [Create and manage an Azure AD application using Microsoft Graph](/graph/tutorial-applications-basics#configure-other-basic-properties-for-your-app).
+You can also configure other advanced properties of both app registrations and enterprise applications (service principals) through Microsoft Graph. These includes properties such as permissions, and role assignments. For more information, see [Create and manage an Azure AD application using Microsoft Graph](/graph/tutorial-applications-basics#configure-other-basic-properties-for-your-app).
 
 ## Next steps