Skip to content

Commit b690c77

Browse files
committed
Merge branch 'FeatureConfig-chrisda' of https://github.com/MicrosoftDocs/office-docs-powershell into FeatureConfig-chrisda
2 parents 5e89e11 + 944e240 commit b690c77

File tree

1 file changed

+26
-85
lines changed

1 file changed

+26
-85
lines changed

exchange/exchange-ps/exchange/Set-FeatureConfiguration.md

+26-85
Original file line numberDiff line numberDiff line change
@@ -9,17 +9,18 @@ schema: 2.0.0
99
# Set-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 Set-FeatureConfiguration cmdlet to modify Discovery policies.
16+
Use the Set-FeatureConfiguration cmdlet to modify 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

22-
### Identity (Default)
2324
```
2425
Set-FeatureConfiguration [-Identity] <PolicyIdParameter> [-Locations <String>]
2526
[-Comment <String>]
@@ -32,96 +33,36 @@ Set-FeatureConfiguration [-Identity] <PolicyIdParameter> [-Locations <String>]
3233
[<CommonParameters>]
3334
```
3435

35-
### AdaptiveScopeLocation
36-
```
37-
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
38-
[-Comment <String>]
39-
[-Confirm]
40-
[-GeneralDiscovery]
41-
[-IrmDiscovery]
42-
[-Mode <PolicyMode>]
43-
[-ScenarioConfig <String>]
44-
[-WhatIf]
45-
[<CommonParameters>]
46-
```
47-
48-
### TeamLocation
49-
```
50-
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
51-
[-Comment <String>]
52-
[-Confirm]
53-
[-GeneralDiscovery]
54-
[-IrmDiscovery]
55-
[-Mode <PolicyMode>]
56-
[-ScenarioConfig <String>]
57-
[-WhatIf]
58-
[<CommonParameters>]
59-
```
36+
## DESCRIPTION
37+
To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see [Permissions in Security & Compliance](https://go.microsoft.com/fwlink/p/?LinkId=511920).
6038

61-
### OrganizationSegmentsDefault
62-
```
63-
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
64-
[-Confirm]
65-
[-GeneralDiscovery]
66-
[-IrmDiscovery]
67-
[-Mode <PolicyMode>]
68-
[-ScenarioConfig <String>]
69-
[-WhatIf]
70-
[<CommonParameters>]
71-
```
39+
## EXAMPLES
7240

73-
### InformationBarrierDefault
74-
```
75-
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
76-
[-Confirm]
77-
[-GeneralDiscovery]
78-
[-IrmDiscovery]
79-
[-Mode <PolicyMode>]
80-
[-ScenarioConfig <String>]
81-
[-WhatIf]
82-
[<CommonParameters>]
41+
### Example 1
42+
```powershell
43+
Set-FeatureConfiguration "DSPM for AI - Capture interactions for Copilot experiences" -ScenarioConfig '{"Activities":["UploadText","DownloadText"],"EnforcementPlanes":["CopilotExperiences"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":false}'
8344
```
8445

85-
### DisableRestrictiveRetentionParameterSet
86-
```
87-
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
88-
[-Confirm]
89-
[-GeneralDiscovery]
90-
[-IrmDiscovery]
91-
[-Mode <PolicyMode>]
92-
[-ScenarioConfig <String>]
93-
[-WhatIf]
94-
[<CommonParameters>]
95-
```
46+
This example updates a collection policy named "DSPM for AI - Capture interactions for Copilot experiences" to disable content capture.
9647

97-
### RetryDistributionParameterSet
98-
```
99-
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
100-
[-Confirm]
101-
[-GeneralDiscovery]
102-
[-IrmDiscovery]
103-
[-Mode <PolicyMode>]
104-
[-ScenarioConfig <String>]
105-
[-WhatIf]
106-
[<CommonParameters>]
48+
### Example 2
49+
```powershell
50+
Set-FeatureConfiguration "Microsoft Copilot collection policy for Contoso Sales" -Locations '[{"Workload":"Applications","Location":"52655","AddInclusions":[{"Type":"Group","Identity":"[email protected]"}]}]'
10751
```
10852

109-
## DESCRIPTION
110-
To use this cmdlet in Security & Compliance PowerShell, you need to be assigned permissions. For more information, see [Permissions in Security & Compliance](https://go.microsoft.com/fwlink/p/?LinkId=511920).
111-
112-
## EXAMPLES
53+
This example updates a collection policy named "Microsoft Copilot collection policy for Contoso Sales" to include the [email protected] group.
11354

114-
### Example 1
55+
### Example 3
11556
```powershell
116-
Set-FeatureConfiguration "Discovery policy for Contoso executives" -ScenarioConfig '{"Activities": ["UploadText", "UploadFile"], "EnforcementPlanes": ["Browser"], "SensitiveTypeIds": ["a44669fe-0d48-453d-a9b1-2cc83f2cba77","50842eb7-edc8-4019-85dd-5a5c1f2bb085"]}' -Locations '[{"Workload": "Applications","Location": "51622","AddInclusions": [{"Type": "Group","Identity": "[email protected]"}]},{"Workload": "Applications","Location": "51399","AddInclusions": [{"Type": "Group","Identity": "[email protected]"}]},{"Workload": "Applications","Location": "51279","AddInclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]}]'
57+
Set-FeatureConfiguration "Microsoft Copilot collection policy for Contoso Sales" -Locations '[{"Workload":"Applications","Location":"52655","AddExclusions":[{"Type":"IndividualResource","Identity":"adele@contoso.com"}]}]'
11758
```
11859

119-
The example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types.
60+
This example updates a collection policy named "Microsoft Copilot collection policy for Contoso Sales" to exclude the [email protected].
12061

12162
## PARAMETERS
12263

12364
### -Identity
124-
The Identity policy specifies the Discovery policy that you want to modify. You can use any value that uniquely identifies the policy. For example:
65+
The Identity parameter specifies the feature configuration that you want to modify. You can use any value that uniquely identifies the policy. For example:
12566

12667
- Name
12768
- Distinguished name (DN)
@@ -145,7 +86,7 @@ The Comment parameter specifies an optional comment. If you specify a value that
14586
14687
```yaml
14788
Type: String
148-
Parameter Sets: Identity, AdaptiveScopeLocation, TeamLocation
89+
Parameter Sets: (All)
14990
Aliases:
15091
Applicable: Security & Compliance
15192

@@ -208,11 +149,11 @@ Accept wildcard characters: False
208149
```
209150

210151
### -Locations
211-
The locations parameter specifies where the policy applies.
152+
The locations parameter specifies where the feature configuration applies.
212153

213154
```yaml
214155
Type: String
215-
Parameter Sets: Identity
156+
Parameter Sets: (All)
216157
Aliases:
217158
Applicable: Security & Compliance
218159
@@ -224,10 +165,10 @@ Accept wildcard characters: False
224165
```
225166

226167
### -Mode
227-
The Mode parameter specifies the action and notification level of the Discovery policy. Valid values are:
168+
The Mode parameter specifies feature configuration mode. Valid values are:
228169

229-
- Enable: The policy is enabled for actions and notifications. This is the default value.
230-
- Disable: The policy is disabled.
170+
- Enable: The feature configuration is enabled.
171+
- Disable: The feature configuration is disabled.
231172

232173
```yaml
233174
Type: PolicyMode
@@ -243,7 +184,7 @@ Accept wildcard characters: False
243184
```
244185

245186
### -ScenarioConfig
246-
The ScenarioConfig parameter specifies additional information about the policy configuration.
187+
The ScenarioConfig parameter specifies additional information about the feature configuration.
247188

248189
```yaml
249190
Type: String

0 commit comments

Comments
 (0)