通过

New-FeatureConfiguration

  • 参考
模块:
ExchangePowerShell
适用于:
Security & Compliance

此 cmdlet 仅在安全与合规中心 PowerShell 内可用。 有关更多信息，请参见 安全与合规中心 PowerShell。

注意

此 cmdlet 目前在公共预览版中可用，并非在所有组织中都可用，并且可能会发生更改。

使用 New-FeatureConfiguration cmdlet 在组织中创建Microsoft Purview 功能配置，包括：

  • 集合策略。
  • 基于标签的高级保护。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

New-FeatureConfiguration
   [-Name] <String>
   -Mode <PolicyMode>
   -FeatureScenario <PolicyScenario>
   -ScenarioConfig <String>
   [-Comment <String>]
   [-Confirm]
   [-Locations <String>]
   [-WhatIf]
   [<CommonParameters>]

说明

要在安全与合规中心 PowerShell 中使用此 cmdlet，必须分配权限。 有关详细信息，请参阅 安全性 & 合规性中的权限。

示例

示例 1

New-FeatureConfiguration -Name "Collection policy for supported Copilots" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText","DownloadText"],"EnforcementPlanes":["CopilotExperiences","Browser"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":true}' -Locations '[{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]},{"Workload":"Applications","Location":"49baeafd-1a6b-4c58-be55-75ae6d1dff6a","LocationSource":"PurviewConfig","LocationType":"Group","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]}]'

此示例创建一个名为“支持的 Copilots 的收集策略”的已启用的收集策略，该策略：

  • 包括所有支持的分类器的 UploadText & DownloadText 活动
  • 捕获所有 AI 提示
  • 包括Microsoft Copilot & Copilot 体验位置，这两个位置均限定为所有用户 & 组

示例 2

New-FeatureConfiguration -Name "Scoped browser collection policy for Microsoft Copilot" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText"],"EnforcementPlanes":["Browser"],"SensitiveTypeIds":["All"],"ExcludedSensitiveTypeIds":["50b8b56b-4ef8-44c2-a924-03374f5831ce","8548332d-6d71-41f8-97db-cc3b5fa544e6"],"IsIngestionEnabled":false}' -Locations '[{"Workload":"Applications","Location":"52655","LocationDisplayName":null,"LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}],"Exclusions":[{"Type":"Group","Identity":"db458ddb-4f56-4d88-a4f7-e29545560839","DisplayName":"Contoso Executives","Name":"Executives@contoso.com"}]}]'

此示例创建一个名为“Microsoft Copilot的范围浏览器收集策略”的已启用的收集策略，该策略：

  • 包括除“所有全名”和“所有物理地址”以外的所有受支持的分类器的 UploadText 活动
  • 包括Microsoft Copilot位置，适用于除“Contoso Executives 组”以外的所有用户 & 组

示例 3

New-FeatureConfiguration -Name "Scoped collection policies for browser and devices" -FeatureScenario KnowYourData -Mode Disable -ScenarioConfig '{"Activities":["UploadText","filecreated","filedeleted","filemodified"],"EnforcementPlanes":["Devices","Browser"],"SensitiveTypeIds":["a44669fe-0d48-453d-a9b1-2cc83f2cba77","cb353f78-2b72-4c3c-8827-92ebe4f69fdf"],"FileExtensions":["pdf"],"IsIngestionEnabled":false}' -Locations '[{"Workload":"EndpointDevices","Location":"","Inclusions":[{"Type":"Group","Identity":"db458ddb-4f56-4d88-a4f7-e29545560839","DisplayName":"All Company","Name":"allcompany@contoso.com"}],"Exclusions":[{"Type":"IndividualResource","Identity":"a828f25a-cede-4d0e-97e6-b0b0c913732a","DisplayName":"Alex Wilber","Name":"alex@contoso.com"}]},{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"IndividualResource","Identity":"84f9af2e-b224-4cb8-b9cd-bc531bb07a48","DisplayName":"Adele Vance","Name":"adele@contoso.com"}]}]'

此示例创建名为“浏览器和设备的范围收集策略”的禁用的收集策略，该策略：

  • 包括针对设备的浏览器) 和文件创建、filedeleted 和文件修改活动 (UploadText ()
  • 仅包括“美国社会安全号码 (SSN) ”和“ABA 路由号码”分类器
  • 仅检测文件扩展名为“pdf”的设备上的文件
  • 包括设备位置，范围限定为“所有公司”组，不包括用户“Alex Wilber”
  • 包括Microsoft Copilot位置，范围仅限于用户“Adele Vance”

参数

-Comment

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

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-Confirm

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

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-FeatureScenario

FeatureScenario 参数指定功能配置的方案。 目前，唯一有效的值为：

  • KnowYourData 集合策略的
  • TrustContainer 终结点 DLP 信任容器
类型:PolicyScenario
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-Locations

locations 参数指定功能配置的应用位置。

类型:String
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-Mode

Mode 参数指定功能配置模式。 有效值包含:

  • 启用：已启用功能配置。
  • 禁用：禁用功能配置。
类型:PolicyMode
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-Name

Name 参数指定功能配置的唯一名称。 最大长度为 64 个字符。 如果值中有空格，请使用双引号 (") 将此值括起来。

类型:String
Position:1
默认值:None
必需:True
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-ScenarioConfig

ScenarioConfig 参数指定有关功能配置的其他信息。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False
适用于:Security & Compliance

-WhatIf

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False
适用于:Security & Compliance