你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Update-AzSentinelAlertRule

模块:

Az.SecurityInsights

汇报警报规则。

语法

Update-AzSentinelAlertRule
      -ResourceGroupName <String>
      -RuleId <String>
      -WorkspaceName <String>
      -Scheduled
      [-SubscriptionId <String>]
      [-AlertDescriptionFormat <String>]
      [-AlertDisplayNameFormat <String>]
      [-AlertRuleTemplateName <String>]
      [-AlertSeverityColumnName <String>]
      [-AlertTacticsColumnName <String>]
      [-CreateIncident]
      [-Description <String>]
      [-Disabled]
      [-DisplayName <String>]
      [-Enabled]
      [-EntityMapping <EntityMapping[]>]
      [-EventGroupingSettingAggregationKind <EventGroupingAggregationKind>]
      [-GroupByAlertDetail <AlertDetail[]>]
      [-GroupByCustomDetail <String[]>]
      [-GroupByEntity <EntityMappingType[]>]
      [-GroupingConfigurationEnabled]
      [-LookbackDuration <TimeSpan>]
      [-MatchingMethod <String>]
      [-Query <String>]
      [-QueryFrequency <TimeSpan>]
      [-QueryPeriod <TimeSpan>]
      [-ReOpenClosedIncident]
      [-Severity <AlertSeverity>]
      [-SuppressionDuration <TimeSpan>]
      [-SuppressionEnabled]
      [-Tactic <AttackTactic>]
      [-TriggerOperator <TriggerOperator>]
      [-TriggerThreshold <Int32>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -ResourceGroupName <String>
      -RuleId <String>
      -WorkspaceName <String>
      -FusionMLorTI
      [-SubscriptionId <String>]
      [-AlertRuleTemplateName <String>]
      [-Disabled]
      [-Enabled]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -ResourceGroupName <String>
      -RuleId <String>
      -WorkspaceName <String>
      -MicrosoftSecurityIncidentCreation
      [-SubscriptionId <String>]
      [-AlertRuleTemplateName <String>]
      [-Description <String>]
      [-Disabled]
      [-DisplayNamesExcludeFilter <String[]>]
      [-DisplayNamesFilter <String[]>]
      [-Enabled]
      [-ProductFilter <MicrosoftSecurityProductName>]
      [-SeveritiesFilter <AlertSeverity[]>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -ResourceGroupName <String>
      -RuleId <String>
      -WorkspaceName <String>
      -NRT
      [-SubscriptionId <String>]
      [-AlertDescriptionFormat <String>]
      [-AlertDisplayNameFormat <String>]
      [-AlertRuleTemplateName <String>]
      [-AlertSeverityColumnName <String>]
      [-AlertTacticsColumnName <String>]
      [-CreateIncident]
      [-Description <String>]
      [-Disabled]
      [-DisplayName <String>]
      [-Enabled]
      [-EntityMapping <EntityMapping[]>]
      [-GroupByAlertDetail <AlertDetail[]>]
      [-GroupByCustomDetail <String[]>]
      [-GroupByEntity <EntityMappingType[]>]
      [-GroupingConfigurationEnabled]
      [-LookbackDuration <TimeSpan>]
      [-MatchingMethod <String>]
      [-Query <String>]
      [-ReOpenClosedIncident]
      [-Severity <AlertSeverity>]
      [-SuppressionDuration <TimeSpan>]
      [-SuppressionEnabled]
      [-Tactic <AttackTactic>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -InputObject <ISecurityInsightsIdentity>
      -FusionMLorTI
      [-AlertRuleTemplateName <String>]
      [-Disabled]
      [-Enabled]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -InputObject <ISecurityInsightsIdentity>
      -MicrosoftSecurityIncidentCreation
      [-AlertRuleTemplateName <String>]
      [-Description <String>]
      [-Disabled]
      [-DisplayNamesExcludeFilter <String[]>]
      [-DisplayNamesFilter <String[]>]
      [-Enabled]
      [-ProductFilter <MicrosoftSecurityProductName>]
      [-SeveritiesFilter <AlertSeverity[]>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -InputObject <ISecurityInsightsIdentity>
      -NRT
      [-AlertDescriptionFormat <String>]
      [-AlertDisplayNameFormat <String>]
      [-AlertRuleTemplateName <String>]
      [-AlertSeverityColumnName <String>]
      [-AlertTacticsColumnName <String>]
      [-CreateIncident]
      [-Description <String>]
      [-Disabled]
      [-DisplayName <String>]
      [-Enabled]
      [-EntityMapping <EntityMapping[]>]
      [-GroupByAlertDetail <AlertDetail[]>]
      [-GroupByCustomDetail <String[]>]
      [-GroupByEntity <EntityMappingType[]>]
      [-GroupingConfigurationEnabled]
      [-LookbackDuration <TimeSpan>]
      [-MatchingMethod <String>]
      [-Query <String>]
      [-ReOpenClosedIncident]
      [-Severity <AlertSeverity>]
      [-SuppressionDuration <TimeSpan>]
      [-SuppressionEnabled]
      [-Tactic <AttackTactic>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

Update-AzSentinelAlertRule
      -InputObject <ISecurityInsightsIdentity>
      -Scheduled
      [-AlertDescriptionFormat <String>]
      [-AlertDisplayNameFormat <String>]
      [-AlertRuleTemplateName <String>]
      [-AlertSeverityColumnName <String>]
      [-AlertTacticsColumnName <String>]
      [-CreateIncident]
      [-Description <String>]
      [-Disabled]
      [-DisplayName <String>]
      [-Enabled]
      [-EntityMapping <EntityMapping[]>]
      [-EventGroupingSettingAggregationKind <EventGroupingAggregationKind>]
      [-GroupByAlertDetail <AlertDetail[]>]
      [-GroupByCustomDetail <String[]>]
      [-GroupByEntity <EntityMappingType[]>]
      [-GroupingConfigurationEnabled]
      [-LookbackDuration <TimeSpan>]
      [-MatchingMethod <String>]
      [-Query <String>]
      [-QueryFrequency <TimeSpan>]
      [-QueryPeriod <TimeSpan>]
      [-ReOpenClosedIncident]
      [-Severity <AlertSeverity>]
      [-SuppressionDuration <TimeSpan>]
      [-SuppressionEnabled]
      [-Tactic <AttackTactic>]
      [-TriggerOperator <TriggerOperator>]
      [-TriggerThreshold <Int32>]
      [-DefaultProfile <PSObject>]
      [-AsJob]
      [-NoWait]
      [-Confirm]
      [-WhatIf]
      [<CommonParameters>]

说明

汇报警报规则。

示例

示例 1：更新计划的警报规则

Update-AzSentinelAlertRule -ResourceGroupName "myResourceGroupName" -WorkspaceName "myWorkspaceName" -ruleId "4a21e485-75ae-48b3-a7b9-e6a92bcfe434" -Query "SecurityAlert | take 2"

此命令更新计划的警报规则

参数

-AlertDescriptionFormat

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

-AlertDisplayNameFormat

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

-AlertRuleTemplateName

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

-AlertSeverityColumnName

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

-AlertTacticsColumnName

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

-AsJob

以作业身份运行命令

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

-Confirm

提示你在运行 cmdlet 之前进行确认。

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

-CreateIncident

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

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

Type:	PSObject
Aliases:	AzureRMContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Description

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

-Disabled

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

-DisplayName

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

-DisplayNamesExcludeFilter

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

-DisplayNamesFilter

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

-Enabled

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

-EntityMapping

“Account”、“Host”、“IP”、“Malware”、“File”、“Process”、“CloudApplication”、“DNS”、“AzureResource”、“FileHash”、“RegistryKey”、“RegistryValue”、“SecurityGroup”、“URL”、“Mailbox”、“MailCluster”、“MailMessage”、“SubmissionMail”，请参阅 ENTITYMAPPING 属性的 NOTES 部分并创建哈希表。

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

-EventGroupingSettingAggregationKind

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

-FusionMLorTI

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

-GroupByAlertDetail

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

-GroupByCustomDetail

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

-GroupByEntity

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

-GroupingConfigurationEnabled

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

-InputObject

要构造的标识参数，请参阅 INPUTOBJECT 属性的 NOTES 部分并创建哈希表。

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

-LookbackDuration

Type:	TimeSpan
Position:	Named
Default value:	New-TimeSpan -Hours 5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-MatchingMethod

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

-MicrosoftSecurityIncidentCreation

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

-NoWait

异步运行命令

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

-NRT

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

-ProductFilter

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

-Query

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

-QueryFrequency

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

-QueryPeriod

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

-ReOpenClosedIncident

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

-ResourceGroupName

资源组名称。

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

-RuleId

[Alias（'RuleId'）]Operational Insights 资源提供程序的名称。

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

-Scheduled

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

-SeveritiesFilter

高、中、低、信息性

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

-Severity

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

-SubscriptionId

获取唯一标识 Microsoft Azure 订阅的订阅凭据。 此订阅 ID 是每个服务调用的 URI 的一部分。

Type:	String
Position:	Named
Default value:	(Get-AzContext).Subscription.Id
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SuppressionDuration

Type:	TimeSpan
Position:	Named
Default value:	New-TimeSpan -Hours 5
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SuppressionEnabled

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

-Tactic

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

-TriggerOperator

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

-TriggerThreshold

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

-WhatIf

显示运行该 cmdlet 时会发生什么情况。 cmdlet 未运行。

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

-WorkspaceName

工作区的名称。

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

输入

ISecurityInsightsIdentity

输出

AlertRule

备注

别名

复杂参数属性

若要创建下面所述的参数，请构造一个包含相应属性的哈希表。 有关哈希表的信息，请运行 Get-Help about_Hash_Tables。

ENTITYMAPPING <EntityMapping[]>：“Account”、“Host”、“IP”、“Malware”、“File”、“Process”、“CloudApplication”、“DNS”、“AzureResource”、“FileHash”、“RegistryKey”、“RegistryValue”、“SecurityGroup”、“URL”、“Mailbox”、“MailCluster”、“MailMessage”、“SubmissionMail”

• [EntityType <EntityMappingType?>]：映射实体的 V3 类型
• [FieldMapping <IFieldMapping[]>]：给定实体映射的字段映射数组
  • [ColumnName <String>]：要映射到标识符的列名
  • [Identifier <String>]：实体的 V3 标识符

INPUTOBJECT <ISecurityInsightsIdentity>：标识参数

• [ActionId <String>]：操作 ID
• [AlertRuleTemplateId <String>]：警报规则模板 ID
• [AutomationRuleId <String>]：自动化规则 ID
• [BookmarkId <String>]：书签 ID
• [ConsentId <String>]：同意 ID
• [DataConnectorId <String>]：连接or ID
• [EntityId <String>]：实体 ID
• [EntityQueryId <String>]：实体查询 ID
• [EntityQueryTemplateId <String>]：实体查询模板 ID
• [Id <String>]：资源标识路径
• [IncidentCommentId <String>]：事件注释 ID
• [IncidentId <String>]：事件 ID
• [MetadataName <String>]：元数据名称。
• [Name <String>]：威胁情报指示器名称字段。
• [RelationName <String>]：关系名称
• [ResourceGroupName <String>]：资源组的名称。 此名称不区分大小写。
• [RuleId <String>]：警报规则 ID
• [SentinelOnboardingStateName <String>]：Sentinel 载入状态名称。 支持 - 默认值
• [SettingsName <String>]：设置名称。 支持 - 异常、EyesOn、EntityAnalytics、Ueba
• [SourceControlId <String>]：源代码管理 ID
• [SubscriptionId <String>]：目标订阅的 ID。
• [WorkspaceName <String>]：工作区的名称。