New-MgBetaSecurityThreatSubmissionUrlThreat

Module:

Microsoft.Graph.Beta.Security Module

Create a new urlThreatSubmission object.

Syntax

CreateExpanded (Default)

New-MgBetaSecurityThreatSubmissionUrlThreat
    [-ResponseHeadersVariable <String>]
    [-AdditionalProperties <Hashtable>]
    [-AdminReview <IMicrosoftGraphSecuritySubmissionAdminReview>]
    [-Category <String>]
    [-ClientSource <String>]
    [-ContentType <String>]
    [-CreatedBy <IMicrosoftGraphSecuritySubmissionUserIdentity>]
    [-CreatedDateTime <DateTime>]
    [-Id <String>]
    [-Result <IMicrosoftGraphSecuritySubmissionResult>]
    [-Source <String>]
    [-Status <String>]
    [-TenantId <String>]
    [-WebUrl <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Create

New-MgBetaSecurityThreatSubmissionUrlThreat
    -BodyParameter <IMicrosoftGraphSecurityUrlThreatSubmission>
    [-ResponseHeadersVariable <String>]
    [-Headers <IDictionary>]
    [-WhatIf]
    [-Confirm]
    [<CommonParameters>]

Description

Create a new urlThreatSubmission object.

Permissions

Permission type	Permissions (from least to most privileged)
Delegated (work or school account)	ThreatSubmission.ReadWrite, ThreatSubmission.ReadWrite.All,
Delegated (personal Microsoft account)	Not supported
Application	ThreatSubmission.ReadWrite.All,

Examples

Example 1: Code snippet

Import-Module Microsoft.Graph.Beta.Security

$params = @{
	"@odata.type" = "#microsoft.graph.urlThreatSubmission"
	category = "phishing"
	webUrl = "http://phishing.contoso.com"
}

New-MgBetaSecurityThreatSubmissionUrlThreat -BodyParameter $params

This example shows how to use the New-MgBetaSecurityThreatSubmissionUrlThreat Cmdlet.

Parameters

-AdditionalProperties

Additional Parameters

Parameter properties

Type:	Hashtable
Default value:	None
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

-AdminReview

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

Parameter properties

Type:	IMicrosoftGraphSecuritySubmissionAdminReview
Default value:	None
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

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

Parameter properties

Type:	IMicrosoftGraphSecurityUrlThreatSubmission
Default value:	None
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

-Category

submissionCategory

Parameter properties

Type:	String
Default value:	None
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

-ClientSource

submissionClientSource

Parameter properties

Type:	String
Default value:	None
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:	SwitchParameter
Default value:	None
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

-ContentType

submissionContentType

Parameter properties

Type:	String
Default value:	None
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

-CreatedBy

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

Parameter properties

Type:	IMicrosoftGraphSecuritySubmissionUserIdentity
Default value:	None
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

-CreatedDateTime

Specifies when the threat submission was created. Supports $filter = createdDateTime ge 2022-01-01T00:00:00Z and createdDateTime lt 2022-01-02T00:00:00Z.

Parameter properties

Type:	DateTime
Default value:	None
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:	IDictionary
Default value:	None
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

-Id

The unique identifier for an entity. Read-only.

Parameter properties

Type:	String
Default value:	None
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:	String
Default value:	None
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

-Result

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

Parameter properties

Type:	IMicrosoftGraphSecuritySubmissionResult
Default value:	None
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

-Source

submissionSource

Parameter properties

Type:	String
Default value:	None
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

longRunningOperationStatus

Parameter properties

Type:	String
Default value:	None
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

-TenantId

Indicates the tenant id of the submitter. Not required when created using a POST operation. It's extracted from the token of the post API call.

Parameter properties

Type:	String
Default value:	None
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

-WebUrl

Denotes the webUrl that needs to be submitted.

Parameter properties

Type:	String
Default value:	None
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

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Parameter properties

Type:	SwitchParameter
Default value:	None
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.Beta.PowerShell.Models.IMicrosoftGraphSecurityUrlThreatSubmission

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityUrlThreatSubmission

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.

ADMINREVIEW <IMicrosoftGraphSecuritySubmissionAdminReview>: submissionAdminReview

• [(Any) <Object>]: This indicates any property can be added to this object.
• [ReviewBy <String>]: Specifies who reviewed the email. The identification is an email ID or other identity strings.
• [ReviewDateTime <DateTime?>]: Specifies the date time when the review occurred.
• [ReviewResult <String>]: submissionResultCategory

BODYPARAMETER <IMicrosoftGraphSecurityUrlThreatSubmission>: urlThreatSubmission

• [(Any) <Object>]: This indicates any property can be added to this object.
• [AdminReview <IMicrosoftGraphSecuritySubmissionAdminReview>]: submissionAdminReview
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [ReviewBy <String>]: Specifies who reviewed the email. The identification is an email ID or other identity strings.
  • [ReviewDateTime <DateTime?>]: Specifies the date time when the review occurred.
  • [ReviewResult <String>]: submissionResultCategory
• [Category <String>]: submissionCategory
• [ClientSource <String>]: submissionClientSource
• [ContentType <String>]: submissionContentType
• [CreatedBy <IMicrosoftGraphSecuritySubmissionUserIdentity>]: submissionUserIdentity
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [DisplayName <String>]: The display name of the identity. This property is read-only.
  • [Id <String>]: The identifier of the identity. This property is read-only.
  • [Email <String>]: The email of user who is making the submission when logged in (delegated token case).
• [CreatedDateTime <DateTime?>]: Specifies when the threat submission was created. Supports $filter = createdDateTime ge 2022-01-01T00:00:00Z and createdDateTime lt 2022-01-02T00:00:00Z.
• [Result <IMicrosoftGraphSecuritySubmissionResult>]: submissionResult
  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Category <String>]: submissionResultCategory
  • [Detail <String>]: submissionResultDetail
  • [DetectedFiles <IMicrosoftGraphSecuritySubmissionDetectedFile- []>]: Specifies the files detected by Microsoft in the submitted emails.
    • [FileHash <String>]: The file hash.
    • [FileName <String>]: The file name.
  • [DetectedUrls <String- []>]: Specifies the URLs detected by Microsoft in the submitted email.
  • [UserMailboxSetting <String>]: userMailboxSetting
• [Source <String>]: submissionSource
• [Status <String>]: longRunningOperationStatus
• [TenantId <String>]: Indicates the tenant id of the submitter. Not required when created using a POST operation. It's extracted from the token of the post API call.
• [Id <String>]: The unique identifier for an entity. Read-only.
• [WebUrl <String>]: Denotes the webUrl that needs to be submitted.

CREATEDBY <IMicrosoftGraphSecuritySubmissionUserIdentity>: submissionUserIdentity

• [(Any) <Object>]: This indicates any property can be added to this object.
• [DisplayName <String>]: The display name of the identity. This property is read-only.
• [Id <String>]: The identifier of the identity. This property is read-only.
• [Email <String>]: The email of user who is making the submission when logged in (delegated token case).

RESULT <IMicrosoftGraphSecuritySubmissionResult>: submissionResult

• [(Any) <Object>]: This indicates any property can be added to this object.
• [Category <String>]: submissionResultCategory
• [Detail <String>]: submissionResultDetail
• [DetectedFiles <IMicrosoftGraphSecuritySubmissionDetectedFile- []>]: Specifies the files detected by Microsoft in the submitted emails.
  • [FileHash <String>]: The file hash.
  • [FileName <String>]: The file name.
• [DetectedUrls <String- []>]: Specifies the URLs detected by Microsoft in the submitted email.
• [UserMailboxSetting <String>]: userMailboxSetting

Related Links

• https://learn.microsoft.com/powershell/module/microsoft.graph.beta.security/new-mgbetasecuritythreatsubmissionurlthreat
• https://learn.microsoft.com/graph/api/security-urlthreatsubmission-post-urlthreats?view=graph-rest-beta