Skip to main content
Connector guides

Connect Microsoft Teams Admin

Microsoft Teams Admin connects an AI assistant to the Teams policy and settings service that the Teams admin center and the Teams PowerShell module use, in your own directory or in a customer's. It is…

Written By Christopher Scaminaci

Last updated About 3 hours ago

Microsoft Teams Admin connects an AI assistant to the Teams policy and settings service that the Teams admin center and the Teams PowerShell module use, in your own directory or in a customer's. It is separate from Microsoft Graph, which works with teams, channels and chats.

With it your AI can:

  • Read meeting, calling, messaging, channel and app policies, external access and guest settings
  • Administer (Pro plans) - create, change and remove policies, and assign them to a user, a group or the tenant

Set it up

  1. Open Connectors, then Set up Microsoft.
  2. Tick Microsoft Teams Admin and any other Microsoft connector you want. One app serves all of them.
  3. Pick StackJack's app, or one app of your own. The wizard creates it for you, or fixes one you bring.
  4. Sign in on each connector, then consent your customers in one run.
  5. Read the checklist. Open the wizard again at any time and it checks again.

Steps and the reasons behind them are on Set up Microsoft. If you prefer a shell, the provisioning script does the app registration without the wizard.

Roles you need

  • Teams Administrator in each customer
  • Application Administrator or Cloud Application Administrator in each customer, so StackJack can consent your app there

These are Microsoft's documented minimums.

When something goes wrong

What you seeWhat to do
A customer is listed as "no Teams admin service (skipped)"Nothing is wrong. The customer has no Teams service.
A 403 when you preview Authorize all customersThat card's own app cannot read its own registration. Open the grant link in the message once, then preview again.
Voice and phone settings are missingDial plans, voice routing, numbers and call queues are not part of this connector.
Microsoft stops the consent with AADSTS650052The directory does not have a service the link asks for. The page that opens after the sign-in says Consent was not granted and shows this code, and Microsoft's message names the service by its application ID. Each link from StackJack asks only for its own connector's permissions, so the service is usually that connector's own, and the directory cannot use that connector (for example, a directory with no Defender). The Purview content search link is the one exception: it asks for every permission on the app, so the directory needs every service the app lists. If the ID is 4990cffe-04e8-4e8b-808a-1175604b879f, it is the Microsoft Partner permission (user_impersonation) on the app. With StackJack's app or your own app, make a fresh consent link in StackJack and send that link. Only the Purview content search link on your own app still needs the removal: remove Microsoft Partner from the API permissions of your app registration in Microsoft Entra, or download the current provisioning script again and run it with -AppId set to your app's application (client) ID. A re-run adds a new client secret, replaces the permission list with the tier you pass (Full if you pass none), and replaces the display name with -DisplayName, so pass the app's current name. Do not remove Microsoft Partner Center; it is a different permission. To consent your own customers without a link, use Authorize all customers on the card. If the message names another service, contact support.

See the generated Microsoft Teams Admin tool reference for the current inventory, plan assignment, input schemas and destructive-action labels.

Microsoft Teams Admin tools

teams_ · 179 tools · Free 48 · Pro 131

Meetings

ToolWhat it does
teams_get_application_meeting_configuration
Free · Read-only
Retrieves information about the application meeting configuration settings configured for the tenant.
teams_get_enhanced_encryption_policy
Free · Read-only
Returns information about the teams enhanced encryption policies configured for use in your organization.
teams_get_first_party_meeting_template_configuration
Free · Read-only
This cmdlet fetches the first-party meeting templates stored on the tenant.
teams_get_guest_meeting_configuration
Free · Read-only
Designates what meeting features guests using Microsoft Teams will have available.
teams_get_meeting_branding_policy
Free · Read-only
Enables administrators to control the appearance in meetings by defining custom backgrounds, logos, and colors.
teams_get_meeting_configuration
Free · Read-only
The CsTeamsMeetingConfiguration cmdlets enable administrators to control the meetings configurations in their tenants.
teams_get_meeting_policy
Free · Read-only
The CsTeamsMeetingPolicy cmdlets enable administrators to control the type of meetings that users can create or the features that they can access while in a meeting.
teams_get_meeting_template_configuration
Free · Read-only
This cmdlet fetches the custom meeting templates stored on the tenant.
teams_get_meeting_template_permission_policy
Free · Read-only
Fetches the TeamsMeetingTemplatePermissionPolicy.
teams_get_virtual_appointments_policy
Free · Read-only
This cmdlet is used to fetch policy instances of TeamsVirtualAppointmentsPolicy.
teams_grant_enhanced_encryption_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_meeting_branding_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_meeting_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_meeting_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_virtual_appointments_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_enhanced_encryption_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_meeting_branding_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_meeting_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_meeting_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_virtual_appointments_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_enhanced_encryption_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_meeting_branding_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_meeting_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_meeting_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_virtual_appointments_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_application_meeting_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_enhanced_encryption_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_guest_meeting_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_meeting_branding_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_meeting_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_meeting_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_meeting_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_virtual_appointments_policy
Pro · Destructive
DESTRUCTIVE.

Recording and Transcription

ToolWhat it does
teams_get_compliance_recording_application
Free · Read-only
Returns information about the application instances of policy-based recording applications that have been configured for administering automatic policy-based recording in your tenant.
teams_get_compliance_recording_policy
Free · Read-only
Returns information about the policies configured for governing automatic policy-based recording in your tenant.
teams_get_custom_banner_text
Free · Read-only
Enables administrators to configure a custom text on the banner displayed when compliance recording bots start recording the call.
teams_get_media_logging_policy
Free · Read-only
Returns information about the Teams Media Logging policy.
teams_get_recording_and_transcription_custom_message
Free · Read-only
> [!NOTE] > This feature has not been fully released yet, so the setting will have no effect.
teams_grant_compliance_recording_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_media_logging_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_compliance_recording_application
Pro · Destructive
DESTRUCTIVE.
teams_new_compliance_recording_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_custom_banner_text
Pro · Destructive
DESTRUCTIVE.
teams_new_recording_and_transcription_custom_message
Pro · Destructive
DESTRUCTIVE.
teams_remove_compliance_recording_application
Pro · Destructive
DESTRUCTIVE.
teams_remove_compliance_recording_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_custom_banner_text
Pro · Destructive
DESTRUCTIVE.
teams_remove_recording_and_transcription_custom_message
Pro · Destructive
DESTRUCTIVE.
teams_set_compliance_recording_application
Pro · Destructive
DESTRUCTIVE.
teams_set_compliance_recording_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_custom_banner_text
Pro · Destructive
DESTRUCTIVE.
teams_set_recording_and_transcription_custom_message
Pro · Destructive
DESTRUCTIVE.

Events

ToolWhat it does
teams_get_events_policy
Free · Read-only
Returns information about the Teams Events policy.
teams_get_meeting_broadcast_configuration
Free · Read-only
Gets Tenant level configuration for broadcast events in Teams.
teams_get_meeting_broadcast_policy
Free · Read-only
User-level policy for tenant admin to configure meeting broadcast behavior for the broadcast event organizer.
teams_grant_events_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_meeting_broadcast_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_events_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_meeting_broadcast_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_events_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_meeting_broadcast_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_events_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_meeting_broadcast_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_meeting_broadcast_policy
Pro · Destructive
DESTRUCTIVE.

Calling

ToolWhat it does
teams_get_calling_policy
Free · Read-only
Returns information about the teams calling policies configured for use in your organization.
teams_get_guest_calling_configuration
Free · Read-only
Returns information about the GuestCallingConfiguration, which specifies what options guest users have for calling within Teams.
teams_grant_calling_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_calling_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_calling_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_calling_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_guest_calling_configuration
Pro · Destructive
DESTRUCTIVE.

Messaging

ToolWhat it does
teams_get_channels_policy
Free · Read-only
The CsTeamsChannelsPolicy allows you to manage features related to the Teams & Channels experience within the Teams application.
teams_get_feedback_policy
Free · Read-only
Use this cmdlet to retrieve the current Teams Feedback policies (the ability to send feedback about Teams to Microsoft and whether they receive the survey) in the organization.
teams_get_files_policy
Free · Read-only
Get a list of all pre-configured policy instances related to teams files.
teams_get_guest_messaging_configuration
Free · Read-only
TeamsGuestMessagingConfiguration determines the messaging settings for the guest users.
teams_get_messaging_configuration
Free · Read-only
TeamsMessagingConfiguration determines the messaging settings for users.
teams_get_messaging_policy
Free · Read-only
The CsTeamsMessagingPolicy cmdlets enable administrators to control if a user is enabled to exchange messages.
teams_get_notification_and_feeds_policy
Free · Read-only
Retrieves information about the Teams Notification and Feeds policy configured for use in the tenant.
teams_grant_channels_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_feedback_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_files_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_messaging_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_channels_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_feedback_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_files_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_messaging_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_channels_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_feedback_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_files_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_messaging_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_notification_and_feeds_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_channels_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_feedback_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_files_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_guest_messaging_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_messaging_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_messaging_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_notification_and_feeds_policy
Pro · Destructive
DESTRUCTIVE.

Apps

ToolWhat it does
teams_get_app_permission_policy
Free · Read-only
As an admin, you can use app permission policies to allow or block apps for your users.
teams_get_app_setup_policy
Free · Read-only
As an admin, you can use app setup policies to customize Microsoft Teams to highlight the apps that are most important for your users.
teams_get_application_access_policy
Free · Read-only
Retrieves information about the application access policy configured for use in the tenant.
teams_get_shifts_app_policy
Free · Read-only
Returns information about the Teams Shifts App policies that have been configured for use in your organization.
teams_get_shifts_policy
Free · Read-only
This cmdlet allows you to get properties of a TeamsShiftPolicy instance, including user's Teams off shift warning message-specific settings.
teams_get_template_permission_policy
Free · Read-only
Fetches the TeamsTemplatePermissionPolicy.
teams_get_workload_policy
Free · Read-only
This cmdlet applies an instance of the Teams Workload policy to users or groups in a tenant.
teams_grant_app_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_app_setup_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_application_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_shifts_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_workload_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_app_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_app_setup_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_application_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_shifts_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_workload_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_app_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_app_setup_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_application_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_shifts_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_workload_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_app_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_app_setup_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_application_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_shifts_app_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_shifts_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_template_permission_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_workload_policy
Pro · Destructive
DESTRUCTIVE.

Copilot and AI

ToolWhat it does
teams_get_ai_policy
Free · Read-only
This cmdlet retrieves all Teams AI policies for the tenant.
teams_get_cortana_policy
Free · Read-only
The CsTeamsCortanaPolicy cmdlets enable administrators to control settings for Cortana voice assistant in Microsoft Teams.
teams_grant_ai_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_cortana_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_ai_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_cortana_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_ai_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_cortana_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_ai_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_cortana_policy
Pro · Destructive
DESTRUCTIVE.

Org-wide and Client

ToolWhat it does
teams_get_client_configuration
Free · Read-only
This cmdlet allows IT admins to retrieve the effective configuration for their organization.
teams_get_external_access_configuration
Free · Read-only
This cmdlet returns the current settings of your organization.
teams_get_external_access_policy
Free · Read-only
Returns information about the external access policies that have been configured for use in your organization.
teams_get_mobility_policy
Free · Read-only
The TeamsMobilityPolicy allows Admins to control Teams mobile usage for users.
teams_get_multi_tenant_organization_configuration
Free · Read-only
This cmdlet retrieves all tenant settings for Multi-tenant Organizations Runs Get-CsTeamsMultiTenantOrganizationConfiguration.
teams_get_targeting_policy
Free · Read-only
Enables you to return information about all the Tenant tag setting policies that have been configured for use in your organization.
teams_get_update_management_policy
Free · Read-only
Use this cmdlet to retrieve the current Teams Update Management policies in the organization.
teams_get_upgrade_configuration
Free · Read-only
Returns information related to managing the upgrade to Teams from Skype for Business.
teams_get_upgrade_policy
Free · Read-only
This cmdlet returns the set of instances of this policy.
teams_get_vdi_policy
Free · Read-only
Enables you to return infomration about all the Vdi policies that have been configured for use in your organization.
teams_get_work_location_detection_policy
Free · Read-only
This cmdlet is used to fetch policy instances of TeamsWorkLocationDetectionPolicy.
teams_grant_external_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_mobility_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_update_management_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_upgrade_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_vdi_policy
Pro · Destructive
DESTRUCTIVE.
teams_grant_work_location_detection_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_external_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_mobility_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_update_management_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_vdi_policy
Pro · Destructive
DESTRUCTIVE.
teams_new_work_location_detection_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_external_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_mobility_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_targeting_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_update_management_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_vdi_policy
Pro · Destructive
DESTRUCTIVE.
teams_remove_work_location_detection_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_client_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_external_access_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_external_access_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_mobility_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_multi_tenant_organization_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_targeting_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_update_management_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_upgrade_configuration
Pro · Destructive
DESTRUCTIVE.
teams_set_vdi_policy
Pro · Destructive
DESTRUCTIVE.
teams_set_work_location_detection_policy
Pro · Destructive
DESTRUCTIVE.

Raw Requests

ToolWhat it does
teams_raw_get
Free · Read-only
Reads any path on the Teams admin host that the typed teams_ tools do not cover, for example a policy type they omit or a user's policy assignments.
teams_raw_request
Pro · Destructive
DESTRUCTIVE.