Skip to content

Commit d1e4c19

Browse files
authored
Update New-FeatureConfiguration.md
1 parent c3a57d6 commit d1e4c19

File tree

1 file changed

+40
-12
lines changed

1 file changed

+40
-12
lines changed

exchange/exchange-ps/exchange/New-FeatureConfiguration.md

+40-12
Original file line numberDiff line numberDiff line change
@@ -9,18 +9,20 @@ schema: 2.0.0
99
# New-FeatureConfiguration
1010

1111
## SYNOPSIS
12-
**Note**: Currently, this cmdlet is available only in Private Preview.
12+
**Note**: This cmdlet is available in Public Preview.
1313

1414
This cmdlet is available only in Security & Compliance PowerShell. For more information, see [Security & Compliance PowerShell](https://learn.microsoft.com/powershell/exchange/scc-powershell).
1515

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
1719

1820
For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).
1921

2022
## SYNTAX
2123

2224
```
23-
New-FeatureConfiguration [-Name] <String> -Mode <Microsoft.Office.CompliancePolicy.Tasks.PolicyMode> -FeatureScenario <Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario> -ScenarioConfig <String>
25+
New-FeatureConfiguration -Name <String> -Mode <Microsoft.Office.CompliancePolicy.Tasks.PolicyMode> -FeatureScenario <Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario> -ScenarioConfig <String>
2426
[-Comment <String>]
2527
[-Confirm]
2628
[-Locations <String>]
@@ -35,15 +37,39 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned
3537

3638
### Example 1
3739
```powershell
38-
New-FeatureConfiguration -Name "Discovery policy for Contoso executives" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities": ["UploadText", "UploadFile"], "EnforcementPlanes": ["Browser"], "SensitiveTypeIds": ["a44669fe-0d48-453d-a9b1-2cc83f2cba77","50842eb7-edc8-4019-85dd-5a5c1f2bb085"]}' –Locations '[{"Workload": "Applications","Location": "51622","Inclusions": [{"Type": "Group","Identity": "[email protected]"}]},{"Workload": "Applications","Location": "51399","Inclusions": [{"Type": "Group","Identity": "[email protected]"}]},{"Workload": "Applications","Location": "51279","Inclusions": [{"Type": "Group","Identity": "[email protected]"}]}]'
40+
New-FeatureConfiguration -Name "Browser collection policy for Microsoft Copilot" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText"],"EnforcementPlanes":["Browser"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":true}' –Locations '[{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]}]'
3941
```
4042

41-
This example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types.
43+
This example creates an enabled collection policy named "Browser collection policy for Microsoft Copilot" that:
44+
- Includes UploadText activity for all supported classifiers
45+
- Captures all AI prompts
46+
- Includes Microsoft Copilot location, for all users & groups
47+
48+
### Example 2
49+
```powershell
50+
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":"[email protected]"}]}]'
51+
```
52+
53+
This example creates an enabled collection policy named "Scoped browser collection policy for Microsoft Copilot" that:
54+
- Includes UploadText activity for all supported classifiers except "All Full Names" and "All Physical Addresses"
55+
- Includes Microsoft Copilot location, for all users & groups except the "Contoso Executives Group"
56+
57+
### Example 3
58+
```powershell
59+
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":"[email protected]"}],"Exclusions":[{"Type":"IndividualResource","Identity":"a828f25a-cede-4d0e-97e6-b0b0c913732a","DisplayName":"Alex Wilber","Name":"[email protected]"}]},{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"IndividualResource","Identity":"84f9af2e-b224-4cb8-b9cd-bc531bb07a48","DisplayName":"Adele Vance","Name":"[email protected]"}]}]'
60+
```
61+
62+
This example creates a disabled collection policy named "Scoped collection policies for browser and devices" that:
63+
- Includes UploadText (for browser) and filecreated, filedeleted, and filemodified activities (for devices)
64+
- Includes "U.S. Social Security Number (SSN)" and "ABA Routing Number" classifiers only
65+
- Detects files on devices with "pdf" file extension only
66+
- Includes devices location, scoped to the "All company" group, excluding the user "Alex Wilber"
67+
- Includes Microsoft Copilot location, scoped only to the user "Adele Vance"
4268

4369
## PARAMETERS
4470

4571
### -Name
46-
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 (").
72+
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 (").
4773

4874
```yaml
4975
Type: String
@@ -59,7 +85,9 @@ Accept wildcard characters: False
5985
```
6086
6187
### -FeatureScenario
62-
The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData.
88+
The FeatureScenario parameter specifies the scenario for the feature configuration. Currently, the only valid values are:
89+
- `KnowYourData` for collection policies
90+
- `TrustContainer` for Endpoint DLP trust container
6391

6492
```yaml
6593
Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario
@@ -75,10 +103,10 @@ Accept wildcard characters: False
75103
```
76104

77105
### -Mode
78-
The Mode parameter specifies the action and notification level of the Discovery policy. Valid values are:
106+
The Mode parameter specifies feature configuration mode. Valid values are:
79107

80-
- Enable: The policy is enabled for actions and notifications. This is the default value.
81-
- Disable: The policy is disabled.
108+
- Enable: The feature configuration is enabled.
109+
- Disable: The feature configuration is disabled.
82110

83111
```yaml
84112
Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode
@@ -94,7 +122,7 @@ Accept wildcard characters: False
94122
```
95123

96124
### -ScenarioConfig
97-
The ScenarioConfig parameter specifies additional information about the policy configuration.
125+
The ScenarioConfig parameter specifies additional information about the feature configuration.
98126

99127
```yaml
100128
Type: String
@@ -145,7 +173,7 @@ Accept wildcard characters: False
145173
```
146174

147175
### -Locations
148-
The locations parameter specifies where the policy applies.
176+
The locations parameter specifies where the feature configuration applies.
149177

150178
```yaml
151179
Type: String

0 commit comments

Comments
 (0)