New-CaseHoldPolicy

參考

模組:: ExchangePowerShell

適用於:: Security & Compliance

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

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

使用 New-CaseHoldPolicy Cmdlet 來建立案例保留原則之後，您需要使用 New-CaseHoldRule Cmdlet，建立案例保留規則，並且將規則指派給原則。如果您未針對原則建立規則，就不會建立保留，也不會保留內容位置。

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

Syntax

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

Description

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

範例

範例 1

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

此範例會為 Kitty Petersen 和 Scott 的信箱建立名為「法規 123 合規性」的案例保存原則，並針對名為「123 合規性案例」的電子檔探索案例建立財務 SharePoint Online 網站。

請記住，在建立原則之後，您需要使用 New-CaseHoldRule Cmdlet 為原則建立規則。

參數

-Case

Case 參數會指定您想與案例保留原則關聯的 eDiscovery 案例。您可以使用下列值來識別 eDiscovery 案例︰

名稱
識別碼 (GUID 值)。

您可以執行此命令來尋找這些值：Get-ComplianceCase | Format-Table -Auto Name,Status,Identity。

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

-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 參數會指定要包含在原則中的信箱。有效值為：
信箱

若要指定信箱或通訊群組，您可以使用下列值：

名稱
SMTP 位址。若要指定非作用中信箱，請在位址前面加上句號 (.) 。
Azure AD ObjectId。使用 Microsoft Graph PowerShell 中的 Get-MgUser 或 Get-MgGroup Cmdlet 來尋找此值。

您可以輸入多個以逗號分隔的值。如果值包含空格或需要引號，請使用下列語法： "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 和商務用 OneDrive網站。您可以依網站的 URL 值來識別網站。