Skip to content

Get-M365TeamsApp.md

Latest commit

 

History

History
132 lines (99 loc) · 3.53 KB

Get-M365TeamsApp.md

File metadata and controls

132 lines (99 loc) · 3.53 KB
applicable Microsoft Teams
author lkueter
external help file Microsoft.Teams.PowerShell.TeamsCmdlets.dll-Help.xml
Locale en-US
manager rahulrgupta
Module Name MicrosoftTeams
ms.author sribagchi
online version https://docs.microsoft.com/powershell/module/microsoftteams/Get-M365TeamsApp
schema 2.0.0
title Get-M365TeamsApp

Get-M365TeamsApp

SYNOPSIS

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
Parameter Sets: (All)
Aliases:

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

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None

OUTPUTS

System.Object

ID Application ID of the Teams app.

AppName Application Name 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.

NOTES

RELATED LINKS

Get-AllM365TeamsApps Update-M365TeamsApp