Set-ActivityAlert
此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。 如需詳細資訊，請參閱 安全 & 性合規性 PowerShell。
使用 Set-ActivityAlert Cmdlet 來修改Microsoft 365 Defender入口網站或Microsoft Purview 合規性入口網站中的活動警示。
如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。
Syntax
Set-ActivityAlert
[-Identity] <ComplianceRuleIdParameter>
[-Category <AlertRuleCategory>]
[-Condition <String>]
[-Confirm]
[-Description <String>]
[-Disabled <Boolean>]
[-EmailCulture <CultureInfo>]
[-Multiplier <Double>]
[-NotifyUser <MultiValuedProperty>]
[-Operation <MultiValuedProperty>]
[-RecordType <AuditRecordType>]
[-ScopeLevel <AlertScopeLevel>]
[-Severity <RuleSeverity>]
[-Threshold <Int32>]
[-TimeWindow <Int32>]
[-UserId <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Description
若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。 如需詳細資訊，請參閱Microsoft 365 Defender入口網站中的許可權或Microsoft Purview 合規性入口網站中的許可權。
範例
範例 1
$NU = Get-ActivityAlert "Contoso Elevation of Privilege"
$NU.NotifyUser.Add("chris@fabrikam.com")
Set-ActivityAlert "Contoso Elevation of Privilege" -NotifyUser $NU.NotifyUser本範例會將外部使用者 chris@fabrikam.com 新增至收件者清單中，該收件者會針對名為 Contoso 許可權提升的活動警示傳送電子郵件通知。
注意：若要從收件者清單中移除現有的電子郵件地址，請變更 NotifyUser.Add 至 NotifyUser.Remove 值。
範例 2
Set-ActivityAlert -Identity "External Sharing Alert" -Disabled $true本範例會停用名為「外部共用警訊」的現有活動警訊。
參數
-Category
Category 參數會指定活動警訊的類別。 有效值為：
- 無 (這是預設值)
- DataLossPrevention
- ThreatManagement
- DataGovernance
- AccessGovernance
- 其他人
| Type: | AlertRuleCategory |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Condition
Condition 參數會指定事件匯總的篩選準則。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Confirm
Confirm 參數會指定要顯示或隱藏確認提示。 這個參數對 Cmdlet 的影響取決於 Cmdlet 是否需要確認才能繼續作業。
- 例如，具破壞性的 Cmdlet (例如 Remove-* Cmdlet) 內建暫停，可強制您在繼續之前確認命令。 對於這些 Cmdlet，您可以使用以下確切語法來略過確認提示：
-Confirm:$false。 - 其他大部分的 Cmdlet (例如，New-* 和 Set-* Cmdlet) 沒有內建暫停。 在使用這些 Cmdlet 時，指定不含任何值的 Confirm 參數會引入強迫您認可命令後才繼續作業的暫停。
| Type: | SwitchParameter |
| Aliases: | cf |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Description
Description 參數會指定活動警訊的選用描述。 如果值包含空格，請使用引號 (") 括住值。
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Disabled
Disabled 參數會指定已啟用或已停用活動警訊。 有效值為：
- $true：活動警示已停用。
- $false：活動警示已啟用。 這是預設值。
| Type: | Boolean |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-EmailCulture
EmailCulture 參數會指定通知電子郵件訊息的語言。
此參數的有效輸入是Microsoft .NET Framework CultureInfo 類別支援的文化特性程式碼值。 例如，丹麥文為 da-DK 或日文為 ja-JP。 如需詳細資訊，請參閱 CultureInfo 類別。
| Type: | CultureInfo |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Identity
Identity 參數會指定要修改的活動警訊。 您可以使用任何可唯一識別活動警訊的值。 例如：
- 名稱
- 辨別名稱 (DN)
- GUID
| Type: | ComplianceRuleIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Multiplier
Multiplier 參數會指定觸發活動警示的事件數目。 這個參數的值表示來自基準值的乘數。
您只能在具有 Type 屬性值 AnomalousAggregation 的活動警示上使用此參數。
| Type: | Double |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-NotifyUser
NotifyUser 參數會指定收到通知電子郵件之收件者的電子郵件地址。 您可以指定內部和外部電子郵件地址。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。
若要修改現有的收件者清單，請參閱「範例」一節。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Operation
Operation 參數會指定觸發活動警示的活動。
此參數的有效值是可在 Microsoft 365 稽核記錄中取得的活動。 如需這些活動的描述，請參閱 稽核的活動。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。
如需您用來修改現有 Operations 值清單的語法，請參閱「範例」一節。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-RecordType
RecordType 參數會指定活動警訊的記錄類型標籤。 如需可用值的詳細資訊，請參閱 AuditLogRecordType。
當 Type 參數的值為 ElevationOfPrivilege 時，您不能使用此參數。
| Type: | AuditRecordType |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-ScopeLevel
ScopeLevel 參數會指定使用 Type 參數值 SimpleAggregation 或 AnomalousAggregation 的活動警示範圍。 有效值為：
- SingleUser (這是預設值)
- AllUsers
| Type: | AlertScopeLevel |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Severity
Severity 參數會指定活動警訊的嚴重性層級。 有效值為：
- 無
- 低 (這是預設值)
- 中
- 高
| Type: | RuleSeverity |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-Threshold
Threshold 參數會指定在 TimeWindow 參數所指定的時間間隔內觸發活動警訊的事件數目。 此參數的最小值為 3。
您只能在具有 Type 屬性值 SimpleAggregation 的活動警示上使用此參數。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-TimeWindow
TimeWindow 參數會指定 Threshold 參數所使用的時間範圍 (以分鐘為單位)。
您只能在具有 Type 屬性值 SimpleAggregation 的活動警示上使用此參數。
| Type: | Int32 |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-UserId
UserId 參數會指定您要監視的人員。
- 如果您指定使用者的電子郵件地址，您會在使用者執行指定的活動時收到電子郵件通知。 您可以指定以逗號隔開的多個電子郵件地址。
- 如果這個參數為空白 ($null)，當您組織中的任何使用者執行指定的活動時，您會收到電子郵件通知。
您可以輸入多個以逗號分隔的值。 如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。
您只能在具有 Type 屬性值 Custom 或 ElevationOfPrivilege 的活動警訊上使用此參數。
如需您用來修改現有 UserId 值清單的語法，請參閱「範例」一節。
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |
-WhatIf
WhatIf 參數無法在安全 & 性合規性 PowerShell 中運作。
| Type: | SwitchParameter |
| Aliases: | wi |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Security & Compliance |