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 语法。

语法

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

说明

新策略无效，无法应用，除非将保留规则添加到该策略中。

若要在安全性 & 合规性 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 Nakamura 的邮箱以及财务 SharePoint Online 网站创建名为“法规 123 符合性”的保留策略。

参数

-Comment

Comment 参数指定可选注释。如果您指定包含空格的值，为该值加上双引号(")，例如："这是管理员备注"。

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

Update 如果值包含空格或需要引号，请使用以下语法： "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

强制开关隐藏警告或确认消息。不必为此开关指定值。

您可以在以编程方式运行任务时使用此开关，因为此时并不适合提示用户提供管理输入。

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 添加所有网站。