New-RetentionCompliancePolicy

语法

Default

New-RetentionCompliancePolicy
    [-Name] <String>
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-ExchangeLocation <MultiValuedProperty>]
    [-ExchangeLocationException <MultiValuedProperty>]
    [-Force]
    [-IsSimulation]
    [-ModernGroupLocation <MultiValuedProperty>]
    [-ModernGroupLocationException <MultiValuedProperty>]
    [-OneDriveLocation <MultiValuedProperty>]
    [-OneDriveLocationException <MultiValuedProperty>]
    [-PolicyRBACScopes <MultiValuedProperty>]
    [-PolicyTemplateInfo <PswsHashtable>]
    [-PriorityCleanup]
    [-PublicFolderLocation <MultiValuedProperty>]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SharePointLocation <MultiValuedProperty>]
    [-SharePointLocationException <MultiValuedProperty>]
    [-SkipPriorityCleanupConfirmation]
    [-SkypeLocation <MultiValuedProperty>]
    [-SkypeLocationException <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

TeamLocation

New-RetentionCompliancePolicy
    [-Name] <String>
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-Force]
    [-IsSimulation]
    [-PriorityCleanup]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SkipPriorityCleanupConfirmation]
    [-TeamsChannelLocation <MultiValuedProperty>]
    [-TeamsChannelLocationException <MultiValuedProperty>]
    [-TeamsChatLocation <MultiValuedProperty>]
    [-TeamsChatLocationException <MultiValuedProperty>]
    [-WhatIf]
    [<CommonParameters>]

AdaptiveScopeLocation

New-RetentionCompliancePolicy
    [-Name] <String>
    -AdaptiveScopeLocation <MultiValuedProperty>
    [-Applications <MultiValuedProperty>]
    [-Comment <String>]
    [-Confirm]
    [-Enabled <Boolean>]
    [-Force]
    [-IsSimulation]
    [-PriorityCleanup]
    [-RestrictiveRetention <Boolean>]
    [-RetainCloudAttachment <Boolean>]
    [-SkipPriorityCleanupConfirmation]
    [-WhatIf]
    [<CommonParameters>]

说明

示例

示例 1

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

示例 2

New-RetentionCompliancePolicy -Name "Marketing Department" -Enabled $true -SharePointLocation https://contoso.sharepoint.com -RetainCloudAttachment $true -Comment "Regulatory compliance for Marketing Dept."

参数

-AdaptiveScopeLocation

适用：安全 & 合规性

AdaptiveScopeLocation 参数指定要包含在策略中的自适应范围位置。 使用 New-AdaptiveScope cmdlet 创建自适应范围。 可以使用唯一标识自适应范围的任何值。 例如：

• 名称
• 可分辨名称 (DN)
• GUID

参数属性

参数集

-Applications

适用：安全 & 合规性

应用程序参数指定在策略中包含Microsoft 365 组时的目标， (将 ModernGroups 参数设置为) 。 有效值包含:

• Group:Exchange 用于连接到 Microsoft 365 组的邮箱。
• Group:SharePoint 用于连接到 Microsoft 365 组的 SharePoint 网站。
• "Group:Exchange,SharePoint" 用于连接到 Microsoft 365 组的邮箱和 SharePoint 网站。
• 空白 ($null) ：此值是默认值，在功能上等效于值 "Group:Exchange,SharePoint"。

参数属性

参数集

-Comment

适用：安全 & 合规性

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

参数属性

参数集

-Confirm

适用：安全 & 合规性

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

• 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
• 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。

参数属性

参数集

-Enabled

适用：安全 & 合规性

Enabled 参数指定启用还是禁用策略。 有效值包含:

• $true：已启用策略。 此值为默认值。
• $true：启用此策略。此为默认值。

参数属性

参数集

-ExchangeLocation

适用：安全 & 合规性

ExchangeLocation 参数指定要包含在策略中的邮箱。 有效值包含:

• ExchangeLocation 参数指定了要添加到策略中的邮箱。有效值为：
• 邮箱
• 所有邮箱的值 All。 您只能自行使用此值。

所有邮箱的值 All。 只能使用此值本身。

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

如果未指定任何邮箱，则不会将任何邮箱置于保留状态。

参数属性

参数集

-ExchangeLocationException

适用：安全 & 合规性

当对 ExchangeLocation 参数使用值 All 时，ExchangeLocationException 参数指定要从策略中排除的邮箱。 有效值包含:

• 此参数指定了在对 ExchangeLocation 参数使用值 All 时要从已排除邮箱列表中删除的邮箱。有效值为：
• 邮箱

所有邮箱的值 All。 只能使用此值本身。

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-Force

适用：安全 & 合规性

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

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

参数属性

参数集

-IsSimulation

适用：安全 & 合规性

IsSimulation 开关指定在模拟模式下创建策略。 不必为此开关指定值。

有关模拟模式的信息，请参阅 了解模拟模式。

参数属性

参数集

-ModernGroupLocation

适用：安全 & 合规性

ModernGroupLocation 参数指定要包含在策略中的Microsoft 365 组。 有效值包含:

• Microsoft 365 组
• 值 All 表示所有Microsoft 365 组。 您只能自行使用此值。

若要标识 Microsoft 365 组，可以使用唯一标识它的任何值。 例如：

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-ModernGroupLocationException

适用：安全 & 合规性

ModernGroupLocationException 参数指定要在对 ModernGroupLocation 参数使用值 All 时从策略中排除Microsoft 365 组。

可以使用唯一标识 Microsoft 365 组的任何值。 例如：

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-Name

适用：安全 & 合规性

Name 参数指定保留策略的唯一名称。 如果值包含空格，则使用引号括住该值。

参数属性

参数集

-OneDriveLocation

适用：安全 & 合规性

OneDriveLocation 参数指定要包含的 OneDrive 网站。 可以按 URL 值标识网站，也可以使用值 All 添加所有网站。

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-OneDriveLocationException

适用：安全 & 合规性

此参数指定要在对 OneDriveLocation 参数使用值 All 时排除的 OneDrive 网站。 可以按 URL 值标识网站。

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-PolicyRBACScopes

适用：安全 & 合规性

注意：当前不支持管理员单位，因此此参数不起作用。 此处提供的信息用于发布对管理单元的支持时的信息。

PolicyRBACScopes 参数指定要分配给策略的管理单元。 有效值是管理单元的 Microsoft Entra ObjectID (GUID 值) 。 可以指定用逗号分隔的多个值。

管理单元仅在 Microsoft Entra ID P1 或 P2 中可用。 在 Microsoft Graph PowerShell 中创建和管理管理单元。

参数属性

参数集

-PolicyTemplateInfo

适用：安全 & 合规性

保留此参数以供 Microsoft 内部使用。

参数属性

参数集

-PriorityCleanup

适用：安全 & 合规性

PriorityCleanup 开关指定是否创建优先级清理策略。 不必为此开关指定值。

优先级清理策略通过重写任何现有保留设置或电子数据展示保留来加速敏感内容的删除。 有关详细信息，请参阅 优先级清理。

参数属性

参数集

-PublicFolderLocation

适用：安全 & 合规性

PublicFolderLocation 参数指定要在保留策略中包含所有公用文件夹。 可以对此参数使用值 All。

参数属性

参数集

-RestrictiveRetention

适用：安全 & 合规性

限制性Retention 参数指定是否为策略启用保留锁。 有效值包含:

• $true：为策略启用保留锁。 任何人（包括管理员）都无法关闭策略或降低其限制。
• $false：未为策略启用保留锁定。 此值为默认值。

锁定策略后，任何人都无法关闭或禁用它，或从策略中删除内容。 并且无法在保留期内修改或删除受策略约束的内容。 你只能通过向策略添加内容或延长其持续时间的方式来修改保留策略。 可以增加或扩展锁定策略，但不能减少、禁用或关闭锁定策略。

因此，在锁定保留策略之前，必须了解组织的合规性要求，并且不要锁定策略，直到你确定它符合你的需求。

参数属性

参数集

-RetainCloudAttachment

适用：安全 & 合规性

注意：此参数目前为预览版，并非在所有组织中都可用，并且可能会发生更改。

RetainCloudAttachment 参数指定这是云附件策略。 有效值包含:

• $true：该策略是云附件策略。
• $false：该策略不是云附件策略。 此值为默认值。

对于值$true，只能使用以下位置参数：

• SharePointLocation 和 SharePointLocationException
• OneDriveLocation 和 OneDriveLocationException
• ModernGroupLocation 和 ModernGroupLocationException

使用云附件策略创建规则的标记可以是记录标签或法规标签。 不能使用云附件策略的发布标记来创建规则;仅支持应用标记。

retainCloudAttachment 参数在 Set-RetentionCompliancePolicy cmdlet 上不可用。

参数属性

参数集

-SharePointLocation

适用：安全 & 合规性

SharePointLocation 参数指定要包含的 SharePoint 网站。 可以按 URL 值标识网站，也可以使用值 All 添加所有网站。

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

在为 SharePoint 网站编制索引之前，无法将其添加到策略。 如果未指定任何网站，则不会将任何网站置于保留状态。

参数属性

参数集

-SharePointLocationException

适用：安全 & 合规性

此参数指定要在对 SharePointLocation 参数使用值 All 时排除的 SharePoint 网站。 可以按 URL 值标识网站。

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-SkipPriorityCleanupConfirmation

适用：安全 & 合规性

{{ Fill SkipPriorityCleanupConfirmation Description }}

参数属性

参数集

-SkypeLocation

适用：安全 & 合规性

SkypeLocation 参数指定要包含在策略中的Skype for Business Online 用户。

可以使用任何能够唯一标识该用户的值。 例如：

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-SkypeLocationException

适用：安全 & 合规性

保留此参数以供 Microsoft 内部使用。

参数属性

参数集

-TeamsChannelLocation

适用：安全 & 合规性

TeamsChannelLocation 参数指定要包含在策略中的 Teams。

可以使用唯一标识团队的任何值。 例如：

• 名称
• 电子邮件地址
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-TeamsChannelLocationException

适用：安全 & 合规性

TeamsChannelLocationException 参数指定要在 TeamsChannelLocation 参数使用值 All 时排除的 Teams。 可以使用唯一标识团队的任何值。 例如：

• 名称
• 电子邮件地址
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-TeamsChatLocation

适用：安全 & 合规性

TeamsChatLocation 参数指定要包含在策略中的 Teams 用户。

可以使用任何能够唯一标识该用户的值。 例如：

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-TeamsChatLocationException

适用：安全 & 合规性

TeamsChatLocationException 参数指定要在对 TeamsChatLocation 参数使用值 All 时排除的 Teams 用户。 可以使用任何能够唯一标识该用户的值。 例如：

• 名称
• 名称
• 可分辨名称 (DN)
• GUID

Update 如果值中有空格或需要使用双引号，请使用以下语法："Value1","Value2",..."ValueN"。

参数属性

参数集

-WhatIf

适用：安全 & 合规性

WhatIf 开关在安全与合规 PowerShell 中不起作用。

参数属性

参数集

CommonParameters