Cli-microsoft365: New command: Get health status of the different services in Office 365

[waldekmastykarz]

Usage

service status list [options]

Description

Gets health status of the different services in Office 365

Options

| Option | Description |
| ----------------------- | ----------------------------------------- |
| -o, --output [output] | Output type. json\|text. Default text |
| --verbose | Runs command with verbose logging |
| --debug | Runs command with debug logging |

Additional Information

Implemented using the REST API: https://docs.microsoft.com/en-us/office/office-365-management-api/office-365-service-communications-api-reference#get-current-status

[douglasromao]

@waldekmastykarz I really would like to help, but the last time that I tried, I had some issues putting to work :( can I get this one to test/learn the contribution path?

[VelinGeorgiev]

@douglasromao, feel free to get this one. I assigned it to you. Thanks for your help!

[garrytrinder]

Feel free to reach out if you need any assistance @douglasromao 👍🏻

[waldekmastykarz]

Hey @douglasromao, are you still working on this?

[waldekmastykarz]

Setting as available due to lack of response

[anoopt]

@waldekmastykarz @garrytrinder @VelinGeorgiev - is anyone working on this request? If not, I am happy to pick it up.

[garrytrinder]

All yours @anoopt 👍🏻

Thanks for the help 😊

[anoopt]

Hello @garrytrinder - as per the documentation, this command would need permissions to the Office 365 Management API (scope - https://manage.office.com/.default). Can you please let me know where do we specify that?

[waldekmastykarz]

There is no need to specify it. We'll add the necessary permission to the default AAD app that we use in the CLI. When that's done, we'd update the docs to include the newly added permissions. Shall I add the permission to the AAD app already?

[anoopt]

@waldekmastykarz - Yes please. Thank you. FYI, please find below the details of the access token request (if that helps)

[anoopt]

Hello all, the ServiceComms/CurrentStatus endpoint returns JSON data as shown below. Should the Office 365 CLI command output the data in a simplified format?

{
  "@odata.context": "https://office365servicecomms-prod.cloudapp.net/api/v1.0/contoso.sharepoint.com/$metadata#CurrentStatus",
  "value": [
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Networking Issues",
          "FeatureName": "Networking Issues",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Sign-in",
          "FeatureName": "Signin",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "E-Mail and calendar access",
          "FeatureName": "Access",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "E-Mail timely delivery",
          "FeatureName": "Delivery",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Management and Provisioning",
          "FeatureName": "Provisioning",
          "FeatureServiceStatus": "ServiceDegradation",
          "FeatureServiceStatusDisplayName": "Service degradation"
        },
        {
          "FeatureDisplayName": "Voice mail",
          "FeatureName": "UnifiedMessaging",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "Exchange",
      "IncidentIds": [
        "EX207367"
      ],
      "Status": "ServiceDegradation",
      "StatusDisplayName": "Service degradation",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "Exchange",
      "WorkloadDisplayName": "Exchange Online"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Service",
          "FeatureName": "service",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Form functionality",
          "FeatureName": "functionality",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Integration",
          "FeatureName": "integration",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "Forms",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "Forms",
      "WorkloadDisplayName": "Microsoft Forms"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Kaizala Messaging",
          "FeatureName": "kaizalamessaging",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Kaizala Management Portal",
          "FeatureName": "kaizalaportal",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "kaizalamessagingservices",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "kaizalamessagingservices",
      "WorkloadDisplayName": "Microsoft Kaizala"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Audio and Video",
          "FeatureName": "AudioVideo",
          "FeatureServiceStatus": "ServiceDegradation",
          "FeatureServiceStatusDisplayName": "Service degradation"
        },
        {
          "FeatureDisplayName": "Federation",
          "FeatureName": "Federation",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Management and Provisioning",
          "FeatureName": "ManagementandProvisioning",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Sign-In",
          "FeatureName": "Sign-In",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "All Features",
          "FeatureName": "All",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Dial-In Conferencing",
          "FeatureName": "DialInConferencing",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Online Meetings",
          "FeatureName": "OnlineMeetings",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Instant Messaging",
          "FeatureName": "InstantMessaging",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Presence",
          "FeatureName": "Presence",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Mobility",
          "FeatureName": "Mobility",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Cloud PBX",
          "FeatureName": "CloudPBX",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "PSTN Calling",
          "FeatureName": "PSTNCalling",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Meeting Broadcast",
          "FeatureName": "MeetingBroadcast",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "Lync",
      "IncidentIds": [
        "LY206705"
      ],
      "Status": "ServiceDegradation",
      "StatusDisplayName": "Service degradation",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "Lync",
      "WorkloadDisplayName": "Skype for Business"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Service and web access issues",
          "FeatureName": "Service",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "MicrosoftFlow",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "MicrosoftFlow",
      "WorkloadDisplayName": "Microsoft Power Automate"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Service and web access issues",
          "FeatureName": "Service",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "MicrosoftFlowM365",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "MicrosoftFlowM365",
      "WorkloadDisplayName": "Microsoft Power Automate in Microsoft 365"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Teams Components",
          "FeatureName": "TeamsComponents",
          "FeatureServiceStatus": "ServiceDegradation",
          "FeatureServiceStatusDisplayName": "Service degradation"
        }
      ],
      "Id": "microsoftteams",
      "IncidentIds": [
        "TM207342",
        "TM207796"
      ],
      "Status": "ServiceDegradation",
      "StatusDisplayName": "Service degradation",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "microsoftteams",
      "WorkloadDisplayName": "Microsoft Teams"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Mobile Device Management",
          "FeatureName": "MobileDeviceManagement",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "MobileDeviceManagement",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "MobileDeviceManagement",
      "WorkloadDisplayName": "Mobile Device Management for Office 365"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Office Client issues",
          "FeatureName": "OfficeClient",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "O365Client",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "O365Client",
      "WorkloadDisplayName": "Office Client Applications"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Excel Online",
          "FeatureName": "excelonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "OneNote Online",
          "FeatureName": "onenoteonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "PowerPoint Online",
          "FeatureName": "powerpointonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Word Online",
          "FeatureName": "wordonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Visio Online",
          "FeatureName": "visioonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "officeonline",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "officeonline",
      "WorkloadDisplayName": "Office for the web"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "OneDrive for Business",
          "FeatureName": "OneDrive for Business",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "OneDriveForBusiness",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "OneDriveForBusiness",
      "WorkloadDisplayName": "OneDrive for Business"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Sign-In",
          "FeatureName": "authentication",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Administration",
          "FeatureName": "administration",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "OrgLiveID",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "OrgLiveID",
      "WorkloadDisplayName": "Identity Service"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Portal",
          "FeatureName": "Portal",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Administration",
          "FeatureName": "Administration",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Purchase and Billing",
          "FeatureName": "PurchaseAndBilling",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "OSDPPlatform",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "OSDPPlatform",
      "WorkloadDisplayName": "Office 365 Portal"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Licensing and Renewal",
          "FeatureName": "LicensingRenewal",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Network Availability",
          "FeatureName": "networking",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Office Professional Plus Download",
          "FeatureName": "officedownload",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "OSub",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "OSub",
      "WorkloadDisplayName": "Office Subscription"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Planner",
          "FeatureName": "Planner",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "Planner",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "Planner",
      "WorkloadDisplayName": "Planner"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Service and web access issues",
          "FeatureName": "Service",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "PowerAppsM365",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "PowerAppsM365",
      "WorkloadDisplayName": "Power Apps in Microsoft 365"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Provisioning",
          "FeatureName": "provisioning",
          "FeatureServiceStatus": "ServiceDegradation",
          "FeatureServiceStatusDisplayName": "Service degradation"
        },
        {
          "FeatureDisplayName": "SharePoint Features",
          "FeatureName": "spofeatures",
          "FeatureServiceStatus": "RestoringService",
          "FeatureServiceStatusDisplayName": "Restoring service"
        },
        {
          "FeatureDisplayName": "Tenant Admin",
          "FeatureName": "tenantadmin",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Search and Delve",
          "FeatureName": "search",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Custom Solutions and Workflows",
          "FeatureName": "customsolutionsworkflows",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Project Online",
          "FeatureName": "projectonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Office Web Apps",
          "FeatureName": "officewebapps",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "SP Designer",
          "FeatureName": "spdesigner",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "Access Services",
          "FeatureName": "accessservices",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        },
        {
          "FeatureDisplayName": "InfoPath Online",
          "FeatureName": "infopathonline",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "SharePoint",
      "IncidentIds": [
        "SP207180",
        "SP207374",
        "SP207734"
      ],
      "Status": "ServiceDegradation",
      "StatusDisplayName": "Service degradation",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "SharePoint",
      "WorkloadDisplayName": "SharePoint Online"
    },
    {
      "FeatureStatus": [
        {
          "FeatureDisplayName": "Sway",
          "FeatureName": "Sway",
          "FeatureServiceStatus": "ServiceOperational",
          "FeatureServiceStatusDisplayName": "Normal service"
        }
      ],
      "Id": "SwayEnterprise",
      "IncidentIds": [],
      "Status": "ServiceOperational",
      "StatusDisplayName": "Normal service",
      "StatusTime": "2020-03-26T00:00:54.0547782Z",
      "Workload": "SwayEnterprise",
      "WorkloadDisplayName": "Sway"
    }
  ]
}

[waldekmastykarz]

I'd suggest that we follow the typical setup where in the text format we return a subset information and then the complete object is sent to output in json mode. For text mode, workload display name, feature display name and status display name would be enough.

[waldekmastykarz]

@anoopt https://manage.office.com/.default is not a permission scope you can grant. The docs mention ServiceHealth.Read. Is that the right scope?

[anoopt]

@waldekmastykarz - Yes ServiceHealth.Read permission is what we need. Sorry for not mentioning it before.