Update-MgBetaSecurityIdentity

Update the navigation property identities in security

Note

To view the v1.0 release of this cmdlet, view Update-MgSecurityIdentity

Syntax

PowerShell
Update-MgBetaSecurityIdentity
      [-ResponseHeadersVariable <String>]
      [-AdditionalProperties <Hashtable>]
      [-HealthIssues <IMicrosoftGraphSecurityHealthIssue[]>]
      [-Id <String>]
      [-Sensors <IMicrosoftGraphSecuritySensor[]>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]
PowerShell
Update-MgBetaSecurityIdentity
      -BodyParameter <IMicrosoftGraphSecurityIdentityContainer>
      [-ResponseHeadersVariable <String>]
      [-Headers <IDictionary>]
      [-ProgressAction <ActionPreference>]
      [-WhatIf]
      [-Confirm]
      [<CommonParameters>]

Description

Update the navigation property identities in security

Parameters

-AdditionalProperties

Additional Parameters

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

-BodyParameter

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

Type:IMicrosoftGraphSecurityIdentityContainer
Position:Named
Default value:None
Required:True
Accept pipeline input:True
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

-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

-HealthIssues

Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified. To construct, see NOTES section for HEALTHISSUES properties and create a hash table.

Type:IMicrosoftGraphSecurityHealthIssue[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
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

-ProgressAction

{{ Fill ProgressAction Description }}

Type:ActionPreference
Aliases:proga
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

-Sensors

Represents a customer's Microsoft Defender for Identity sensors. To construct, see NOTES section for SENSORS properties and create a hash table.

Type:IMicrosoftGraphSecuritySensor[]
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.IMicrosoftGraphSecurityIdentityContainer

System.Collections.IDictionary

Outputs

Microsoft.Graph.Beta.PowerShell.Models.IMicrosoftGraphSecurityIdentityContainer

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 <IMicrosoftGraphSecurityIdentityContainer>: identityContainer

  • [(Any) <Object>]: This indicates any property can be added to this object.
  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [HealthIssues <IMicrosoftGraphSecurityHealthIssue- []>]: Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AdditionalInformation <String- []>]: Contains additional information about the issue, such as a list of items to fix.
    • [CreatedDateTime <DateTime?>]: The date and time when the health issue was generated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
    • [Description <String>]: Contains more detailed information about the health issue.
    • [DisplayName <String>]: The display name of the health issue.
    • [DomainNames <String- []>]: A list of the fully qualified domain names of the domains or the sensors the health issue is related to.
    • [HealthIssueType <String>]: healthIssueType
    • [IssueTypeId <String>]: The type identifier of the health issue. For a list of all health issues and their identifiers, see Microsoft Defender for Identity health issues.
    • [LastModifiedDateTime <DateTime?>]: The date and time when the health issue was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
    • [Recommendations <String- []>]: A list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include instructions for further investigation and aren't limited to prewritten responses.
    • [RecommendedActionCommands <String- []>]: A list of commands from the PowerShell module for the product that can be used to resolve the issue, if available. If no commands can be used to solve the issue, this property is empty. The commands, if present, provide a quick and efficient way to address the issue. These commands run in sequence for the single recommended fix.
    • [SensorDnsNames <String- []>]: A list of the DNS names of the sensors the health issue is related to.
    • [Severity <String>]: healthIssueSeverity
    • [Status <String>]: healthIssueStatus
  • [Sensors <IMicrosoftGraphSecuritySensor- []>]: Represents a customer's Microsoft Defender for Identity sensors.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [CreatedDateTime <DateTime?>]: The date and time when the sensor was generated.
    • [DeploymentStatus <String>]: deploymentStatus
    • [DisplayName <String>]: The display name of the sensor.
    • [DomainName <String>]: The fully qualified domain name of the sensor.
    • [HealthIssues <IMicrosoftGraphSecurityHealthIssue- []>]: Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified related to the sensor.
    • [HealthStatus <String>]: sensorHealthStatus
    • [OpenHealthIssuesCount <Int64?>]: This field displays the count of health issues related to this sensor.
    • [SensorType <String>]: sensorType
    • [Settings <IMicrosoftGraphSecuritySensorSettings>]: sensorSettings
      • [(Any) <Object>]: This indicates any property can be added to this object.
      • [Description <String>]: Description of the sensor.
      • [DomainControllerDnsNames <String- []>]: DNS names for the domain controller
      • [IsDelayedDeploymentEnabled <Boolean?>]: Indicates whether to delay updates for the sensor.
      • [NetworkAdapters <IMicrosoftGraphSecurityNetworkAdapter- []>]:
        • [Id <String>]: The unique identifier for an entity. Read-only.
        • [IsEnabled <Boolean?>]: Indicates whether the network adapter is selected for capturing and analyzing network traffic.
        • [Name <String>]: The name of the network adapter.
    • [Version <String>]: The version of the sensor.

HEALTHISSUES <IMicrosoftGraphSecurityHealthIssue- []>: Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [AdditionalInformation <String- []>]: Contains additional information about the issue, such as a list of items to fix.
  • [CreatedDateTime <DateTime?>]: The date and time when the health issue was generated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
  • [Description <String>]: Contains more detailed information about the health issue.
  • [DisplayName <String>]: The display name of the health issue.
  • [DomainNames <String- []>]: A list of the fully qualified domain names of the domains or the sensors the health issue is related to.
  • [HealthIssueType <String>]: healthIssueType
  • [IssueTypeId <String>]: The type identifier of the health issue. For a list of all health issues and their identifiers, see Microsoft Defender for Identity health issues.
  • [LastModifiedDateTime <DateTime?>]: The date and time when the health issue was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
  • [Recommendations <String- []>]: A list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include instructions for further investigation and aren't limited to prewritten responses.
  • [RecommendedActionCommands <String- []>]: A list of commands from the PowerShell module for the product that can be used to resolve the issue, if available. If no commands can be used to solve the issue, this property is empty. The commands, if present, provide a quick and efficient way to address the issue. These commands run in sequence for the single recommended fix.
  • [SensorDnsNames <String- []>]: A list of the DNS names of the sensors the health issue is related to.
  • [Severity <String>]: healthIssueSeverity
  • [Status <String>]: healthIssueStatus

SENSORS <IMicrosoftGraphSecuritySensor- []>: Represents a customer's Microsoft Defender for Identity sensors.

  • [Id <String>]: The unique identifier for an entity. Read-only.
  • [CreatedDateTime <DateTime?>]: The date and time when the sensor was generated.
  • [DeploymentStatus <String>]: deploymentStatus
  • [DisplayName <String>]: The display name of the sensor.
  • [DomainName <String>]: The fully qualified domain name of the sensor.
  • [HealthIssues <IMicrosoftGraphSecurityHealthIssue- []>]: Represents potential issues within a customer's Microsoft Defender for Identity configuration that Microsoft Defender for Identity identified related to the sensor.
    • [Id <String>]: The unique identifier for an entity. Read-only.
    • [AdditionalInformation <String- []>]: Contains additional information about the issue, such as a list of items to fix.
    • [CreatedDateTime <DateTime?>]: The date and time when the health issue was generated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
    • [Description <String>]: Contains more detailed information about the health issue.
    • [DisplayName <String>]: The display name of the health issue.
    • [DomainNames <String- []>]: A list of the fully qualified domain names of the domains or the sensors the health issue is related to.
    • [HealthIssueType <String>]: healthIssueType
    • [IssueTypeId <String>]: The type identifier of the health issue. For a list of all health issues and their identifiers, see Microsoft Defender for Identity health issues.
    • [LastModifiedDateTime <DateTime?>]: The date and time when the health issue was last updated. The timestamp type represents date and time information using ISO 8601 format and is always in UTC. For example, midnight UTC on Jan 1, 2014 is 2014-01-01T00:00:00Z.
    • [Recommendations <String- []>]: A list of recommended actions that can be taken to resolve the issue effectively and efficiently. These actions might include instructions for further investigation and aren't limited to prewritten responses.
    • [RecommendedActionCommands <String- []>]: A list of commands from the PowerShell module for the product that can be used to resolve the issue, if available. If no commands can be used to solve the issue, this property is empty. The commands, if present, provide a quick and efficient way to address the issue. These commands run in sequence for the single recommended fix.
    • [SensorDnsNames <String- []>]: A list of the DNS names of the sensors the health issue is related to.
    • [Severity <String>]: healthIssueSeverity
    • [Status <String>]: healthIssueStatus
  • [HealthStatus <String>]: sensorHealthStatus
  • [OpenHealthIssuesCount <Int64?>]: This field displays the count of health issues related to this sensor.
  • [SensorType <String>]: sensorType
  • [Settings <IMicrosoftGraphSecuritySensorSettings>]: sensorSettings
    • [(Any) <Object>]: This indicates any property can be added to this object.
    • [Description <String>]: Description of the sensor.
    • [DomainControllerDnsNames <String- []>]: DNS names for the domain controller
    • [IsDelayedDeploymentEnabled <Boolean?>]: Indicates whether to delay updates for the sensor.
    • [NetworkAdapters <IMicrosoftGraphSecurityNetworkAdapter- []>]:
      • [Id <String>]: The unique identifier for an entity. Read-only.
      • [IsEnabled <Boolean?>]: Indicates whether the network adapter is selected for capturing and analyzing network traffic.
      • [Name <String>]: The name of the network adapter.
  • [Version <String>]: The version of the sensor.

https://learn.microsoft.com/powershell/module/microsoft.graph.beta.security/update-mgbetasecurityidentity