Share via


New-MgSecurityAlert

Create new navigation property to alerts for security

Note

To view the beta release of this cmdlet, view New-MgBetaSecurityAlert

Syntax

CreateExpanded (Default)

New-MgSecurityAlert
    [-ResponseHeadersVariable <string>]
    [-ActivityGroupName <string>]
    [-AdditionalProperties <hashtable>]
    [-AlertDetections <IMicrosoftGraphAlertDetection[]>]
    [-AssignedTo <string>]
    [-AzureSubscriptionId <string>]
    [-AzureTenantId <string>]
    [-Category <string>]
    [-ClosedDateTime <datetime>]
    [-CloudAppStates <IMicrosoftGraphCloudAppSecurityState[]>]
    [-Comments <string[]>]
    [-Confidence <int>]
    [-CreatedDateTime <datetime>]
    [-Description <string>]
    [-DetectionIds <string[]>]
    [-EventDateTime <datetime>]
    [-Feedback <string>]
    [-FileStates <IMicrosoftGraphFileSecurityState[]>]
    [-HistoryStates <IMicrosoftGraphAlertHistoryState[]>]
    [-HostStates <IMicrosoftGraphHostSecurityState[]>]
    [-Id <string>]
    [-IncidentIds <string[]>]
    [-InvestigationSecurityStates <IMicrosoftGraphInvestigationSecurityState[]>]
    [-LastEventDateTime <datetime>]
    [-LastModifiedDateTime <datetime>]
    [-MalwareStates <IMicrosoftGraphMalwareState[]>]
    [-MessageSecurityStates <IMicrosoftGraphMessageSecurityState[]>]
    [-NetworkConnections <IMicrosoftGraphNetworkConnection[]>]
    [-Processes <IMicrosoftGraphProcess[]>]
    [-RecommendedActions <string[]>]
    [-RegistryKeyStates <IMicrosoftGraphRegistryKeyState[]>]
    [-SecurityResources <IMicrosoftGraphSecurityResource[]>]
    [-Severity <string>]
    [-SourceMaterials <string[]>]
    [-Status <string>]
    [-Tags <string[]>]
    [-Title <string>]
    [-Triggers <IMicrosoftGraphAlertTrigger[]>]
    [-UriClickSecurityStates <IMicrosoftGraphUriClickSecurityState[]>]
    [-UserStates <IMicrosoftGraphUserSecurityState[]>]
    [-VendorInformation <IMicrosoftGraphSecurityVendorInformation>]
    [-VulnerabilityStates <IMicrosoftGraphVulnerabilityState[]>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgSecurityAlert
    -BodyParameter <IMicrosoftGraphAlert>
    [-ResponseHeadersVariable <string>]
    [-Break]
    [-Headers <IDictionary>]
    [-HttpPipelineAppend <SendAsyncStep[]>]
    [-HttpPipelinePrepend <SendAsyncStep[]>]
    [-Proxy <uri>]
    [-ProxyCredential <pscredential>]
    [-ProxyUseDefaultCredentials]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Parameters

-ActivityGroupName

Name or alias of the activity group (attacker) this alert is attributed to.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AdditionalProperties

Additional Parameters

Parameter properties

Type:System.Collections.Hashtable
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AlertDetections

To construct, see NOTES section for ALERTDETECTIONS properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAlertDetection[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AssignedTo

Name of the analyst the alert is assigned to for triage, investigation, or remediation (supports update).

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AzureSubscriptionId

Azure subscription ID, present if this alert is related to an Azure resource.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AzureTenantId

Microsoft Entra tenant ID. Required.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-BodyParameter

alert To construct, see NOTES section for BODYPARAMETER properties and create a hash table.

Parameter properties

Type:Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAlert
Supports wildcards:False
DontShow:False

Parameter sets

Create
Position:Named
Mandatory:True
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-Break

Wait for .NET debugger to attach

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Category

Category of the alert (for example, credentialTheft, ransomware).

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClosedDateTime

Time at which the alert was closed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z (supports update).

Parameter properties

Type:System.DateTime
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CloudAppStates

Security-related stateful information generated by the provider about the cloud application/s related to this alert. To construct, see NOTES section for CLOUDAPPSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphCloudAppSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Comments

Customer-provided comments on alert (for customer alert management) (supports update).

Parameter properties

Type:

System.String[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confidence

Confidence of the detection logic (percentage between 1-100).

Parameter properties

Type:System.Int32
Default value:0
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Supports wildcards:False
DontShow:False
Aliases:cf

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-CreatedDateTime

Time at which the alert was created by the alert provider. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Required.

Parameter properties

Type:System.DateTime
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Description

Alert description.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-DetectionIds

Set of alerts related to this alert entity (each alert is pushed to the SIEM as a separate record).

Parameter properties

Type:

System.String[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-EventDateTime

Time at which the event or events that served as the trigger to generate the alert occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Required.

Parameter properties

Type:System.DateTime
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Feedback

alertFeedback

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FileStates

Security-related stateful information generated by the provider about the file(s) related to this alert. To construct, see NOTES section for FILESTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphFileSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Headers

Optional headers that will be added to the request.

Parameter properties

Type:System.Collections.IDictionary
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:True
Value from pipeline by property name:False
Value from remaining arguments:False

-HistoryStates

To construct, see NOTES section for HISTORYSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAlertHistoryState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HostStates

Security-related stateful information generated by the provider about the host(s) related to this alert. To construct, see NOTES section for HOSTSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphHostSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HttpPipelineAppend

SendAsync Pipeline Steps to be appended to the front of the pipeline

Parameter properties

Type:

Microsoft.Graph.PowerShell.Runtime.SendAsyncStep[]

Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-HttpPipelinePrepend

SendAsync Pipeline Steps to be prepended to the front of the pipeline

Parameter properties

Type:

Microsoft.Graph.PowerShell.Runtime.SendAsyncStep[]

Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-IncidentIds

IDs of incidents related to current alert.

Parameter properties

Type:

System.String[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-InvestigationSecurityStates

To construct, see NOTES section for INVESTIGATIONSECURITYSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphInvestigationSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LastEventDateTime

Parameter properties

Type:System.DateTime
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-LastModifiedDateTime

Time at which the alert entity was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.

Parameter properties

Type:System.DateTime
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MalwareStates

Threat Intelligence pertaining to malware related to this alert. To construct, see NOTES section for MALWARESTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphMalwareState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-MessageSecurityStates

To construct, see NOTES section for MESSAGESECURITYSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphMessageSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-NetworkConnections

Security-related stateful information generated by the provider about the network connection(s) related to this alert. To construct, see NOTES section for NETWORKCONNECTIONS properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphNetworkConnection[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Processes

Security-related stateful information generated by the provider about the process or processes related to this alert. To construct, see NOTES section for PROCESSES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphProcess[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Proxy

The URI for the proxy server to use

Parameter properties

Type:System.Uri
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ProxyCredential

Credentials for a proxy server to use for the remote call

Parameter properties

Type:System.Management.Automation.PSCredential
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ProxyUseDefaultCredentials

Use the default credentials for the proxy

Parameter properties

Type:System.Management.Automation.SwitchParameter
Default value:False
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RecommendedActions

Vendor/provider recommended action(s) to take as a result of the alert (for example, isolate machine, enforce2FA, reimage host).

Parameter properties

Type:

System.String[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-RegistryKeyStates

Security-related stateful information generated by the provider about the registry keys related to this alert. To construct, see NOTES section for REGISTRYKEYSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphRegistryKeyState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False
Aliases:RHV

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SecurityResources

Resources related to current alert. For example, for some alerts this can have the Azure Resource value. To construct, see NOTES section for SECURITYRESOURCES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphSecurityResource[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Severity

alertSeverity

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-SourceMaterials

Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search.

Parameter properties

Type:

System.String[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Status

alertStatus

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Tags

User-definable labels that can be applied to an alert and can serve as filter conditions (for example 'HVA', 'SAW') (supports update).

Parameter properties

Type:

System.String[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Title

Alert title. Required.

Parameter properties

Type:System.String
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Triggers

Security-related information about the specific properties that triggered the alert (properties appearing in the alert). Alerts might contain information about multiple users, hosts, files, ip addresses. This field indicates which properties triggered the alert generation. To construct, see NOTES section for TRIGGERS properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAlertTrigger[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UriClickSecurityStates

To construct, see NOTES section for URICLICKSECURITYSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphUriClickSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-UserStates

Security-related stateful information generated by the provider about the user accounts related to this alert. To construct, see NOTES section for USERSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphUserSecurityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VendorInformation

securityVendorInformation To construct, see NOTES section for VENDORINFORMATION properties and create a hash table.

Parameter properties

Type:Microsoft.Graph.PowerShell.Models.IMicrosoftGraphSecurityVendorInformation
Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-VulnerabilityStates

Threat intelligence pertaining to one or more vulnerabilities related to this alert. To construct, see NOTES section for VULNERABILITYSTATES properties and create a hash table.

Parameter properties

Type:

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphVulnerabilityState[]

Supports wildcards:False
DontShow:False

Parameter sets

CreateExpanded
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-WhatIf

Runs the command in a mode that only reports what would happen without performing the actions.

Parameter properties

Type:System.Management.Automation.SwitchParameter
Supports wildcards:False
DontShow:False
Aliases:wi

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

CommonParameters

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

Inputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAlert

{{ Fill in the Description }}

System.Collections.IDictionary

{{ Fill in the Description }}

Outputs

Microsoft.Graph.PowerShell.Models.IMicrosoftGraphAlert

{{ Fill in the Description }}

Notes

COMPLEX PARAMETER PROPERTIES

To create the parameters described below, construct a hash table containing the appropriate properties. For information on hash tables, run Get-Help about_Hash_Tables.

ALERTDETECTIONS <IMicrosoftGraphAlertDetection[]>: . [DetectionType <String>]: [Method <String>]: [Name <String>]:

BODYPARAMETER <IMicrosoftGraphAlert>: alert [(Any) <Object>]: This indicates any property can be added to this object. [Id <String>]: The unique identifier for an entity. Read-only. [ActivityGroupName <String>]: Name or alias of the activity group (attacker) this alert is attributed to. [AlertDetections <IMicrosoftGraphAlertDetection[]>]: [DetectionType <String>]: [Method <String>]: [Name <String>]: [AssignedTo <String>]: Name of the analyst the alert is assigned to for triage, investigation, or remediation (supports update). [AzureSubscriptionId <String>]: Azure subscription ID, present if this alert is related to an Azure resource. [AzureTenantId <String>]: Microsoft Entra tenant ID. Required. [Category <String>]: Category of the alert (for example, credentialTheft, ransomware). [ClosedDateTime <DateTime?>]: Time at which the alert was closed. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z (supports update). [CloudAppStates <IMicrosoftGraphCloudAppSecurityState[]>]: Security-related stateful information generated by the provider about the cloud application/s related to this alert. [DestinationServiceIP <String>]: Destination IP Address of the connection to the cloud application/service. [DestinationServiceName <String>]: Cloud application/service name (for example 'Salesforce', 'DropBox', etc.). [RiskScore <String>]: Provider-generated/calculated risk score of the Cloud Application/Service. Recommended value range of 0-1, which equates to a percentage. [Comments <String[]>]: Customer-provided comments on alert (for customer alert management) (supports update). [Confidence <Int32?>]: Confidence of the detection logic (percentage between 1-100). [CreatedDateTime <DateTime?>]: Time at which the alert was created by the alert provider. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Required. [Description <String>]: Alert description. [DetectionIds <String[]>]: Set of alerts related to this alert entity (each alert is pushed to the SIEM as a separate record). [EventDateTime <DateTime?>]: Time at which the event or events that served as the trigger to generate the alert occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. Required. [Feedback <String>]: alertFeedback [FileStates <IMicrosoftGraphFileSecurityState[]>]: Security-related stateful information generated by the provider about the file(s) related to this alert. [FileHash <IMicrosoftGraphFileHash>]: fileHash [(Any) <Object>]: This indicates any property can be added to this object. [HashType <String>]: fileHashType [HashValue <String>]: Value of the file hash. [Name <String>]: File name (without path). [Path <String>]: Full file path of the file/imageFile. [RiskScore <String>]: Provider generated/calculated risk score of the alert file. Recommended value range of 0-1, which equates to a percentage. [HistoryStates <IMicrosoftGraphAlertHistoryState[]>]: [AppId <String>]: [AssignedTo <String>]: [Comments <String[]>]: [Feedback <String>]: alertFeedback [Status <String>]: alertStatus [UpdatedDateTime <DateTime?>]: [User <String>]: [HostStates <IMicrosoftGraphHostSecurityState[]>]: Security-related stateful information generated by the provider about the host(s) related to this alert. [Fqdn <String>]: Host FQDN (Fully Qualified Domain Name) (for example, machine.company.com). [IsAzureAdJoined <Boolean?>]: [IsAzureAdRegistered <Boolean?>]: [IsHybridAzureDomainJoined <Boolean?>]: True if the host is domain joined to an on-premises Active Directory domain. [NetBiosName <String>]: The local host name, without the DNS domain name. [OS <String>]: Host Operating System. (For example, Windows 10, macOS, RHEL, etc.). [PrivateIPAddress <String>]: Private (not routable) IPv4 or IPv6 address (see RFC 1918) at the time of the alert. [PublicIPAddress <String>]: Publicly routable IPv4 or IPv6 address (see RFC 1918) at time of the alert. [RiskScore <String>]: Provider-generated/calculated risk score of the host. Recommended value range of 0-1, which equates to a percentage. [IncidentIds <String[]>]: IDs of incidents related to current alert. [InvestigationSecurityStates <IMicrosoftGraphInvestigationSecurityState[]>]: [Name <String>]: [Status <String>]: [LastEventDateTime <DateTime?>]: [LastModifiedDateTime <DateTime?>]: Time at which the alert entity was last modified. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [MalwareStates <IMicrosoftGraphMalwareState[]>]: Threat Intelligence pertaining to malware related to this alert. [Category <String>]: Provider-generated malware category (for example, trojan, ransomware, etc.). [Family <String>]: Provider-generated malware family (for example, 'wannacry,' 'notpetya,' etc.). [Name <String>]: Provider-generated malware variant name (for example, Trojan:Win32/Powessere.H). [Severity <String>]: Provider-determined severity of this malware. [WasRunning <Boolean?>]: Indicates whether the detected file (malware/vulnerability) was running at the time of detection or was detected at rest on the disk. [MessageSecurityStates <IMicrosoftGraphMessageSecurityState[]>]: [ConnectingIP <String>]: [DeliveryAction <String>]: [DeliveryLocation <String>]: [Directionality <String>]: [InternetMessageId <String>]: [MessageFingerprint <String>]: [MessageReceivedDateTime <DateTime?>]: [MessageSubject <String>]: [NetworkMessageId <String>]: [NetworkConnections <IMicrosoftGraphNetworkConnection[]>]: Security-related stateful information generated by the provider about the network connection(s) related to this alert. [ApplicationName <String>]: Name of the application managing the network connection (for example, Facebook or SMTP). [DestinationAddress <String>]: Destination IP address (of the network connection). [DestinationDomain <String>]: Destination domain portion of the destination URL. (for example 'www.contoso.com'). [DestinationLocation <String>]: Location (by IP address mapping) associated with the destination of a network connection. [DestinationPort <String>]: Destination port (of the network connection). [DestinationUrl <String>]: Network connection URL/URI string - excluding parameters. (for example 'www.contoso.com/products/default.html') [Direction <String>]: connectionDirection [DomainRegisteredDateTime <DateTime?>]: Date when the destination domain was registered. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z [LocalDnsName <String>]: The local DNS name resolution as it appears in the host's local DNS cache (for example, in case the 'hosts' file was tampered with). [NatDestinationAddress <String>]: Network Address Translation destination IP address. [NatDestinationPort <String>]: Network Address Translation destination port. [NatSourceAddress <String>]: Network Address Translation source IP address. [NatSourcePort <String>]: Network Address Translation source port. [Protocol <String>]: securityNetworkProtocol [RiskScore <String>]: Provider generated/calculated risk score of the network connection. Recommended value range of 0-1, which equates to a percentage. [SourceAddress <String>]: Source (i.e. origin) IP address (of the network connection). [SourceLocation <String>]: Location (by IP address mapping) associated with the source of a network connection. [SourcePort <String>]: Source (i.e. origin) IP port (of the network connection). [Status <String>]: connectionStatus [UrlParameters <String>]: Parameters (suffix) of the destination URL. [Processes <IMicrosoftGraphProcess[]>]: Security-related stateful information generated by the provider about the process or processes related to this alert. [AccountName <String>]: User account identifier (user account context the process ran under) for example, AccountName, SID, and so on. [CommandLine <String>]: The full process invocation commandline including all parameters. [CreatedDateTime <DateTime?>]: Time at which the process was started. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [FileHash <IMicrosoftGraphFileHash>]: fileHash [IntegrityLevel <String>]: processIntegrityLevel [IsElevated <Boolean?>]: True if the process is elevated. [Name <String>]: The name of the process' Image file. [ParentProcessCreatedDateTime <DateTime?>]: DateTime at which the parent process was started. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [ParentProcessId <Int32?>]: The Process ID (PID) of the parent process. [ParentProcessName <String>]: The name of the image file of the parent process. [Path <String>]: Full path, including filename. [ProcessId <Int32?>]: The Process ID (PID) of the process. [RecommendedActions <String[]>]: Vendor/provider recommended action(s) to take as a result of the alert (for example, isolate machine, enforce2FA, reimage host). [RegistryKeyStates <IMicrosoftGraphRegistryKeyState[]>]: Security-related stateful information generated by the provider about the registry keys related to this alert. [Hive <String>]: registryHive [Key <String>]: Current (i.e. changed) registry key (excludes HIVE). [OldKey <String>]: Previous (i.e. before changed) registry key (excludes HIVE). [OldValueData <String>]: Previous (i.e. before changed) registry key value data (contents). [OldValueName <String>]: Previous (i.e. before changed) registry key value name. [Operation <String>]: registryOperation [ProcessId <Int32?>]: Process ID (PID) of the process that modified the registry key (process details will appear in the alert 'processes' collection). [ValueData <String>]: Current (i.e. changed) registry key value data (contents). [ValueName <String>]: Current (i.e. changed) registry key value name [ValueType <String>]: registryValueType [SecurityResources <IMicrosoftGraphSecurityResource[]>]: Resources related to current alert. For example, for some alerts this can have the Azure Resource value. [Resource <String>]: Name of the resource that is related to current alert. Required. [ResourceType <String>]: securityResourceType [Severity <String>]: alertSeverity [SourceMaterials <String[]>]: Hyperlinks (URIs) to the source material related to the alert, for example, provider's user interface for alerts or log search. [Status <String>]: alertStatus [Tags <String[]>]: User-definable labels that can be applied to an alert and can serve as filter conditions (for example 'HVA', 'SAW') (supports update). [Title <String>]: Alert title. Required. [Triggers <IMicrosoftGraphAlertTrigger[]>]: Security-related information about the specific properties that triggered the alert (properties appearing in the alert). Alerts might contain information about multiple users, hosts, files, ip addresses. This field indicates which properties triggered the alert generation. [Name <String>]: Name of the property serving as a detection trigger. [Type <String>]: Type of the property in the key:value pair for interpretation. For example, String, Boolean etc. [Value <String>]: Value of the property serving as a detection trigger. [UriClickSecurityStates <IMicrosoftGraphUriClickSecurityState[]>]: [ClickAction <String>]: [ClickDateTime <DateTime?>]: [Id <String>]: [SourceId <String>]: [UriDomain <String>]: [Verdict <String>]: [UserStates <IMicrosoftGraphUserSecurityState[]>]: Security-related stateful information generated by the provider about the user accounts related to this alert. [AadUserId <String>]: AAD User object identifier (GUID) - represents the physical/multi-account user entity. [AccountName <String>]: Account name of user account (without Active Directory domain or DNS domain) - (also called mailNickName). [DomainName <String>]: NetBIOS/Active Directory domain of user account (that is, domain/account format). [EmailRole <String>]: emailRole [IsVpn <Boolean?>]: Indicates whether the user logged on through a VPN. [LogonDateTime <DateTime?>]: Time at which the sign-in occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [LogonIP <String>]: IP Address the sign-in request originated from. [LogonId <String>]: User sign-in ID. [LogonLocation <String>]: Location (by IP address mapping) associated with a user sign-in event by this user. [LogonType <String>]: logonType [OnPremisesSecurityIdentifier <String>]: Active Directory (on-premises) Security Identifier (SID) of the user. [RiskScore <String>]: Provider-generated/calculated risk score of the user account. Recommended value range of 0-1, which equates to a percentage. [UserAccountType <String>]: userAccountSecurityType [UserPrincipalName <String>]: User sign-in name - internet format: (user account name)@(user account DNS domain name). [VendorInformation <IMicrosoftGraphSecurityVendorInformation>]: securityVendorInformation [(Any) <Object>]: This indicates any property can be added to this object. [Provider <String>]: Specific provider (product/service - not vendor company); for example, WindowsDefenderATP. [ProviderVersion <String>]: Version of the provider or subprovider, if it exists, that generated the alert. Required [SubProvider <String>]: Specific subprovider (under aggregating provider); for example, WindowsDefenderATP.SmartScreen. [Vendor <String>]: Name of the alert vendor (for example, Microsoft, Dell, FireEye). Required [VulnerabilityStates <IMicrosoftGraphVulnerabilityState[]>]: Threat intelligence pertaining to one or more vulnerabilities related to this alert. [Cve <String>]: Common Vulnerabilities and Exposures (CVE) for the vulnerability. [Severity <String>]: Base Common Vulnerability Scoring System (CVSS) severity score for this vulnerability. [WasRunning <Boolean?>]: Indicates whether the detected vulnerability (file) was running at the time of detection or was the file detected at rest on the disk.

CLOUDAPPSTATES <IMicrosoftGraphCloudAppSecurityState[]>: Security-related stateful information generated by the provider about the cloud application/s related to this alert. [DestinationServiceIP <String>]: Destination IP Address of the connection to the cloud application/service. [DestinationServiceName <String>]: Cloud application/service name (for example 'Salesforce', 'DropBox', etc.). [RiskScore <String>]: Provider-generated/calculated risk score of the Cloud Application/Service. Recommended value range of 0-1, which equates to a percentage.

FILESTATES <IMicrosoftGraphFileSecurityState[]>: Security-related stateful information generated by the provider about the file(s) related to this alert. [FileHash <IMicrosoftGraphFileHash>]: fileHash [(Any) <Object>]: This indicates any property can be added to this object. [HashType <String>]: fileHashType [HashValue <String>]: Value of the file hash. [Name <String>]: File name (without path). [Path <String>]: Full file path of the file/imageFile. [RiskScore <String>]: Provider generated/calculated risk score of the alert file. Recommended value range of 0-1, which equates to a percentage.

HISTORYSTATES <IMicrosoftGraphAlertHistoryState[]>: . [AppId <String>]: [AssignedTo <String>]: [Comments <String[]>]: [Feedback <String>]: alertFeedback [Status <String>]: alertStatus [UpdatedDateTime <DateTime?>]: [User <String>]:

HOSTSTATES <IMicrosoftGraphHostSecurityState[]>: Security-related stateful information generated by the provider about the host(s) related to this alert. [Fqdn <String>]: Host FQDN (Fully Qualified Domain Name) (for example, machine.company.com). [IsAzureAdJoined <Boolean?>]: [IsAzureAdRegistered <Boolean?>]: [IsHybridAzureDomainJoined <Boolean?>]: True if the host is domain joined to an on-premises Active Directory domain. [NetBiosName <String>]: The local host name, without the DNS domain name. [OS <String>]: Host Operating System. (For example, Windows 10, macOS, RHEL, etc.). [PrivateIPAddress <String>]: Private (not routable) IPv4 or IPv6 address (see RFC 1918) at the time of the alert. [PublicIPAddress <String>]: Publicly routable IPv4 or IPv6 address (see RFC 1918) at time of the alert. [RiskScore <String>]: Provider-generated/calculated risk score of the host. Recommended value range of 0-1, which equates to a percentage.

INVESTIGATIONSECURITYSTATES <IMicrosoftGraphInvestigationSecurityState[]>: . [Name <String>]: [Status <String>]:

MALWARESTATES <IMicrosoftGraphMalwareState[]>: Threat Intelligence pertaining to malware related to this alert. [Category <String>]: Provider-generated malware category (for example, trojan, ransomware, etc.). [Family <String>]: Provider-generated malware family (for example, 'wannacry,' 'notpetya,' etc.). [Name <String>]: Provider-generated malware variant name (for example, Trojan:Win32/Powessere.H). [Severity <String>]: Provider-determined severity of this malware. [WasRunning <Boolean?>]: Indicates whether the detected file (malware/vulnerability) was running at the time of detection or was detected at rest on the disk.

MESSAGESECURITYSTATES <IMicrosoftGraphMessageSecurityState[]>: . [ConnectingIP <String>]: [DeliveryAction <String>]: [DeliveryLocation <String>]: [Directionality <String>]: [InternetMessageId <String>]: [MessageFingerprint <String>]: [MessageReceivedDateTime <DateTime?>]: [MessageSubject <String>]: [NetworkMessageId <String>]:

NETWORKCONNECTIONS <IMicrosoftGraphNetworkConnection[]>: Security-related stateful information generated by the provider about the network connection(s) related to this alert. [ApplicationName <String>]: Name of the application managing the network connection (for example, Facebook or SMTP). [DestinationAddress <String>]: Destination IP address (of the network connection). [DestinationDomain <String>]: Destination domain portion of the destination URL. (for example 'www.contoso.com'). [DestinationLocation <String>]: Location (by IP address mapping) associated with the destination of a network connection. [DestinationPort <String>]: Destination port (of the network connection). [DestinationUrl <String>]: Network connection URL/URI string - excluding parameters. (for example 'www.contoso.com/products/default.html') [Direction <String>]: connectionDirection [DomainRegisteredDateTime <DateTime?>]: Date when the destination domain was registered. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z [LocalDnsName <String>]: The local DNS name resolution as it appears in the host's local DNS cache (for example, in case the 'hosts' file was tampered with). [NatDestinationAddress <String>]: Network Address Translation destination IP address. [NatDestinationPort <String>]: Network Address Translation destination port. [NatSourceAddress <String>]: Network Address Translation source IP address. [NatSourcePort <String>]: Network Address Translation source port. [Protocol <String>]: securityNetworkProtocol [RiskScore <String>]: Provider generated/calculated risk score of the network connection. Recommended value range of 0-1, which equates to a percentage. [SourceAddress <String>]: Source (i.e. origin) IP address (of the network connection). [SourceLocation <String>]: Location (by IP address mapping) associated with the source of a network connection. [SourcePort <String>]: Source (i.e. origin) IP port (of the network connection). [Status <String>]: connectionStatus [UrlParameters <String>]: Parameters (suffix) of the destination URL.

PROCESSES <IMicrosoftGraphProcess[]>: Security-related stateful information generated by the provider about the process or processes related to this alert. [AccountName <String>]: User account identifier (user account context the process ran under) for example, AccountName, SID, and so on. [CommandLine <String>]: The full process invocation commandline including all parameters. [CreatedDateTime <DateTime?>]: Time at which the process was started. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [FileHash <IMicrosoftGraphFileHash>]: fileHash [(Any) <Object>]: This indicates any property can be added to this object. [HashType <String>]: fileHashType [HashValue <String>]: Value of the file hash. [IntegrityLevel <String>]: processIntegrityLevel [IsElevated <Boolean?>]: True if the process is elevated. [Name <String>]: The name of the process' Image file. [ParentProcessCreatedDateTime <DateTime?>]: DateTime at which the parent process was started. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [ParentProcessId <Int32?>]: The Process ID (PID) of the parent process. [ParentProcessName <String>]: The name of the image file of the parent process. [Path <String>]: Full path, including filename. [ProcessId <Int32?>]: The Process ID (PID) of the process.

REGISTRYKEYSTATES <IMicrosoftGraphRegistryKeyState[]>: Security-related stateful information generated by the provider about the registry keys related to this alert. [Hive <String>]: registryHive [Key <String>]: Current (i.e. changed) registry key (excludes HIVE). [OldKey <String>]: Previous (i.e. before changed) registry key (excludes HIVE). [OldValueData <String>]: Previous (i.e. before changed) registry key value data (contents). [OldValueName <String>]: Previous (i.e. before changed) registry key value name. [Operation <String>]: registryOperation [ProcessId <Int32?>]: Process ID (PID) of the process that modified the registry key (process details will appear in the alert 'processes' collection). [ValueData <String>]: Current (i.e. changed) registry key value data (contents). [ValueName <String>]: Current (i.e. changed) registry key value name [ValueType <String>]: registryValueType

SECURITYRESOURCES <IMicrosoftGraphSecurityResource[]>: Resources related to current alert. For example, for some alerts this can have the Azure Resource value. [Resource <String>]: Name of the resource that is related to current alert. Required. [ResourceType <String>]: securityResourceType

TRIGGERS <IMicrosoftGraphAlertTrigger[]>: Security-related information about the specific properties that triggered the alert (properties appearing in the alert). Alerts might contain information about multiple users, hosts, files, ip addresses. This field indicates which properties triggered the alert generation. [Name <String>]: Name of the property serving as a detection trigger. [Type <String>]: Type of the property in the key:value pair for interpretation. For example, String, Boolean etc. [Value <String>]: Value of the property serving as a detection trigger.

URICLICKSECURITYSTATES <IMicrosoftGraphUriClickSecurityState[]>: . [ClickAction <String>]: [ClickDateTime <DateTime?>]: [Id <String>]: [SourceId <String>]: [UriDomain <String>]: [Verdict <String>]:

USERSTATES <IMicrosoftGraphUserSecurityState[]>: Security-related stateful information generated by the provider about the user accounts related to this alert. [AadUserId <String>]: AAD User object identifier (GUID) - represents the physical/multi-account user entity. [AccountName <String>]: Account name of user account (without Active Directory domain or DNS domain) - (also called mailNickName). [DomainName <String>]: NetBIOS/Active Directory domain of user account (that is, domain/account format). [EmailRole <String>]: emailRole [IsVpn <Boolean?>]: Indicates whether the user logged on through a VPN. [LogonDateTime <DateTime?>]: Time at which the sign-in occurred. The Timestamp type represents date and time information using ISO 8601 format and is always in UTC time. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z. [LogonIP <String>]: IP Address the sign-in request originated from. [LogonId <String>]: User sign-in ID. [LogonLocation <String>]: Location (by IP address mapping) associated with a user sign-in event by this user. [LogonType <String>]: logonType [OnPremisesSecurityIdentifier <String>]: Active Directory (on-premises) Security Identifier (SID) of the user. [RiskScore <String>]: Provider-generated/calculated risk score of the user account. Recommended value range of 0-1, which equates to a percentage. [UserAccountType <String>]: userAccountSecurityType [UserPrincipalName <String>]: User sign-in name - internet format: (user account name)@(user account DNS domain name).

VENDORINFORMATION <IMicrosoftGraphSecurityVendorInformation>: securityVendorInformation [(Any) <Object>]: This indicates any property can be added to this object. [Provider <String>]: Specific provider (product/service - not vendor company); for example, WindowsDefenderATP. [ProviderVersion <String>]: Version of the provider or subprovider, if it exists, that generated the alert. Required [SubProvider <String>]: Specific subprovider (under aggregating provider); for example, WindowsDefenderATP.SmartScreen. [Vendor <String>]: Name of the alert vendor (for example, Microsoft, Dell, FireEye). Required

VULNERABILITYSTATES <IMicrosoftGraphVulnerabilityState[]>: Threat intelligence pertaining to one or more vulnerabilities related to this alert. [Cve <String>]: Common Vulnerabilities and Exposures (CVE) for the vulnerability. [Severity <String>]: Base Common Vulnerability Scoring System (CVSS) severity score for this vulnerability. [WasRunning <Boolean?>]: Indicates whether the detected vulnerability (file) was running at the time of detection or was the file detected at rest on the disk.