Share via

New-MgBetaSecuritySecureScoreControlProfile

  • Reference
Module:
Microsoft.Graph.Beta.Security

Create new navigation property to secureScoreControlProfiles for security

Note

To view the v1.0 release of this cmdlet, view New-MgSecuritySecureScoreControlProfile

Syntax

PowerShell 
New-MgBetaSecuritySecureScoreControlProfile
   [-ResponseHeadersVariable <String>]
   [-ActionType <String>]
   [-ActionUrl <String>]
   [-AdditionalProperties <Hashtable>]
   [-AzureTenantId <String>]
   [-ComplianceInformation <IMicrosoftGraphComplianceInformation[]>]
   [-ControlCategory <String>]
   [-ControlStateUpdates <IMicrosoftGraphSecureScoreControlStateUpdate[]>]
   [-Deprecated]
   [-Id <String>]
   [-ImplementationCost <String>]
   [-LastModifiedDateTime <DateTime>]
   [-MaxScore <Double>]
   [-Rank <Int32>]
   [-Remediation <String>]
   [-RemediationImpact <String>]
   [-Service <String>]
   [-Threats <String[]>]
   [-Tier <String>]
   [-Title <String>]
   [-UserImpact <String>]
   [-VendorInformation <IMicrosoftGraphSecurityVendorInformation>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]
PowerShell 
New-MgBetaSecuritySecureScoreControlProfile
   -BodyParameter <IMicrosoftGraphSecureScoreControlProfile>
   [-ResponseHeadersVariable <String>]
   [-Headers <IDictionary>]
   [-ProgressAction <ActionPreference>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

Create new navigation property to secureScoreControlProfiles for security

Parameters

-ActionType

Control action type (Config, Review, Behavior).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ActionUrl

URL to where the control can be actioned.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AdditionalProperties

Additional Parameters

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-AzureTenantId

GUID string for tenant ID.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BodyParameter

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

Type:IMicrosoftGraphSecureScoreControlProfile
Position:Named
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-ComplianceInformation

The collection of compliance information associated with secure score control To construct, see NOTES section for COMPLIANCEINFORMATION properties and create a hash table.

Type:IMicrosoftGraphComplianceInformation[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ControlCategory

Control action category (Account, Data, Device, Apps, Infrastructure).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ControlStateUpdates

Flag to indicate where the tenant has marked a control (ignored, thirdParty, reviewed) (supports update). To construct, see NOTES section for CONTROLSTATEUPDATES properties and create a hash table.

Type:IMicrosoftGraphSecureScoreControlStateUpdate[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Deprecated

Flag to indicate if a control is depreciated.

Type:SwitchParameter
Position:Named
Default value:False
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Headers

Optional headers that will be added to the request.

Type:IDictionary
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False

-Id

The unique identifier for an entity. Read-only.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ImplementationCost

Resource cost of implemmentating control (low, moderate, high).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-LastModifiedDateTime

Time at which the control profile entity was last modified. The Timestamp type represents date and time

Type:DateTime
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-MaxScore

Current obtained max score on specified date.

Type:Double
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Rank

Microsoft's stack ranking of control.

Type:Int32
Position:Named
Default value:0
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Remediation

Description of what the control will help remediate.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RemediationImpact

Description of the impact on users of the remediation.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-ResponseHeadersVariable

Optional Response Headers Variable.

Type:String
Aliases:RHV
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Service

Service that owns the control (Exchange, Sharepoint, Microsoft Entra ID).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Threats

List of threats the control mitigates (accountBreach, dataDeletion, dataExfiltration, dataSpillage, elevationOfPrivilege, maliciousInsider, passwordCracking, phishingOrWhaling, spoofing).

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Tier

Control tier (Core, Defense in Depth, Advanced.)

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Title

Title of the control.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-UserImpact

User impact of implementing control (low, moderate, high).

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-VendorInformation

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

Type:IMicrosoftGraphSecurityVendorInformation
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-WhatIf

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

Type:SwitchParameter
Aliases:wi
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecureScoreControlProfile

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecureScoreControlProfile

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.

BODYPARAMETER <IMicrosoftGraphSecureScoreControlProfile>: secureScoreControlProfile

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [ActionType <String>]: Control action type (Config, Review, Behavior).
  • [ActionUrl <String>]: URL to where the control can be actioned.
  • [AzureTenantId <String>]: GUID string for tenant ID.
  • [ComplianceInformation <IMicrosoftGraphComplianceInformation- []>]: The collection of compliance information associated with secure score control
    • [CertificationControls <IMicrosoftGraphCertificationControl- []>]: Collection of the certification controls associated with the certification.
      • [Name <String>]: Certification control name.
      • [Url <String>]: URL for the Microsoft Service Trust Portal.
    • [CertificationName <String>]: The name of the compliance certification, for example, ISO 27018:2014, GDPR, FedRAMP, and NIST 800-171.
  • [ControlCategory <String>]: Control action category (Account, Data, Device, Apps, Infrastructure).
  • [ControlStateUpdates <IMicrosoftGraphSecureScoreControlStateUpdate- []>]: Flag to indicate where the tenant has marked a control (ignored, thirdParty, reviewed) (supports update).
    • [AssignedTo <String>]: Assign the control to the user who will take the action
    • [Comment <String>]: Provides optional comment about the control
    • [State <String>]: State of the control can be modified using PATCH command(Ex: ignored, thirdParty etc)
    • [UpdatedBy <String>]: ID of the user who updated tenant state
    • [UpdatedDateTime <DateTime?>]: Time at which control state was updated
  • [Deprecated <Boolean?>]: Flag to indicate if a control is depreciated.
  • [ImplementationCost <String>]: Resource cost of implemmentating control (low, moderate, high).
  • [LastModifiedDateTime <DateTime?>]: Time at which the control profile entity was last modified. The Timestamp type represents date and time
  • [MaxScore <Double?>]: Current obtained max score on specified date.
  • [Rank <Int32?>]: Microsoft's stack ranking of control.
  • [Remediation <String>]: Description of what the control will help remediate.
  • [RemediationImpact <String>]: Description of the impact on users of the remediation.
  • [Service <String>]: Service that owns the control (Exchange, Sharepoint, Microsoft Entra ID).
  • [Threats <String- []>]: List of threats the control mitigates (accountBreach, dataDeletion, dataExfiltration, dataSpillage, elevationOfPrivilege, maliciousInsider, passwordCracking, phishingOrWhaling, spoofing).
  • [Tier <String>]: Control tier (Core, Defense in Depth, Advanced.)
  • [Title <String>]: Title of the control.
  • [UserImpact <String>]: User impact of implementing control (low, moderate, high).
  • [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

COMPLIANCEINFORMATION <IMicrosoftGraphComplianceInformation- []>: The collection of compliance information associated with secure score control

  • [CertificationControls <IMicrosoftGraphCertificationControl- []>]: Collection of the certification controls associated with the certification.
    • [Name <String>]: Certification control name.
    • [Url <String>]: URL for the Microsoft Service Trust Portal.
  • [CertificationName <String>]: The name of the compliance certification, for example, ISO 27018:2014, GDPR, FedRAMP, and NIST 800-171.

CONTROLSTATEUPDATES <IMicrosoftGraphSecureScoreControlStateUpdate- []>: Flag to indicate where the tenant has marked a control (ignored, thirdParty, reviewed) (supports update).

  • [AssignedTo <String>]: Assign the control to the user who will take the action
  • [Comment <String>]: Provides optional comment about the control
  • [State <String>]: State of the control can be modified using PATCH command(Ex: ignored, thirdParty etc)
  • [UpdatedBy <String>]: ID of the user who updated tenant state
  • [UpdatedDateTime <DateTime?>]: Time at which control state was updated

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