Edit

Share via

Get-M365TeamsApp

  • Reference
Module:
MicrosoftTeamsPowerShell
Applies to:
Microsoft Teams

This cmdlet returns app availability and state for the Microsoft Teams app.

Syntax

Get-M365TeamsApp
   -Id <String>
   [<CommonParameters>]

Description

Get-M365TeamsApps retrieves information about the Teams app. This includes app state, app availability, user who updated app availability, and the associated timestamp.

Examples

Example 1

PS C:\> Get-M365TeamsApp -Id b782e2e8-9682-4898-b211-a304714f4f6b

Provides information about b782e2e8-9682-4898-b211-a304714f4f6b app, which includes app state, app availability, user who updated app availability, and the associated timestamp.

Parameters

-Id

Application ID of the Teams app.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

System.Object

ID
Application ID of the Teams app.

IsBlocked
The state of the app in the tenant.
Values:

  • Blocked
  • Unblocked

AvailableTo
Provides available to properties for the app.
Properties:

  • AssignmentType: App availability type.
    Values:
    • Everyone
    • UsersandGroups
    • Noone
  • Users: List of all the users for whom the app is enabled.
    Values:
    • Id: GUID of UserIDs.
    • AssignedBy: UserID of last user who updated the app AvailableTo value.
    • LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.
  • Groups: List of all the groups for whom the app is enabled.
    Values:
    • Id: GUID of GroupIDs.
    • AssignedBy: UserID of last user who updated the app AvailableTo value.
    • LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.

InstalledFor
Provides installed for properties for the app.
Properties:

  • AppInstallType: App install type.
    Values:
    • Everyone
    • UsersandGroups
    • Noone
  • LastUpdatedTimestamp: Last Updated date
  • InstalledBy: The user performing the installation
  • InstalledSource: Source of installation
  • Version: Version of the app installed
  • InstallForUsers: List of all the users for whom the app is enabled.
    Values:
    • Id: GUID of UserIDs.
    • AssignedBy: UserID of last user who updated the app AvailableTo value.
    • LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.
  • InstallForGroups: List of all the groups for whom the app is enabled.
    Values:
    • Id: GUID of GroupIDs.
    • AssignedBy: UserID of last user who updated the app AvailableTo value.
    • LastUpdatedTimeStamp: Time and date when the app AvailableTo value was last updated.