How to update your Entra ID organization using Microsoft Graph PowerShell
 
 
 

How to update your Entra ID organization using Microsoft Graph PowerShell

The Update-MgOrganization cmdlet updates properties of an organization object in Microsoft Entra ID. The organization object represents the tenant itself and contains key settings such as branding details, privacy statements, default domains, and contact information. With this cmdlet, admins can modify attributes like the display name, marketing notifications, or supported services to keep tenant metadata accurate and aligned with corporate identity.

This article shows how you can update your Entra ID organization settings using both the Microsoft Entra admin center and Microsoft Graph PowerShell:

  • M365 admin center
  • PowerShell
 

Update organization settings using Microsoft Entra admin center

The Entra admin center provides a graphical interface to update organization settings:

  1. Go to Microsoft Entra admin center.
  2. Click Entra ID > Overview for basic info or Branding for visual elements.
  3. Edit and save the required settings.

Update organization settings using Microsoft Graph PowerShell

Prerequisites

  • Ensure you have permissions like Directory.ReadWrite.All assigned.
  • Install and connect to Microsoft Graph PowerShell by running the script below:
    Install-Module Microsoft.Graph -Scope CurrentUser Connect-MgGraph -Scopes "Directory.ReadWrite.All"

Using the Update-MgOrganization cmdlet

Use the cmdlet with your organization’s ID and specify the attributes you want to modify:

Update-MgOrganization -OrganizationId <tenant-id> -DisplayName "<new-name>"

Examples

Example 1: Update company branding display name

Update-MgOrganization -OrganizationId "12345678-90ab-cdef-1234-567890abcdef" -DisplayName "Contoso Corporation"

Example 2: Change technical notification email address

Update-MgOrganization -OrganizationId "12345678-90ab-cdef-1234-567890abcdef" -TechnicalNotificationMails @("it@contoso.com", "support@contoso.com")

Example 3: Update privacy profile statement URL

Update-MgOrganization -OrganizationId "12345678-90ab-cdef-1234-567890abcdef" -PrivacyProfile @{StatementUrl="https://contoso.com/privacy"}

Supported parameters

The following essential parameters can be used along with the Update-MgOrganization cmdlet:

Parameter Description
-OrganizationId Directory (tenant) ID (required).
-DisplayName Organization’s new display name.
-PrivacyProfile Hashtable for privacy metadata.
-TechnicalNotificationMails Array of notification email addresses.
-Branding Organization branding configuration.
-MarketingNotificationEmails Marketing emails array.
-WhatIf Simulates the command.
-Confirm Prompts before applying changes.
-Headers Custom HTTP headers.

Limitations of using native tools to update organization settings

  • PowerShell commands can get complex with different use cases and scenarios.
  • IT admins can spend a lot of time troubleshooting errors, which negatively impacts productivity.
  • Delegation can get tricky since technicians require elevated permissions.

How ADManager Plus helps you manage Microsoft Entra ID

ADManager Plus, an identity governance and administration solution with comprehensive Microsoft Entra ID management and reporting capabilities, simplifies complex admin tasks from a single, user-friendly console:

Perform script-free Microsoft Entra ID management and reporting with ADManager Plus

The one-stop solution to Active Directory Management and Reporting
Email Download Link Email the ADManager Plus download link