Skip to content

Update Set-FeatureConfiguration.md #12633

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Mar 27, 2025
Merged

Update Set-FeatureConfiguration.md #12633

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
4e15594
Update Set-FeatureConfiguration.md
brenle Mar 27, 2025
9af094c
Update parameter sets in Set-FeatureConfiguration
chrisda Mar 27, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
111 changes: 26 additions & 85 deletions exchange/exchange-ps/exchange/Set-FeatureConfiguration.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -9,17 +9,18 @@ schema: 2.0.0
# Set-FeatureConfiguration

## SYNOPSIS
**Note**: Currently, this cmdlet is available only in Private Preview.
**Note**: This cmdlet is available in Public Preview.

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

Use the Set-FeatureConfiguration cmdlet to modify Discovery policies.
Use the Set-FeatureConfiguration cmdlet to modify Microsoft Purview feature configurations within your organization, including:
- Collection policies
- Endpoint DLP trust container

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

## SYNTAX

### Identity (Default)
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter> [-Locations <String>]
[-Comment <String>]
Expand All @@ -32,96 +33,36 @@ Set-FeatureConfiguration [-Identity] <PolicyIdParameter> [-Locations <String>]
[<CommonParameters>]
```

### AdaptiveScopeLocation
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-GeneralDiscovery]
[-IrmDiscovery]
[-Mode <PolicyMode>]
[-ScenarioConfig <String>]
[-WhatIf]
[<CommonParameters>]
```

### TeamLocation
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
[-Comment <String>]
[-Confirm]
[-GeneralDiscovery]
[-IrmDiscovery]
[-Mode <PolicyMode>]
[-ScenarioConfig <String>]
[-WhatIf]
[<CommonParameters>]
```
## DESCRIPTION
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).

### OrganizationSegmentsDefault
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
[-Confirm]
[-GeneralDiscovery]
[-IrmDiscovery]
[-Mode <PolicyMode>]
[-ScenarioConfig <String>]
[-WhatIf]
[<CommonParameters>]
```
## EXAMPLES

### InformationBarrierDefault
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
[-Confirm]
[-GeneralDiscovery]
[-IrmDiscovery]
[-Mode <PolicyMode>]
[-ScenarioConfig <String>]
[-WhatIf]
[<CommonParameters>]
### Example 1
```powershell
Set-FeatureConfiguration "DSPM for AI - Capture interactions for Copilot experiences" -ScenarioConfig '{"Activities":["UploadText","DownloadText"],"EnforcementPlanes":["CopilotExperiences"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":false}'
```

### DisableRestrictiveRetentionParameterSet
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
[-Confirm]
[-GeneralDiscovery]
[-IrmDiscovery]
[-Mode <PolicyMode>]
[-ScenarioConfig <String>]
[-WhatIf]
[<CommonParameters>]
```
This example updates a collection policy named "DSPM for AI - Capture interactions for Copilot experiences" to disable content capture.

### RetryDistributionParameterSet
```
Set-FeatureConfiguration [-Identity] <PolicyIdParameter>
[-Confirm]
[-GeneralDiscovery]
[-IrmDiscovery]
[-Mode <PolicyMode>]
[-ScenarioConfig <String>]
[-WhatIf]
[<CommonParameters>]
### Example 2
```powershell
Set-FeatureConfiguration "Microsoft Copilot collection policy for Contoso Sales" -Locations '[{"Workload":"Applications","Location":"52655","AddInclusions":[{"Type":"Group","Identity":"[email protected]"}]}]'
```

## DESCRIPTION
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).

## EXAMPLES
This example updates a collection policy named "Microsoft Copilot collection policy for Contoso Sales" to include the [email protected] group.

### Example 1
### Example 3
```powershell
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"}]}]'
Set-FeatureConfiguration "Microsoft Copilot collection policy for Contoso Sales" -Locations '[{"Workload":"Applications","Location":"52655","AddExclusions":[{"Type":"IndividualResource","Identity":"adele@contoso.com"}]}]'
```

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

## PARAMETERS

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

- Name
- Distinguished name (DN)
Expand All @@ -145,7 +86,7 @@ The Comment parameter specifies an optional comment. If you specify a value that

```yaml
Type: String
Parameter Sets: Identity, AdaptiveScopeLocation, TeamLocation
Parameter Sets: (All)
Aliases:
Applicable: Security & Compliance

Expand Down Expand Up @@ -208,11 +149,11 @@ Accept wildcard characters: False
```

### -Locations
The locations parameter specifies where the policy applies.
The locations parameter specifies where the feature configuration applies.

```yaml
Type: String
Parameter Sets: Identity
Parameter Sets: (All)
Aliases:
Applicable: Security & Compliance

Expand All @@ -224,10 +165,10 @@ Accept wildcard characters: False
```

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

- Enable: The policy is enabled for actions and notifications. This is the default value.
- Disable: The policy is disabled.
- Enable: The feature configuration is enabled.
- Disable: The feature configuration is disabled.

```yaml
Type: PolicyMode
Expand All @@ -243,7 +184,7 @@ Accept wildcard characters: False
```

### -ScenarioConfig
The ScenarioConfig parameter specifies additional information about the policy configuration.
The ScenarioConfig parameter specifies additional information about the feature configuration.

```yaml
Type: String
Expand Down