Set-HoldComplianceRule

參考

模組:: ExchangePowerShell

適用於:: Security & Compliance

此 Cmdlet 僅適用于安全 & 性合規性 PowerShell。如需詳細資訊，請參閱安全 & 性合規性 PowerShell。

使用 Set-HoldComplianceRule Cmdlet 來修改Microsoft Purview 合規性入口網站中的現有保留規則。

注意：Set-HoldComplianceRule Cmdlet 已由 Set-RetentionComplianceRule Cmdlet 取代。如果您有使用 Set-HoldComplianceRule 的腳本，請將它們更新為使用 Set-RetentionComplianceRule。

如需下方＜語法＞一節中參數集的詳細資訊，請參閱 Exchange Cmdlet 語法。

Syntax

Set-HoldComplianceRule
   [-Identity] <ComplianceRuleIdParameter>
   [-Comment <String>]
   [-Confirm]
   [-ContentDateFrom <DateTime>]
   [-ContentDateTo <DateTime>]
   [-ContentMatchQuery <String>]
   [-Disabled <Boolean>]
   [-HoldContent <Unlimited>]
   [-HoldDurationDisplayHint <HoldDurationHint>]
   [-WhatIf]
   [<CommonParameters>]

Description

若要在安全 & 性合規性 PowerShell 中使用此 Cmdlet，您必須獲指派許可權。如需詳細資訊，請參閱 Microsoft Purview 合規性入口網站中的權限。

範例

範例 1

Set-HoldComplianceRule -Identity "Internal Company Rule" -HoldContent 180

此範例會變更名為 "Internal Company Rule" 之現有保留規則的保留期間。

參數

-Comment

Comment 參數會指定選擇性註解。如果指定的值含有空格，則必須以雙引號 (") 括住值，例如︰"This is an admin note"。

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

-ContentDateFrom

ContentDateFrom 參數會指定要納入之內容的日期範圍的開始日期。

在您要執行命令的電腦上，使用該電腦的 [地區選項] 設定中定義的簡短日期格式。例如，如果電腦設定成使用簡短日期格式 mm/dd/yyyy，請輸入 09/01/2018 以指定 2018 年 9 月 1 日。您可以只輸入日期，或者也可以輸入日期和時間。如果輸入日期和時間，請使用引號 (") 括住值，例如 "09/01/2018 5:00 PM"。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ContentDateTo

ContentDateTo 參數會指定要納入之內容的日期範圍的結束日期。

Type:	DateTime
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-ContentMatchQuery

ContentMatchQuery 參數會指定內容搜尋篩選器。

此參數使用利用關鍵字查詢語言 (KQL) 格式化的文字搜尋字串或查詢。如需詳細資訊，請參閱關鍵字查詢語言 (KQL) 語法參考和 eDiscovery 的關鍵字查詢和搜尋條件。

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。預設值為 $false。

Type:	Boolean
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-HoldContent

HoldContent 參數會指定保留規則的保留期間。有效值為：

整數：保留期間以天為單位。
無限制：內容會無限期保留。

Type:	Unlimited
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-HoldDurationDisplayHint

HoldDurationDisplayHint 參數會指定用來在Microsoft Purview 合規性入口網站中顯示保留期間的單位。有效值為 Days、Months 或 Years。

例如，如果此參數設定為值 Years，而且 HoldContent 參數設定為值 365，則Microsoft Purview 合規性入口網站會顯示 1 年作為內容保留期間。

Type:	HoldDurationHint
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

-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