Additional directories
If your organisation has more than one Microsoft Entra tenant, you can add the others to your TeamsPIM subscription. Licensed users can then use Switch Directory in TeamsPIM to work in those directories, and you can manage Azure subscriptions in them on the Azure Resources page.
Limits and requirements
Section titled “Limits and requirements”- Up to 10 tenant IDs per subscription, including the subscription’s own tenant.
- Each tenant must grant TeamsPIM admin consent before it can be added. A Global Administrator of that tenant has to grant it.
- The subscription’s own tenant is listed as Subscription tenant and cannot be removed (“This subscription was set up for this tenant, so it cannot be removed.”).
Add a tenant
Section titled “Add a tenant”You need to be the purchaser or an administrator of the subscription.
- In the Customer Admin Portal, open Subscription Settings and choose the subscription in “Select a subscription”.
- In the Additional Tenant IDs card, select Add tenant. The “Add a tenant” dialog opens.
- Enter the tenant’s ID in “Tenant ID”.
- Get admin consent for that tenant. The dialog reads “A Global Administrator of this tenant must
grant TeamsPIM admin consent before it can be added. Open the consent page yourself, or send the
link to someone who can.”
- Select Open consent if you can grant consent in that tenant yourself.
- Select Copy link to send the consent link to a Global Administrator of that tenant.
- When consent has been granted, select Verify. The dialog shows “Admin consent verified.” If it shows “Admin consent has not been granted yet. Complete it, then press Verify.”, consent is not finished yet.
- Select Add.
To remove a tenant, use the remove button next to it in the list.
How users switch directory
Section titled “How users switch directory”Users switch from the TeamsPIM Dashboard tab: they select their name at the top and choose Switch Directory. See Switch directory.
Switching is available only when all three of these are true:
- The TeamsPIM subscription is active.
- The user has a TeamsPIM licence assigned.
- An administrator has added additional directories to that subscription, as above.
Otherwise the user sees “Switching directory is not set up”.
Optional: trust MFA from your users’ home directory
Section titled “Optional: trust MFA from your users’ home directory”A user who switches to an additional directory works there as a guest. If that directory requires multi-factor authentication (MFA) and doesn’t accept the MFA the user already completed in their home directory, TeamsPIM has to ask them to verify their identity again in that directory before it can load its data. Microsoft requires MFA for Azure management in every tenant, so this mostly affects Azure resource roles.
You can avoid the extra prompt by letting the additional directory trust MFA from your users’ home directory. Users then complete MFA once, when they sign in at home, and it counts in the additional directory too. Microsoft accepts this for its mandatory Azure MFA as well. See Mandatory multifactor authentication for Azure.
In each additional directory your users switch to, a Security Administrator of that directory does the following in the Microsoft Entra admin center:
- Go to Entra ID > External Identities > Cross-tenant access settings.
- On the Organizational settings tab, select Add organization, enter the tenant ID of your users’ home directory and select Add. Skip this step if it’s already listed.
- In that organisation’s row, select the link in the Inbound access column.
- Open the Trust settings tab and choose Customize settings.
- Select “Trust multifactor authentication from Microsoft Entra tenants” and select Save.
If your licensed users come from more than one home directory, add each of them.
The trust only helps when users complete MFA in their home directory. If they haven’t, Microsoft Entra asks them for MFA in their home directory instead.
Microsoft documents this setting in Manage cross-tenant access settings for B2B collaboration.