New-HoldCompliancePolicy

參考

模組:: ExchangePowerShell

適用於:: Security & Compliance

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

使用 New-HoldCompliancePolicy Cmdlet 在Microsoft Purview 合規性入口網站中建立新的保留原則。

注意：New-HoldCompliancePolicy Cmdlet 已由 New-RetentionCompliancePolicy Cmdlet 取代。如果您有使用 New-HoldCompliancePolicy 的腳本，請將其更新為使用 New-RetentionCompliancePolicy。

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

Syntax

New-HoldCompliancePolicy
   [-Name] <String>
   [-Comment <String>]
   [-Confirm]
   [-Enabled <Boolean>]
   [-ExchangeLocation <MultiValuedProperty>]
   [-Force]
   [-PublicFolderLocation <MultiValuedProperty>]
   [-SharePointLocation <MultiValuedProperty>]
   [-WhatIf]
   [<CommonParameters>]

Description

新的原則無效，在將保留規則新增至原則之前將不會套用。

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

範例

範例 1

New-HoldCompliancePolicy -Name "Regulation 123 Compliance" -ExchangeLocation "Kitty Petersen", "Scott Nakamura" -SharePointLocation "https://contoso.sharepoint.com/sites/teams/finance"

此範例會針對 Kitty Petersen 和 Scott Quantum 來的信箱，以及 Finance SharePoint Online 網站，建立名為「法規 123 合規性」的保留原則。

參數

-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

-Enabled

Enabled 參數會指定已啟用或已停用原則。有效值為：

$true：已啟用原則。這是預設值。
$true：已啟用原則。此為預設值。

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

-ExchangeLocation

ExchangeLocation 參數會指定要包含在原則中的信箱。有效值為：

ExchangeLocation 參數會指定要包含在原則中的信箱。有效值為：
信箱

所有信箱的 All 值。您只能使用這個值本身。

名稱
名稱
辨別名稱 (DN)
GUID

您可以輸入多個以逗號分隔的值。如果值包含空格或需要引號，請使用下列語法： "Value1","Value2",..."ValueN" 。

若未指定任何信箱，則沒有信箱會處於保留狀態。

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

-Force

Force 參數會隱藏警告或確認訊息。您不需要使用此參數指定值。

在不適合提示系統管理員輸入的場合中，您可以使用此參數來利用程式設計方式執行工作。

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

-Name

Name 參數會指定保留原則的唯一名稱。如果值包含空格，請使用引號括住值。

Type:	String
Position:	1
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Security & Compliance

-PublicFolderLocation

PublicFolderLocation 參數會指定您想要在保留原則中包含所有公用資料夾。您可對此參數使用 All 值。

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

-SharePointLocation

SharePointLocation 參數會指定要包含的 SharePoint Online 網站。您依據其 URL 值識別網站，或者您可以使用 All 值以包含所有網站。