You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: exchange/exchange-ps/exchange/New-FeatureConfiguration.md
+39-11Lines changed: 39 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -9,11 +9,13 @@ schema: 2.0.0
9
9
# New-FeatureConfiguration
10
10
11
11
## SYNOPSIS
12
-
**Note**: Currently, this cmdlet is available only in Private Preview.
12
+
**Note**: This cmdlet is available in Public Preview.
13
13
14
14
This cmdlet is available only in Security & Compliance PowerShell. For more information, see [Security & Compliance PowerShell](https://learn.microsoft.com/powershell/exchange/scc-powershell).
15
15
16
-
Use the New-FeatureConfiguration cmdlet to create Discovery policies.
16
+
Use the New-FeatureConfiguration cmdlet to create Microsoft Purview feature configurations within your organization, including:
17
+
- Collection policies
18
+
- Endpoint DLP trust container
17
19
18
20
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
19
21
@@ -37,15 +39,39 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned
This example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types.
45
+
This example creates an enabled collection policy named "Collection policy for supported Copilots" that:
46
+
- Includes UploadText & DownloadText activity for all supported classifiers
47
+
- Captures all AI prompts
48
+
- Includes Microsoft Copilot & Copilot Experiences locations, both scoped to all users & groups
49
+
50
+
### Example 2
51
+
```powershell
52
+
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"}]}]'
53
+
```
54
+
55
+
This example creates an enabled collection policy named "Scoped browser collection policy for Microsoft Copilot" that:
56
+
- Includes UploadText activity for all supported classifiers except "All Full Names" and "All Physical Addresses"
57
+
- Includes Microsoft Copilot location, for all users & groups except the "Contoso Executives Group"
58
+
59
+
### Example 3
60
+
```powershell
61
+
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"}]}]'
62
+
```
63
+
64
+
This example creates a disabled collection policy named "Scoped collection policies for browser and devices" that:
65
+
- Includes UploadText (for browser) and filecreated, filedeleted, and filemodified activities (for devices)
66
+
- Includes "U.S. Social Security Number (SSN)" and "ABA Routing Number" classifiers only
67
+
- Detects files on devices with "pdf" file extension only
68
+
- Includes devices location, scoped to the "All company" group, excluding the user "Alex Wilber"
69
+
- Includes Microsoft Copilot location, scoped only to the user "Adele Vance"
44
70
45
71
## PARAMETERS
46
72
47
73
### -Name
48
-
The Name parameter specifies the unique name for the Discovery policy. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").
74
+
The Name parameter specifies the unique name for the feature configuration. The maximum length is 64 characters. If the value contains spaces, enclose the value in quotation marks (").
0 commit comments