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:
The Entra admin center provides a graphical interface to update organization settings:
Install-Module Microsoft.Graph -Scope CurrentUser
Connect-MgGraph -Scopes "Directory.ReadWrite.All"
Use the cmdlet with your organization’s ID and specify the attributes you want to modify:
Update-MgOrganization -OrganizationId <tenant-id> -DisplayName "<new-name>"
Update-MgOrganization -OrganizationId "12345678-90ab-cdef-1234-567890abcdef" -DisplayName "Contoso Corporation"
Update-MgOrganization -OrganizationId "12345678-90ab-cdef-1234-567890abcdef" -TechnicalNotificationMails @("it@contoso.com", "support@contoso.com")
Update-MgOrganization -OrganizationId "12345678-90ab-cdef-1234-567890abcdef" -PrivacyProfile @{StatementUrl="https://contoso.com/privacy"}
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. |
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: