New-AutoSensitivityLabelPolicy
此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息,请参见 安全与合规中心 PowerShell。
使用 New-AutoSensitivityLabelPolicy cmdlet 在组织中创建自动标记策略。 使用 New-AutoSensitivityLabelRule cmdlet 创建自动标记策略规则,并将其与策略关联以完成策略创建。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
Default (默认值)
New-AutoSensitivityLabelPolicy
[-Name] <String>
-ApplySensitivityLabel <String>
[-Comment <String>]
[-Confirm]
[-ExceptIfOneDriveSharedBy <RecipientIdParameter[]>]
[-ExceptIfOneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-ExchangeAdaptiveScopes <MultiValuedProperty>]
[-ExchangeAdaptiveScopesException <MultiValuedProperty>]
[-ExchangeLocation <MultiValuedProperty>]
[-ExchangeSender <SmtpAddress[]>]
[-ExchangeSenderException <SmtpAddress[]>]
[-ExchangeSenderMemberOf <SmtpAddress[]>]
[-ExchangeSenderMemberOfException <SmtpAddress[]>]
[-ExternalMailRightsManagementOwner <SmtpAddress>]
[-Force]
[-Locations <String>]
[-Mode <PolicyMode>]
[-OneDriveAdaptiveScopes <MultiValuedProperty>]
[-OneDriveAdaptiveScopesException <MultiValuedProperty>]
[-OneDriveLocation <MultiValuedProperty>]
[-OneDriveLocationException <MultiValuedProperty>]
[-OneDriveSharedBy <RecipientIdParameter[]>]
[-OneDriveSharedByMemberOf <RecipientIdParameter[]>]
[-OverwriteLabel <Boolean>]
[-PolicyRBACScopes <MultiValuedProperty>]
[-PolicyTemplateInfo <PswsHashtable>]
[-Priority <System.Int32>]
[-SharePointAdaptiveScopes <MultiValuedProperty>]
[-SharePointAdaptiveScopesException <MultiValuedProperty>]
[-SharePointLocation <MultiValuedProperty>]
[-SharePointLocationException <MultiValuedProperty>]
[-UnifiedAuditLogEnabled <Boolean>]
[-WhatIf]
[<CommonParameters>]
说明
要在安全与合规中心 PowerShell 中使用此 cmdlet,必须分配权限。 有关详细信息,请参阅 Microsoft Purview 合规门户中的权限。
示例
示例 1
New-AutoSensitivityLabelPolicy -Name "GlobalPolicy" -Comment "Primary policy" -SharePointLocation "https://my.url","https://my.url2" -OneDriveLocation "https://my.url3","https://my.url4" -Mode TestWithoutNotifications -ApplySensitivityLabel "Test"
此示例使用标签“Test”为指定的 SharePoint 和 OneDrive 位置创建名为 GlobalPolicy 的自动标记策略。 新策略具有描述性注释,并在模拟模式下创建。
参数
-ApplySensitivityLabel
适用:安全 & 合规性
ApplySensitivityLabel 参数指定要用于自动标记策略的标签。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Comment
适用:安全 & 合规性
Comment 参数指定可选注释。 如果您指定包含空格的值,为该值加上双引号("),例如:"这是管理员备注"。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:安全 & 合规性
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,指定不含值的 Confirm 开关会引入暂停,从而强制要求你先确认命令,然后再继续操作。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExceptIfOneDriveSharedBy
适用:安全 & 合规性
ExceptIfOneDriveSharedBy 参数指定要从策略中排除的用户, (OneDrive 用户帐户的网站包含在策略) 中。 可以通过 UPN (laura@contoso.onmicrosoft.com) 标识用户。
若要使用此参数,需要将 OneDrive 站点包含在策略中, (OneDriveLocation 参数值为 All,这是) 的默认值。
若要输入多个值,请使用以下语法:<value1>,<value2>,...<valueX>。 如果值中有空格或需要使用双引号,请使用以下语法:"<value1>","<value2>",..."<valueX>"。
不能将此参数与 OneDriveSharedBy 参数一起使用。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExceptIfOneDriveSharedByMemberOf
适用:安全 & 合规性
{{ Fill ExceptIfOneDriveSharedByMemberOf Description }}
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeAdaptiveScopes
适用:安全 & 合规性
{{ Fill ExchangeAdaptiveScopes Description }}
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeAdaptiveScopesException
适用:安全 & 合规性
{{ Fill ExchangeAdaptiveScopesException Description }}
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeLocation
适用:安全 & 合规性
ExchangeLocation 参数指定是否在策略中包含电子邮件。 此参数的有效值为 All。 如果不希望在策略中包含电子邮件,请不要使用此参数, (默认值为空白或$null) 。
可以在以下过程中使用此参数:
如果单独使用
-ExchangeLocation All,则策略将应用于所有内部用户的电子邮件。若要在策略中包含特定内部或外部用户的电子邮件,请在
-ExchangeLocation All同一命令中使用 ExchangeSender 参数。 策略中仅包含指定用户的电子邮件。若要在策略中仅包含特定组成员的电子邮件,请在
-ExchangeLocation All同一命令中使用 ExchangeSenderMemberOf 参数。 策略中仅包含指定组成员的电子邮件。若要从策略中排除特定内部用户的电子邮件,请在
-ExchangeLocation All同一命令中使用 ExchangeSenderException 参数。 仅从策略中排除指定用户的电子邮件。若要仅从策略中排除特定组成员的电子邮件,请在
-ExchangeLocation All同一命令中使用 ExchangeSenderMemberOfException 参数。 仅从策略中排除指定组成员的电子邮件。
不能在同一策略中指定包含项和排除项。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeSender
适用:安全 & 合规性
ExchangeSender 参数指定策略中包含其电子邮件的用户。 按电子邮件地址标识用户。 可以指定内部或外部电子邮件地址。
若要输入多个值,请使用以下语法:<value1>,<value2>,...<valueX>。 如果值中有空格或需要使用双引号,请使用以下语法:"<value1>","<value2>",..."<valueX>"。
必须将此参数与 ExchangeLocation 参数一起使用。
不能将此参数与 ExchangeSenderException 或 ExchangeSenderMemberOfException 参数一起使用。
参数属性
| 类型: | SmtpAddress[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeSenderException
适用:安全 & 合规性
ExchangeSenderException 参数指定从策略中排除其电子邮件的内部用户。 按电子邮件地址标识用户。
若要输入多个值,请使用以下语法:<value1>,<value2>,...<valueX>。 如果值中有空格或需要使用双引号,请使用以下语法:"<value1>","<value2>",..."<valueX>"。
必须将此参数与 ExchangeLocation 参数一起使用。
不能将此参数与 ExchangeSender 或 ExchangeSenderMemberOf 参数一起使用。
参数属性
| 类型: | SmtpAddress[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeSenderMemberOf
适用:安全 & 合规性
ExchangeSenderMemberOf 参数指定要包含在策略中的通讯组或启用邮件的安全组, (组成员的电子邮件包含在策略) 中。 按电子邮件地址标识组。
若要输入多个值,请使用以下语法:<value1>,<value2>,...<valueX>。 如果值中有空格或需要使用双引号,请使用以下语法:"<value1>","<value2>",..."<valueX>"。
必须将此参数与 ExchangeLocation 参数一起使用。
不能将此参数与 ExchangeSenderException 或 ExchangeSenderMemberOfException 参数一起使用。
不能使用此参数指定Microsoft 365 组。
参数属性
| 类型: | SmtpAddress[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExchangeSenderMemberOfException
适用:安全 & 合规性
ExchangeSenderMemberOfException 参数指定要从策略中排除的通讯组或启用邮件的安全组, (组成员的电子邮件将从策略) 中排除。 按电子邮件地址标识组。
若要输入多个值,请使用以下语法:<value1>,<value2>,...<valueX>。 如果值中有空格或需要使用双引号,请使用以下语法:"<value1>","<value2>",..."<valueX>"。
必须将此参数与 ExchangeLocation 参数一起使用。
不能将此参数与 ExchangeSender 或 ExchangeSenderMemberOf 参数一起使用。
不能使用此参数指定Microsoft 365 组。
参数属性
| 类型: | SmtpAddress[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExternalMailRightsManagementOwner
适用:安全 & 合规性
ExternalMailRightsManagementOwner 参数指定用户邮箱的电子邮件地址,该邮箱用于使用 RMS 加密来自外部发件人的传入电子邮件。
此参数仅适用于 Exchange 位置,并且策略必须应用具有加密作的标签。
参数属性
| 类型: | SmtpAddress |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Force
适用:安全 & 合规性
强制开关隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Locations
适用:安全 & 合规性
{{ 填充位置说明 }}
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Mode
适用:安全 & 合规性
Mode 参数指定自动标记策略的作和通知级别。 有效值包含:
- 启用:为作和通知启用策略。 此值为默认值。
- Enable:为操作和通知启用此策略。此为默认值。
- Disable:禁用此策略。
- TestWithNotifications:不执行任何操作,但发送通知。
参数属性
| 类型: | PolicyMode |
| 默认值: | None |
| 接受的值: | Enable, TestWithNotifications, TestWithoutNotifications, Disable, PendingDeletion |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Name
适用:安全 & 合规性
Name 参数指定自动标记策略的唯一名称。 如果值包含空格,请用引号将值括起来 (“) 。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 0 |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OneDriveAdaptiveScopes
适用:安全 & 合规性
{{ Fill OneDriveAdaptiveScopes Description }}
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OneDriveAdaptiveScopesException
适用:安全 & 合规性
{{ Fill OneDriveAdaptiveScopesException Description }}
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OneDriveLocation
适用:安全 & 合规性
OneDriveLocation 参数指定要包含在策略中的 OneDrive 站点。 可以按 URL 值标识网站,也可以使用值 All 添加所有网站。
Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OneDriveLocationException
适用:安全 & 合规性
此参数指定要在对 OneDriveLocation 参数使用值 All 时排除的 OneDrive 网站。 可以按 URL 值标识网站。
Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OneDriveSharedBy
适用:安全 & 合规性
OneDriveSharedBy 参数指定要包含在策略中的用户, (OneDrive 用户帐户的网站包含在策略) 中。 可以通过 UPN (laura@contoso.onmicrosoft.com) 标识用户。
若要使用此参数,需要将 OneDrive 站点包含在策略中, (OneDriveLocation 参数值为 All,这是) 的默认值。
若要输入多个值,请使用以下语法:<value1>,<value2>,...<valueX>。 如果值中有空格或需要使用双引号,请使用以下语法:"<value1>","<value2>",..."<valueX>"。
不能将此参数与 ExceptIfOneDriveSharedBy 参数一起使用。
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OneDriveSharedByMemberOf
适用:安全 & 合规性
{{ Fill OneDriveSharedByMemberOf Description }}
参数属性
| 类型: | RecipientIdParameter[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-OverwriteLabel
适用:安全 & 合规性
OverwriteLabel 参数指定是否覆盖手动标签。 有效值包含:
- $true:覆盖手动标签。
- $false:不要覆盖手动标签。 此值为默认值。
此参数仅适用于 Exchange 位置。
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PolicyRBACScopes
适用:安全 & 合规性
PolicyRBACScopes 参数指定要分配给策略的管理单元。 有效值是管理单元的 Microsoft Entra ObjectID (GUID 值) 。 可以指定用逗号分隔的多个值。
管理单元仅在 Microsoft Entra ID P1 或 P2 中可用。 在 Microsoft Graph PowerShell 中创建和管理管理单元。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-PolicyTemplateInfo
适用:安全 & 合规性
保留此参数以供 Microsoft 内部使用。
参数属性
| 类型: | PswsHashtable |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Priority
适用:安全 & 合规性
Priority 参数指定策略的优先级。 如果两个策略适用于文件,则最高优先级策略优先于低优先级策略。
参数属性
| 类型: | System.Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SharePointAdaptiveScopes
适用:安全 & 合规性
{{ Fill SharePointAdaptiveScopes Description }}
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SharePointAdaptiveScopesException
适用:安全 & 合规性
{{ Fill SharePointAdaptiveScopesException Description }}
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SharePointLocation
适用:安全 & 合规性
SharePointLocation 参数指定要包含在策略中的 SharePoint 网站。 可以按 URL 值标识网站,也可以使用值 All 添加所有网站。
Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。 在为 SharePoint 网站编制索引之前,无法将其添加到策略。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SharePointLocationException
适用:安全 & 合规性
此参数指定要在对 SharePointLocation 参数使用值 All 时排除的 SharePoint 网站。 可以按 URL 值标识网站。
Update 如果值中有空格或需要使用双引号,请使用以下语法:"Value1","Value2",..."ValueN"。
参数属性
| 类型: | MultiValuedProperty |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-UnifiedAuditLogEnabled
适用:安全 & 合规性
{{ Fill UnifiedAuditLogEnabled Description }}
参数属性
| 类型: | Boolean |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:安全 & 合规性
WhatIf 开关在安全与合规 PowerShell 中不起作用。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | 无线 |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。