diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index 01ac81be43..df23e33845 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -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] [-Locations ] [-Comment ] @@ -32,96 +33,36 @@ Set-FeatureConfiguration [-Identity] [-Locations ] [] ``` -### AdaptiveScopeLocation -``` -Set-FeatureConfiguration [-Identity] - [-Comment ] - [-Confirm] - [-GeneralDiscovery] - [-IrmDiscovery] - [-Mode ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### TeamLocation -``` -Set-FeatureConfiguration [-Identity] - [-Comment ] - [-Confirm] - [-GeneralDiscovery] - [-IrmDiscovery] - [-Mode ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` +## 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] - [-Confirm] - [-GeneralDiscovery] - [-IrmDiscovery] - [-Mode ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` +## EXAMPLES -### InformationBarrierDefault -``` -Set-FeatureConfiguration [-Identity] - [-Confirm] - [-GeneralDiscovery] - [-IrmDiscovery] - [-Mode ] - [-ScenarioConfig ] - [-WhatIf] - [] +### 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] - [-Confirm] - [-GeneralDiscovery] - [-IrmDiscovery] - [-Mode ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` +This example updates a collection policy named "DSPM for AI - Capture interactions for Copilot experiences" to disable content capture. -### RetryDistributionParameterSet -``` -Set-FeatureConfiguration [-Identity] - [-Confirm] - [-GeneralDiscovery] - [-IrmDiscovery] - [-Mode ] - [-ScenarioConfig ] - [-WhatIf] - [] +### Example 2 +```powershell +Set-FeatureConfiguration "Microsoft Copilot collection policy for Contoso Sales" -Locations '[{"Workload":"Applications","Location":"52655","AddInclusions":[{"Type":"Group","Identity":"USSales@contoso.com"}]}]' ``` -## 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 USSales@contoso.com 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": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51399","AddInclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]},{"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 adele@contoso.com. ## 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) @@ -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 @@ -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 @@ -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 @@ -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