portalNotification resource type

Namespace: microsoft.graph.deviceManagement


APIs under the /beta version in Microsoft Graph are subject to change. Use of these APIs in production applications is not supported. To determine whether an API is available in v1.0, use the Version selector.

Represents the portal notification associated with the alert record of a user.


This API is part of the alert monitoring API set which currently supports only Windows 365 and Cloud PC scenarios. The API set allows admins to set up rules to alert issues with provisioning Cloud PCs, uploading Cloud PC images, and checking Azure network connections.

Have a different scenario that can use additional programmatic alert support on the Microsoft Endpoint Manager admin center? Suggest the feature or vote for existing feature requests.


Property Type Description
alertImpact microsoft.graph.deviceManagement.alertImpact The associated alert impact.
alertRecordId String The associated alert record ID.
alertRuleId String The associated alert rule ID.
alertRuleName String The associated alert rule name.
alertRuleTemplate microsoft.graph.deviceManagement.alertRuleTemplate The associated alert rule template. The possible values are: cloudPcProvisionScenario, cloudPcImageUploadScenario, cloudPcOnPremiseNetworkConnectionCheckScenario, unknownFutureValue, cloudPcInGracePeriodScenario. Note that you must use the Prefer: include-unknown-enum-members request header to get the following values from this evolvable enum: cloudPcInGracePeriodScenario.
id String The unique identifier for the portal notification.
isPortalNotificationSent Boolean true if the portal notification has already been sent to the user; false otherwise.
severity microsoft.graph.deviceManagement.ruleSeverityType The associated alert rule severity. The possible values are: unknown, informational, warning, critical, unknownFutureValue.



JSON representation

The following is a JSON representation of the resource.

  "@odata.type": "#microsoft.graph.deviceManagement.portalNotification",
  "alertImpact": {
    "@odata.type": "microsoft.graph.deviceManagement.alertImpact"
  "alertRecordId": "String",
  "alertRuleId": "String",
  "alertRuleName": "String",
  "alertRuleTemplate": "String",
  "id": "String (identifier)",
  "isPortalNotificationSent": "Boolean",
  "severity": "String"