Commands › Microsoft Teams

Find-CsOnlineApplicationInstance

Microsoft Teams MicrosoftTeams Find-*

Find application instances that match your search criteria.

Quick start script

# Find-CsOnlineApplicationInstance — quick start (serv365.ai)
# 1. Connect (app-only shown; interactive: omit the certificate parameters)
Connect-MicrosoftTeams -CertificateThumbprint $thumb -ApplicationId $appId -TenantId $tenantId

# 2. Run and inspect
Find-CsOnlineApplicationInstance -SearchQuery <String> | Format-List

# 3. Export for evidence / drift tracking
Find-CsOnlineApplicationInstance | Export-Clixml .\CsOnlineApplicationInstance-$(Get-Date -Format yyyyMMdd).xml

Syntax

Find-CsOnlineApplicationInstance [-SearchQuery] <string> [[-MaxResults] <uint>] [-ExactMatchOnly] [-AssociatedOnly] [-UnAssociatedOnly] [-Force] [<CommonParameters>]

Parameters (6)

ParameterTypeRequiredWhat it controls
-AssociatedOnly SwitchParameter The AssociatedOnly parameter instructs the cmdlet to return only application instances that are associated to a configuration.
-ExactMatchOnly SwitchParameter The ExactMatchOnly parameter instructs the cmdlet to return exact matches only. The default value is false.
-Force SwitchParameter This switch specifies whether to suppress warning and confirmation messages. It can be useful in scripting to suppress interactive prompts. If it isn't provided in the command, you're prompted for administrative...
-MaxResults UInt32 The MaxResults parameter identifies the maximum number of results to return. If this parameter is not provided, the default value is 10. Max allowed value is 20.
-SearchQuery String yes The SearchQuery parameter defines a query for application instances by display name, telephone number, or GUID of the application instance. This parameter accepts partial queries for display names and telephone...
-UnAssociatedOnly SwitchParameter The UnAssociatedOnly parameter instructs the cmdlet to return only application instances that are not associated to any configuration.

Reference facts derived from Microsoft documentation, © Microsoft, licensed CC BY 4.0; restructured with original guidance by serv365.ai.