M365 PowerShell

Get-MgOrganization: How to Retrieve Microsoft 365 Organization Details

This guide explains how to use the Get-MgOrganization cmdlet in Microsoft Graph PowerShell to retrieve details about your Microsoft 365 tenant. Learn how to fetch organization properties like tenant ID, display name, and verified domains with practical examples.

The Get-MgOrganization cmdlet is a powerful tool in Microsoft Graph PowerShell that allows administrators to retrieve details about their organization (tenant). This guide will cover the cmdlet syntax, provide usage examples, offer tips, address possible errors and solutions, and discuss various use cases.

Cmdlet Syntax

The basic syntax of the Get-MgOrganization cmdlet is as follows:

Get-MgOrganization

This cmdlet does not require any parameters and will return details about the organization associated with the signed-in user.

Usage Examples

Retrieve Organization Details

To get the full details of your organization, simply run:

Get-MgOrganization

This command will return comprehensive information about the organization, including its ID, display name, and more.

Retrieve Specific Properties

To get specific properties such as the display name and verified domains, run:

Get-MgOrganization | Select-Object DisplayName, VerifiedDomains

Retrieve Marketing Notification Email Addresses

To get the marketing notification email addresses set for your organization, run:

Get-MgOrganization | Select-Object MarketingNotificationEmails

Cmdlet Tips

Filtering Output: Use Select-Object to filter and display only the properties you need. This makes the output more manageable and easier to read.
Piping Output: You can pipe the output to other cmdlets for further processing, such as exporting to a CSV file.
Automating Reports: Integrate the cmdlet into scripts for automated reporting and auditing tasks.
Use -Property to reduce payload: When retrieving organization details, consider using the -Property parameter to limit the returned data. This helps improve performance and script readability.
```
Get-MgOrganization -Property DisplayName,VerifiedDomains
```
Use -ExpandProperty to retrieve nested information: For properties like branding, certificateBasedAuthConfiguration, or extensions, you can use -ExpandProperty to pull full details in one call.
```
Get-MgOrganization -ExpandProperty Branding
```
Only one organization object exists per tenant: The Get-MgOrganization cmdlet returns a single tenant-wide object, so using -All or pagination options isn't necessary.
Helpful for tenant-wide validations: You can use this cmdlet to quickly check verified domains, default domain, tenant branding, or preferred language settings — useful for compliance and audit tasks.

Possible Errors & Solutions

Error	Solution
Permission Denied: You receive a "Permission Denied" error when running the cmdlet.	Ensure that you have the necessary permissions to access organizational details. You may need to be a global administrator or have other appropriate roles assigned.
Module Not Found: You get an error stating that the Get-MgOrganization cmdlet is not recognized.	Make sure you have installed and imported the Microsoft Graph PowerShell module. Run the following commands to install and import the module: `Install-Module Microsoft.Graph -Scope CurrentUser Import-Module Microsoft.Graph`
Invalid Authentication: Authentication fails when attempting to run the cmdlet.	Ensure you are authenticated to Microsoft Graph. Use the Connect-MgGraph cmdlet to authenticate: `Connect-MgGraph`

Use Cases

Retrieve Organization Information: Useful for administrators who need an overview of the organization's settings and verified domains.
Audit and Compliance: Ensure that organization properties such as verified domains and marketing notification emails are correctly configured.
Automation Scripts: Integrate with scripts that need to verify or log organizational settings as part of larger automation workflows.

Frequently Asked Questions

1. What is Get-MgOrganization used for?

Get-MgOrganization is a Microsoft Graph PowerShell cmdlet used to retrieve information about your Microsoft 365 tenant, such as its name, tenant ID, and verified domains.

2. How can I retrieve basic details about my tenant?

Use the following command to retrieve tenant details:

Get-MgOrganization

3. How can I list the verified domains in my tenant?

Use the following script to extract verified domains:

(Get-MgOrganization).VerifiedDomains

4. Can I filter specific properties of the tenant?

Yes, you can select specific properties using Select-Object. Example:

Get-MgOrganization | Select-Object DisplayName, TenantId, Country

6. Can I retrieve multiple tenants using Get-MgOrganization?

No. Get-MgOrganization only returns the organization object for the currently connected tenant. If you manage multiple tenants, you’ll need to connect to each tenant separately using Connect-MgGraph.

7. Why is Get-MgOrganization returning limited fields even with -ExpandProperty?

Some fields require additional Graph permissions (like Directory.Read.All or Organization.Read.All). Ensure your app or session has sufficient privileges. Also, make sure the field you are expanding actually exists and is populated in your tenant.

ℹ️ Only One Organization Object Exists per Tenant

Microsoft 365 tenants support only a single organization object. When you run Get-MgOrganization, it will always return exactly one result, even if you don't specify an -OrganizationId.

This object contains tenant-wide settings such as DisplayName, DefaultUsageLocation, and MarketingNotificationEmails.

🔐 Use Organization ID for Direct Access in Automation

While Get-MgOrganization works without specifying an ID, you can also pass the known OrganizationId explicitly using the -OrganizationId parameter.

This is especially helpful in scripts where precision and consistency matter — such as multi-tenant automation or conditional logic based on tenant ID.

Get-MgOrganization -OrganizationId "your-org-id-here"

You can retrieve the Organization ID by running:

(Get-MgOrganization).Id

Conclusion

The Get-MgOrganization cmdlet is an essential tool for Microsoft 365 administrators, providing critical information about the organization's configuration and settings. By understanding how to use this cmdlet effectively, administrators can streamline their management tasks, ensure compliance, and automate reporting processes.

For more tips and comprehensive guides on using Microsoft Graph PowerShell, stay tuned to M365Corner.com!

Using Get-MgDirectoryRole in Graph PowerShell
Using Get-MgUserLicenseDetail in Graph PowerShell
Using Find-GraphMgCommand in Graph PowerShell
Connect to Microsoft 365 Using PowerShell
How to Create Bulk Users in Office 365 Using Graph PowerShell?
Create Microsoft 365 Group Using Microsoft Graph PowerShell
Block Microsoft 365 User Using Microsoft Graph PowerShell
Assign Microsoft 365 License Using Graph PowerShell
Microsoft 365 User Management Using Graph PowerShell
Checking Group Membership in Microsoft 365
Bulk Assign Microsoft 365 License
Find Inactive Users in Microsoft 365
Using Powershell Graph Search Query
Using Powershell Graph Filter Query
Using Where-Object In Graph PowerShell
Using Expand Property In Graph PowerShell
Using Select Object In Graph PowerShell
Using -Contains Operator In Graph PowerShell
Add User to Multiple Microsoft 365 Groups Using Graph PowerShell
Get Microsoft 365 User Location Using Graph PowerShell
Import Microsoft 365 Groups from CSV File Using Graph PowerShell
Microsoft 365 Group User Import Using Graph PowerShell