Skip to main content

teams status

Show current CLI status

Usage​

teams status [options]

Options​

FlagDescription
--json[OPTIONAL] Output as JSON

What it shows​

  • CLI version — warns when a newer version is published, with a hint to run teams self-update (the current version is shown with --verbose)
  • Login status — username, tenant ID (with --verbose)
  • TDP access — whether a Teams Developer Portal token can be acquired
  • Sideloading (tenant) — whether the tenant admin has enabled custom app sideloading
  • Sideloading (user) — whether the user's Teams app setup policy allows sideloading
  • Azure CLI — installation, login status, and active subscription

JSON output​

{
  "cliVersion": { "current": "3.0.3", "latest": "3.0.4" },
  "updateAvailable": true,
  "loggedIn": true,
  "username": "user@contoso.com",
  "tenantId": "abc-123",
  "tdp": {
    "connected": true,
    "sideloading": {
      "tenant": true,
      "user": true
    }
  },
  "azureCli": {
    "installed": true,
    "loggedIn": true,
    "subscription": { "name": "My Sub", "id": "sub-id" }
  }
}

cliVersion.latest is null if the npm registry can't be reached. updateAvailable is only present when a newer version is published.