POWERSHELL COMMAND
Get-XdrMtoTenantList
Retrieves the list of accessible tenants from Microsoft Defender XDR.
Gets the list of tenants that the current user has access to in the Microsoft Defender XDR portal, including tenant information such as name, tenant ID, environment, and access status. This function includes caching support with a 30-minute TTL to reduce API calls.
Syntax
Get-XdrMtoTenantList [-Force] [<CommonParameters>]
Parameters
-Force
| Property | Value |
|---|---|
| Type | SwitchParameter |
| Required | No |
| Position | named |
| Pipeline input | No |
| Default | False |
Bypasses the cache and forces a fresh retrieval from the API.
Examples
Get-XdrMtoTenantList
Retrieves the list of accessible tenants using cached data if available.
Get-XdrMtoTenantList -Force
Forces a fresh retrieval of the tenant list, bypassing the cache.
Get-XdrMtoTenantList | Where-Object { $_.selected }
Retrieves the currently selected tenant.
Get-XdrMtoTenantList | Where-Object { -not $_.lostAccess }
Retrieves only tenants where access has not been lost.
Output
Type: Object[]
Returns an array of tenant information objects with properties:
- selected: Whether this is the currently selected tenant
- lostAccess: Whether access to this tenant has been lost
- name: The display name of the tenant
- tenantId: The Azure AD tenant ID (GUID)
- tenantAadEnvironment: The AAD environment type (1 = Public Cloud)
- addedOn: The date when the tenant was added (if available) Also returns responseTypes object with B2B and GDAP status