From 76371f9af09ea848b124bd206e25cdbb125c156b Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Thu, 28 Mar 2024 14:14:19 -0700 Subject: [PATCH 01/21] FeatureConfig --- .../exchange/Get-FeatureConfiguration.md | 109 ++++++++ .../exchange/New-FeatureConfiguration.md | 188 +++++++++++++ .../exchange/Remove-FeatureConfiguration.md | 105 +++++++ .../exchange/Set-FeatureConfiguration.md | 260 ++++++++++++++++++ exchange/exchange-ps/exchange/exchange.md | 8 + exchange/mapping/serviceMapping.json | 4 + 6 files changed, 674 insertions(+) create mode 100644 exchange/exchange-ps/exchange/Get-FeatureConfiguration.md create mode 100644 exchange/exchange-ps/exchange/New-FeatureConfiguration.md create mode 100644 exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md create mode 100644 exchange/exchange-ps/exchange/Set-FeatureConfiguration.md diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md new file mode 100644 index 0000000000..cb43ef0a84 --- /dev/null +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -0,0 +1,109 @@ +--- +external help file: Microsoft.Exchange.TransportMailflow-Help.xml +online version: https://learn.microsoft.com/powershell/module/exchange/get-featureconfiguration +applicable: Security & Compliance +title: Get-FeatureConfiguration +schema: 2.0.0 +--- + +# Get-FeatureConfiguration + +## SYNOPSIS +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 Get-FeatureConfiguration cmdlet to view Discovery policies. + +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 + +``` +Get-FeatureConfiguration [[-Identity] ] + [-Confirm] + [-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). + +## EXAMPLES + +### Example 1 +```powershell +Get-FeatureConfiguration | Format-Table Name,Mode +``` + +This example returns a summary list of all Discovery policies in the organization. + +### Example 2 +```powershell +Get-FeatureConfiguration -Identity "Engineering Group" +``` + +This example returns detailed information about the specified Discovery policy. + +## PARAMETERS + +### -Identity +The Identity policy specifies the Discovery policy that you want to view. You can use any value that uniquely identifies the policy. For example: + +- Name +- Distinguished name (DN) +- GUID + +```yaml +Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -Confirm +This parameter is reserved for internal Microsoft use. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +This parameter is reserved for internal Microsoft use. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md new file mode 100644 index 0000000000..e5e9c72b77 --- /dev/null +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -0,0 +1,188 @@ +--- +external help file: Microsoft.Exchange.TransportMailflow-Help.xml +online version: https://learn.microsoft.com/powershell/module/exchange/new-featureconfiguration +applicable: Security & Compliance +title: New-FeatureConfiguration +schema: 2.0.0 +--- + +# New-FeatureConfiguration + +## SYNOPSIS + +## SYNTAX +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 New-FeatureConfiguration cmdlet to create Discovery policies. + +For information about the parameter sets in the Syntax section below, see [Exchange cmdlet syntax](https://learn.microsoft.com/powershell/exchange/exchange-cmdlet-syntax). + +``` +New-FeatureConfiguration [-Name] -Mode -Scenario -ScenarioConfig + [-Comment ] + [-Confirm] + [-Locations ] + [-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). + +## EXAMPLES + +### Example 1 +```powershell +{{ Add example code here }} +``` + +{{ Add example description here }} + +## PARAMETERS + +### -Name +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 ("). + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: 1 +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Comment +The Comment parameter specifies an optional comment. If you specify a value that contains spaces, enclose the value in quotation marks ("), for example: "This is an admin note". + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding. + +- Destructive cmdlets (for example, Remove-\* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: `-Confirm:$false`. +- Most other cmdlets (for example, New-\* and Set-\* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Locations +{{ Fill Locations Description }} + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Mode +The Mode parameter specifies the action and notification level of the Discovery policy. Valid values are: + +- Enable: The policy is enabled for actions and notifications. This is the default value. +- Disable: The policy is disabled. +- TestWithNotifications: Simulation mode where no actions are taken, but notifications **are** sent. +- TestWithoutNotifications: Simulation mode where no actions are taken, and no notifications are sent. + +```yaml +Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Scenario +The Scenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. + +```yaml +Type: icrosoft.Office.CompliancePolicy.Tasks.FeatureConfigurationScenario +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ScenarioConfig +{{ Fill ScenarioConfig Description }} + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md new file mode 100644 index 0000000000..844fb4b544 --- /dev/null +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -0,0 +1,105 @@ +--- +external help file: Microsoft.Exchange.TransportMailflow-Help.xml +online version: https://learn.microsoft.com/powershell/module/exchange/remove-featureconfiguration +applicable: Security & Compliance +title: Remove-FeatureConfiguration +schema: 2.0.0 +--- + +# Remove-FeatureConfiguration + +## SYNOPSIS +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 Remove-FeatureConfiguration cmdlet to remove Discovery policies. + +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 + +``` +Remove-FeatureConfiguration [-Identity] + [-Confirm] + [-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). + +## EXAMPLES + +### Example 1 +```powershell +Remove-FeatureConfiguration -Identity "Engineering Group" +``` + +This example removes the specified Discovery policy. + +## PARAMETERS + +### -Identity +The Identity policy specifies the Discovery policy that you want to remove. You can use any value that uniquely identifies the policy. For example: + +- Name +- Distinguished name (DN) +- GUID + +```yaml +Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -Confirm +The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding. + +- Destructive cmdlets (for example, Remove-\* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: `-Confirm:$false`. +- Most other cmdlets (for example, New-\* and Set-\* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md new file mode 100644 index 0000000000..5de733cdaa --- /dev/null +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -0,0 +1,260 @@ +--- +external help file: Microsoft.Exchange.TransportMailflow-Help.xml +online version: https://learn.microsoft.com/powershell/module/exchange/set-featureconfiguration +applicable: Security & Compliance +title: Set-FeatureConfiguration +schema: 2.0.0 +--- + +# Set-FeatureConfiguration + +## SYNOPSIS +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. + +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 ] + [-Confirm] + [-Mode ] + [-Scenario ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### AdaptiveScopeLocation +``` +Set-FeatureConfiguration [-Identity] [-Comment ] + [-Confirm] + [-Mode ] + [-Scenario ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### TeamLocation +``` +Set-FeatureConfiguration [-Identity] [-Comment ] + [-Confirm] + [-Mode ] + [-Scenario ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### OrganizationSegmentsDefault +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-Mode ] + [-Scenario ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### InformationBarrierDefault +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-Mode ] + [-Scenario ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### DisableRestrictiveRetentionParameterSet +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-Mode ] + [-Scenario ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### RetryDistributionParameterSet +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-Mode ] + [-Scenario ] + [-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). + +## EXAMPLES + +### Example 1 +```powershell +{{ Add example code here }} +``` + +{{ Add example description here }} + +## 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: + +- Name +- Distinguished name (DN) +- GUID + +```yaml +Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: 1 +Default value: None +Accept pipeline input: True (ByPropertyName, ByValue) +Accept wildcard characters: False +``` + +### -Comment +The Comment parameter specifies an optional comment. If you specify a value that contains spaces, enclose the value in quotation marks ("), for example: "This is an admin note". + +```yaml +Type: String +Parameter Sets: Identity, AdaptiveScopeLocation, TeamLocation +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Confirm +The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding. + +- Destructive cmdlets (for example, Remove-\* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: `-Confirm:$false`. +- Most other cmdlets (for example, New-\* and Set-\* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: cf +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Locations +{{ Fill Locations Description }} + +```yaml +Type: String +Parameter Sets: Identity +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Mode +The Mode parameter specifies the action and notification level of the Discovery policy. Valid values are: + +- Enable: The policy is enabled for actions and notifications. This is the default value. +- Disable: The policy is disabled. +- TestWithNotifications: Simulation mode where no actions are taken, but notifications **are** sent. +- TestWithoutNotifications: Simulation mode where no actions are taken, and no notifications are sent. + +```yaml +Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -Scenario +The Scenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. + +```yaml +Type: Microsoft.Office.CompliancePolicy.Tasks.FeatureConfigurationScenario +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -ScenarioConfig +{{ Fill ScenarioConfig Description }} + +```yaml +Type: String +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -WhatIf +The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch. + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: wi +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### CommonParameters +This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about_CommonParameters](https://go.microsoft.com/fwlink/p/?LinkID=113216). + +## INPUTS + +## OUTPUTS + +## NOTES + +## RELATED LINKS diff --git a/exchange/exchange-ps/exchange/exchange.md b/exchange/exchange-ps/exchange/exchange.md index d29a918a99..bb1eea1add 100644 --- a/exchange/exchange-ps/exchange/exchange.md +++ b/exchange/exchange-ps/exchange/exchange.md @@ -1624,6 +1624,8 @@ Exchange PowerShell is built on Windows PowerShell technology and provides a pow ### [Get-ExchangeSettings](Get-ExchangeSettings.md) +### [Get-FeatureConfiguration](Get-FeatureConfiguration.md) + ### [Get-Notification](Get-Notification.md) ### [Get-OrganizationConfig](Get-OrganizationConfig.md) @@ -1644,6 +1646,8 @@ Exchange PowerShell is built on Windows PowerShell technology and provides a pow ### [New-ExchangeSettings](New-ExchangeSettings.md) +### [New-FeatureConfiguration](New-FeatureConfiguration.md) + ### [New-PartnerApplication](New-PartnerApplication.md) ### [New-ServicePrincipal](New-ServicePrincipal.md) @@ -1656,6 +1660,8 @@ Exchange PowerShell is built on Windows PowerShell technology and provides a pow ### [Remove-AuthServer](Remove-AuthServer.md) +### [Remove-FeatureConfiguration](Remove-FeatureConfiguration.md) + ### [Remove-PartnerApplication](Remove-PartnerApplication.md) ### [Remove-ServicePrincipal](Remove-ServicePrincipal.md) @@ -1680,6 +1686,8 @@ Exchange PowerShell is built on Windows PowerShell technology and provides a pow ### [Set-ExchangeSettings](Set-ExchangeSettings.md) +### [Set-FeatureConfiguration](Set-FeatureConfiguration.md) + ### [Set-Notification](Set-Notification.md) ### [Set-OrganizationConfig](Set-OrganizationConfig.md) diff --git a/exchange/mapping/serviceMapping.json b/exchange/mapping/serviceMapping.json index 71f9aa2c59..09a0578270 100644 --- a/exchange/mapping/serviceMapping.json +++ b/exchange/mapping/serviceMapping.json @@ -795,6 +795,7 @@ "Get-ExchangeServerAccessLicense": "organization", "Get-ExchangeServerAccessLicenseUser": "organization", "Get-ExchangeSettings": "organization", + "Get-FeatureConfiguration": "organization", "Get-Notification": "organization", "Get-OrganizationConfig": "organization", "Get-PartnerApplication": "organization", @@ -805,12 +806,14 @@ "New-AuthenticationPolicy": "organization", "New-AuthServer": "organization", "New-ExchangeSettings": "organization", + "New-FeatureConfiguration": "organization", "New-PartnerApplication": "organization", "New-ServicePrincipal": "organization", "New-SettingOverride": "organization", "Remove-ApplicationAccessPolicy": "organization", "Remove-AuthenticationPolicy": "organization", "Remove-AuthServer": "organization", + "Remove-FeatureConfiguration": "organization", "Remove-PartnerApplication": "organization", "Remove-ServicePrincipal": "organization", "Remove-SettingOverride": "organization", @@ -823,6 +826,7 @@ "Set-ExchangeAssistanceConfig": "organization", "Set-ExchangeServer": "organization", "Set-ExchangeSettings": "organization", + "Set-FeatureConfiguration": "organization", "Set-Notification": "organization", "Set-OrganizationConfig": "organization", "Set-PartnerApplication": "organization", From 606613ff4ca751f9f25b67debddd2421255ec036 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Thu, 28 Mar 2024 14:17:26 -0700 Subject: [PATCH 02/21] Private preview --- exchange/exchange-ps/exchange/Get-FeatureConfiguration.md | 2 ++ exchange/exchange-ps/exchange/New-FeatureConfiguration.md | 4 +++- exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md | 2 ++ exchange/exchange-ps/exchange/Set-FeatureConfiguration.md | 2 ++ 4 files changed, 9 insertions(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index cb43ef0a84..3c0a5bc8c5 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -9,6 +9,8 @@ schema: 2.0.0 # Get-FeatureConfiguration ## SYNOPSIS +**Note**: Currently, this cmdlet is available only in Private 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 Get-FeatureConfiguration cmdlet to view Discovery policies. diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index e5e9c72b77..6f8e71062c 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -9,14 +9,16 @@ schema: 2.0.0 # New-FeatureConfiguration ## SYNOPSIS +**Note**: Currently, this cmdlet is available only in Private Preview. -## SYNTAX 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 New-FeatureConfiguration cmdlet to create Discovery policies. 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 + ``` New-FeatureConfiguration [-Name] -Mode -Scenario -ScenarioConfig [-Comment ] diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md index 844fb4b544..1a11ee88d5 100644 --- a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -9,6 +9,8 @@ schema: 2.0.0 # Remove-FeatureConfiguration ## SYNOPSIS +**Note**: Currently, this cmdlet is available only in Private 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 Remove-FeatureConfiguration cmdlet to remove Discovery policies. diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index 5de733cdaa..7da4d02961 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -9,6 +9,8 @@ schema: 2.0.0 # Set-FeatureConfiguration ## SYNOPSIS +**Note**: Currently, this cmdlet is available only in Private 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. From 452f46068b319c46d49a130531cc684f5a4a59c0 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Tue, 28 May 2024 11:19:10 -0700 Subject: [PATCH 03/21] Adding changes from PR against Main #11850 --- .../exchange/Get-FeatureConfiguration.md | 23 ++++- .../exchange/New-FeatureConfiguration.md | 62 +++++++------- .../exchange/Set-FeatureConfiguration.md | 85 ------------------- 3 files changed, 50 insertions(+), 120 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 3c0a5bc8c5..9ef39a34d8 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -20,7 +20,8 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX ``` -Get-FeatureConfiguration [[-Identity] ] +Get-FeatureConfiguration [-FeatureScenario] + [[-Identity] ] [-Confirm] [-WhatIf] [] @@ -33,14 +34,14 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned ### Example 1 ```powershell -Get-FeatureConfiguration | Format-Table Name,Mode +Get-FeatureConfiguration -FeatureScenario KnowYourData | Format-Table Name,Mode ``` This example returns a summary list of all Discovery policies in the organization. ### Example 2 ```powershell -Get-FeatureConfiguration -Identity "Engineering Group" +Get-FeatureConfiguration -FeatureScenario KnowYourData -Identity "Engineering Group" ``` This example returns detailed information about the specified Discovery policy. @@ -67,6 +68,22 @@ Accept pipeline input: True (ByPropertyName, ByValue) Accept wildcard characters: False ``` +### -FeatureScenario +The FeatureScenario parameter identifies the type of Discovery policy that you want to view. + +```yaml +Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: True +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Confirm This parameter is reserved for internal Microsoft use. diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index 6f8e71062c..63af974a9a 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -20,7 +20,7 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX ``` -New-FeatureConfiguration [-Name] -Mode -Scenario -ScenarioConfig +New-FeatureConfiguration [-Name] -Mode -FeatureScenario -ScenarioConfig [-Comment ] [-Confirm] [-Locations ] @@ -58,43 +58,43 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -Comment -The Comment parameter specifies an optional comment. If you specify a value that contains spaces, enclose the value in quotation marks ("), for example: "This is an admin note". +### -FeatureScenario +The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. ```yaml -Type: String +Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario Parameter Sets: (All) Aliases: Applicable: Security & Compliance -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -Confirm -The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding. +### -Mode +The Mode parameter specifies the action and notification level of the Discovery policy. Valid values are: -- Destructive cmdlets (for example, Remove-\* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: `-Confirm:$false`. -- Most other cmdlets (for example, New-\* and Set-\* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding. +- Enable: The policy is enabled for actions and notifications. This is the default value. +- Disable: The policy is disabled. ```yaml -Type: SwitchParameter +Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode Parameter Sets: (All) -Aliases: cf +Aliases: Applicable: Security & Compliance -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -Locations -{{ Fill Locations Description }} +### -ScenarioConfig +{{ Fill ScenarioConfig Description }} ```yaml Type: String @@ -102,52 +102,50 @@ Parameter Sets: (All) Aliases: Applicable: Security & Compliance -Required: False +Required: True Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -Mode -The Mode parameter specifies the action and notification level of the Discovery policy. Valid values are: - -- Enable: The policy is enabled for actions and notifications. This is the default value. -- Disable: The policy is disabled. -- TestWithNotifications: Simulation mode where no actions are taken, but notifications **are** sent. -- TestWithoutNotifications: Simulation mode where no actions are taken, and no notifications are sent. +### -Comment +The Comment parameter specifies an optional comment. If you specify a value that contains spaces, enclose the value in quotation marks ("), for example: "This is an admin note". ```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode +Type: String Parameter Sets: (All) Aliases: Applicable: Security & Compliance -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -Scenario -The Scenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. +### -Confirm +The Confirm switch specifies whether to show or hide the confirmation prompt. How this switch affects the cmdlet depends on if the cmdlet requires confirmation before proceeding. + +- Destructive cmdlets (for example, Remove-\* cmdlets) have a built-in pause that forces you to acknowledge the command before proceeding. For these cmdlets, you can skip the confirmation prompt by using this exact syntax: `-Confirm:$false`. +- Most other cmdlets (for example, New-\* and Set-\* cmdlets) don't have a built-in pause. For these cmdlets, specifying the Confirm switch without a value introduces a pause that forces you acknowledge the command before proceeding. ```yaml -Type: icrosoft.Office.CompliancePolicy.Tasks.FeatureConfigurationScenario +Type: SwitchParameter Parameter Sets: (All) -Aliases: +Aliases: cf Applicable: Security & Compliance -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False Accept wildcard characters: False ``` -### -ScenarioConfig -{{ Fill ScenarioConfig Description }} +### -Locations +{{ Fill Locations Description }} ```yaml Type: String @@ -155,7 +153,7 @@ Parameter Sets: (All) Aliases: Applicable: Security & Compliance -Required: True +Required: False Position: Named Default value: None Accept pipeline input: False diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index 7da4d02961..b7f6e6a803 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -24,73 +24,6 @@ For information about the parameter sets in the Syntax section below, see [Excha Set-FeatureConfiguration [-Identity] [-Locations ] [-Comment ] [-Confirm] [-Mode ] - [-Scenario ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### AdaptiveScopeLocation -``` -Set-FeatureConfiguration [-Identity] [-Comment ] - [-Confirm] - [-Mode ] - [-Scenario ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### TeamLocation -``` -Set-FeatureConfiguration [-Identity] [-Comment ] - [-Confirm] - [-Mode ] - [-Scenario ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### OrganizationSegmentsDefault -``` -Set-FeatureConfiguration [-Identity] - [-Confirm] - [-Mode ] - [-Scenario ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### InformationBarrierDefault -``` -Set-FeatureConfiguration [-Identity] - [-Confirm] - [-Mode ] - [-Scenario ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### DisableRestrictiveRetentionParameterSet -``` -Set-FeatureConfiguration [-Identity] - [-Confirm] - [-Mode ] - [-Scenario ] - [-ScenarioConfig ] - [-WhatIf] - [] -``` - -### RetryDistributionParameterSet -``` -Set-FeatureConfiguration [-Identity] - [-Confirm] - [-Mode ] - [-Scenario ] [-ScenarioConfig ] [-WhatIf] [] @@ -186,8 +119,6 @@ The Mode parameter specifies the action and notification level of the Discovery - Enable: The policy is enabled for actions and notifications. This is the default value. - Disable: The policy is disabled. -- TestWithNotifications: Simulation mode where no actions are taken, but notifications **are** sent. -- TestWithoutNotifications: Simulation mode where no actions are taken, and no notifications are sent. ```yaml Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode @@ -202,22 +133,6 @@ Accept pipeline input: False Accept wildcard characters: False ``` -### -Scenario -The Scenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. - -```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.FeatureConfigurationScenario -Parameter Sets: (All) -Aliases: -Applicable: Security & Compliance - -Required: False -Position: Named -Default value: None -Accept pipeline input: False -Accept wildcard characters: False -``` - ### -ScenarioConfig {{ Fill ScenarioConfig Description }} From 39f01d1b7441be8dff695de57364cbb087231834 Mon Sep 17 00:00:00 2001 From: jiwei0722 Date: Fri, 31 May 2024 09:57:07 -0700 Subject: [PATCH 04/21] Update New-FeatureConfiguration.md --- .../exchange-ps/exchange/New-FeatureConfiguration.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index 63af974a9a..f0155b668f 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -35,10 +35,11 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned ### Example 1 ```powershell -{{ Add example code here }} +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": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51399","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]},{"Workload": "A +pplications","Location": "51279","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]}]' ``` - -{{ Add example description here }} +This example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types. ## PARAMETERS @@ -145,7 +146,7 @@ Accept wildcard characters: False ``` ### -Locations -{{ Fill Locations Description }} +The locations parameter specifies where the policy applies. ```yaml Type: String From 31318243a014cde7c04c7265be7e4a0e1e8a3c72 Mon Sep 17 00:00:00 2001 From: jiwei0722 Date: Fri, 31 May 2024 10:06:15 -0700 Subject: [PATCH 05/21] Update Get-FeatureConfiguration.md --- exchange/exchange-ps/exchange/Get-FeatureConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 9ef39a34d8..15c32b56e6 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -69,7 +69,7 @@ Accept wildcard characters: False ``` ### -FeatureScenario -The FeatureScenario parameter identifies the type of Discovery policy that you want to view. +The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. ```yaml Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario From ab0fe4ebd746643bbc6faf789e1005c4ffa4da80 Mon Sep 17 00:00:00 2001 From: jiwei0722 Date: Fri, 31 May 2024 10:13:40 -0700 Subject: [PATCH 06/21] Update Set-FeatureConfiguration.md --- exchange/exchange-ps/exchange/Set-FeatureConfiguration.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index b7f6e6a803..cc8622426f 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -36,10 +36,10 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned ### Example 1 ```powershell -{{ Add example code here }} +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"}]}]' ``` -{{ Add example description here }} +The example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types. ## PARAMETERS @@ -99,7 +99,7 @@ Accept wildcard characters: False ``` ### -Locations -{{ Fill Locations Description }} +The locations parameter specifies where the policy applies. ```yaml Type: String From 8509e49ba1df12ba935079550b18025a4c6b16ac Mon Sep 17 00:00:00 2001 From: jiwei0722 Date: Fri, 31 May 2024 14:24:05 -0700 Subject: [PATCH 07/21] Update New-FeatureConfiguration.md --- exchange/exchange-ps/exchange/New-FeatureConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index f0155b668f..a3eed9b686 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -95,7 +95,7 @@ Accept wildcard characters: False ``` ### -ScenarioConfig -{{ Fill ScenarioConfig Description }} +The ScenarioConfig parameter specifies additional information about the policy configuration. ```yaml Type: String From bb0e0d1b010638b64fbb1c1f5ec848cdf6e421b3 Mon Sep 17 00:00:00 2001 From: jiwei0722 Date: Fri, 31 May 2024 14:26:04 -0700 Subject: [PATCH 08/21] Update Set-FeatureConfiguration.md --- exchange/exchange-ps/exchange/Set-FeatureConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index cc8622426f..a57f471cda 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -134,7 +134,7 @@ Accept wildcard characters: False ``` ### -ScenarioConfig -{{ Fill ScenarioConfig Description }} +The ScenarioConfig parameter specifies additional information about the policy configuration. ```yaml Type: String From 29afbcf880ac5ed250a63af6183c9b02ce26b658 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Fri, 31 May 2024 15:37:45 -0700 Subject: [PATCH 09/21] Update New-FeatureConfiguration.md --- exchange/exchange-ps/exchange/New-FeatureConfiguration.md | 7 +++---- 1 file changed, 3 insertions(+), 4 deletions(-) diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index a3eed9b686..7b2d98f0d9 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -35,11 +35,10 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned ### Example 1 ```powershell -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": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51399","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]},{"Workload": "A -pplications","Location": "51279","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]}]' +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": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51399","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51279","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]}]' ``` -This example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types. + +This example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types. ## PARAMETERS From 4ccc3cdc8555b8f2018c1d9503e714afd493b4e5 Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 10:23:12 -0400 Subject: [PATCH 10/21] Update Get-FeatureConfiguration.md --- .../exchange/Get-FeatureConfiguration.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 15c32b56e6..59117396b6 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -9,18 +9,20 @@ schema: 2.0.0 # Get-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 Get-FeatureConfiguration cmdlet to view Discovery policies. +Use the Get-FeatureConfiguration cmdlet to view 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 ``` -Get-FeatureConfiguration [-FeatureScenario] +Get-FeatureConfiguration -FeatureScenario [[-Identity] ] [-Confirm] [-WhatIf] @@ -37,19 +39,19 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned Get-FeatureConfiguration -FeatureScenario KnowYourData | Format-Table Name,Mode ``` -This example returns a summary list of all Discovery policies in the organization. +This example returns a summary list of all collection policies in the organization. ### Example 2 ```powershell Get-FeatureConfiguration -FeatureScenario KnowYourData -Identity "Engineering Group" ``` -This example returns detailed information about the specified Discovery policy. +This example returns detailed information about the specified collection policy. ## PARAMETERS ### -Identity -The Identity policy specifies the Discovery policy that you want to view. You can use any value that uniquely identifies the policy. For example: +The Identity policy specifies the feature configuration that you want to view. You can use any value that uniquely identifies the policy. For example: - Name - Distinguished name (DN) @@ -69,7 +71,9 @@ Accept wildcard characters: False ``` ### -FeatureScenario -The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. +The FeatureScenario parameter specifies the scenario for the feature configuration. Currently, the only valid values are: +- `KnowYourData` for collection policies +- `TrustContainer` for Endpoint DLP trust container ```yaml Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario From 9470475c2a3886b434346ed5dc8a39fe19549969 Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 10:35:05 -0400 Subject: [PATCH 11/21] Fix typo in Get-FeatureConfiguration documentation --- exchange/exchange-ps/exchange/Get-FeatureConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 59117396b6..ca52639e44 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -51,7 +51,7 @@ This example returns detailed information about the specified collection policy. ## PARAMETERS ### -Identity -The Identity policy specifies the feature configuration that you want to view. You can use any value that uniquely identifies the policy. For example: +The Identity policy specifies the feature configuration that you want to view. You can use any value that uniquely identifies the configuration. For example: - Name - Distinguished name (DN) From 6cd9dd964aaf05cd11d0b69b3b484950317b381b Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 10:35:42 -0400 Subject: [PATCH 12/21] Update Remove-FeatureConfiguration.md --- .../exchange/Remove-FeatureConfiguration.md | 12 +++++++----- 1 file changed, 7 insertions(+), 5 deletions(-) diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md index 1a11ee88d5..9ea9a64644 100644 --- a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -9,18 +9,20 @@ schema: 2.0.0 # Remove-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 Remove-FeatureConfiguration cmdlet to remove Discovery policies. +Use the Remove-FeatureConfiguration cmdlet to remove 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 ``` -Remove-FeatureConfiguration [-Identity] +Remove-FeatureConfiguration -Identity [-Confirm] [-WhatIf] [] @@ -36,12 +38,12 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned Remove-FeatureConfiguration -Identity "Engineering Group" ``` -This example removes the specified Discovery policy. +This example removes the specified feature configuration. ## PARAMETERS ### -Identity -The Identity policy specifies the Discovery policy that you want to remove. You can use any value that uniquely identifies the policy. For example: +The Identity policy specifies the feature configuration that you want to remove. You can use any value that uniquely identifies the configuration. For example: - Name - Distinguished name (DN) From ca32e03cdfbf81660640ab89c69dfc1cc5661ebb Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 10:36:52 -0400 Subject: [PATCH 13/21] Update cmdlet description to include Microsoft Purview --- exchange/exchange-ps/exchange/Get-FeatureConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index ca52639e44..3a002b5f68 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -13,7 +13,7 @@ schema: 2.0.0 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 Get-FeatureConfiguration cmdlet to view Purview feature configurations within your organization, including: +Use the Get-FeatureConfiguration cmdlet to view Microsoft Purview feature configurations within your organization, including: - Collection policies - Endpoint DLP trust container From 0a353189843d74c4154aaa2e1648c1d574e3da68 Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 10:37:16 -0400 Subject: [PATCH 14/21] Update cmdlet description to include 'Microsoft' --- exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md index 9ea9a64644..f5731fc4f7 100644 --- a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -13,7 +13,7 @@ schema: 2.0.0 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 Remove-FeatureConfiguration cmdlet to remove Purview feature configurations within your organization, including: +Use the Remove-FeatureConfiguration cmdlet to remove Microsoft Purview feature configurations within your organization, including: - Collection policies - Endpoint DLP trust container From d1e4c194547f65f5d0447946db85dd0a78b69949 Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 11:40:52 -0400 Subject: [PATCH 15/21] Update New-FeatureConfiguration.md --- .../exchange/New-FeatureConfiguration.md | 52 ++++++++++++++----- 1 file changed, 40 insertions(+), 12 deletions(-) diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index 7b2d98f0d9..ba558ba296 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -9,18 +9,20 @@ schema: 2.0.0 # New-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 New-FeatureConfiguration cmdlet to create Discovery policies. +Use the New-FeatureConfiguration cmdlet to create 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 ``` -New-FeatureConfiguration [-Name] -Mode -FeatureScenario -ScenarioConfig +New-FeatureConfiguration -Name -Mode -FeatureScenario -ScenarioConfig [-Comment ] [-Confirm] [-Locations ] @@ -35,15 +37,39 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned ### Example 1 ```powershell -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": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51399","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]},{"Workload": "Applications","Location": "51279","Inclusions": [{"Type": "Group","Identity": "executives@contoso.com"}]}]' +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"}]}]' ``` -This example displays a discovery policy that includes the group "Executives" and targets a specific set of sensitive information types. +This example creates an enabled collection policy named "Browser collection policy for Microsoft Copilot" that: +- Includes UploadText activity for all supported classifiers +- Captures all AI prompts +- Includes Microsoft Copilot location, for all users & groups + +### Example 2 +```powershell +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"}]}]' +``` + +This example creates an enabled collection policy named "Scoped browser collection policy for Microsoft Copilot" that: +- Includes UploadText activity for all supported classifiers except "All Full Names" and "All Physical Addresses" +- Includes Microsoft Copilot location, for all users & groups except the "Contoso Executives Group" + +### Example 3 +```powershell +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"}]}]' +``` + +This example creates a disabled collection policy named "Scoped collection policies for browser and devices" that: +- Includes UploadText (for browser) and filecreated, filedeleted, and filemodified activities (for devices) +- Includes "U.S. Social Security Number (SSN)" and "ABA Routing Number" classifiers only +- Detects files on devices with "pdf" file extension only +- Includes devices location, scoped to the "All company" group, excluding the user "Alex Wilber" +- Includes Microsoft Copilot location, scoped only to the user "Adele Vance" ## PARAMETERS ### -Name -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 ("). +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 ("). ```yaml Type: String @@ -59,7 +85,9 @@ Accept wildcard characters: False ``` ### -FeatureScenario -The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. +The FeatureScenario parameter specifies the scenario for the feature configuration. Currently, the only valid values are: +- `KnowYourData` for collection policies +- `TrustContainer` for Endpoint DLP trust container ```yaml Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario @@ -75,10 +103,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: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode @@ -94,7 +122,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 @@ -145,7 +173,7 @@ 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 From c552964db17d874e656ecc2b953f69f5abd9e6ec Mon Sep 17 00:00:00 2001 From: brenle Date: Mon, 24 Mar 2025 12:59:56 -0400 Subject: [PATCH 16/21] Update example policy configuration in documentation --- exchange/exchange-ps/exchange/New-FeatureConfiguration.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index ba558ba296..9228efc8d6 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -37,13 +37,13 @@ To use this cmdlet in Security & Compliance PowerShell, you need to be assigned ### Example 1 ```powershell -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"}]}]' +New-FeatureConfiguration -Name "Collection policy for supported Copilots" -FeatureScenario KnowYourData -Mode Enable -ScenarioConfig '{"Activities":["UploadText","DownloadText"],"EnforcementPlanes":["CopilotExperiences","Browser"],"SensitiveTypeIds":["All"],"IsIngestionEnabled":true}' –Locations '[{"Workload":"Applications","Location":"52655","LocationSource":"SaaS","LocationType":"Individual","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]},{"Workload":"Applications","Location":"49baeafd-1a6b-4c58-be55-75ae6d1dff6a","LocationSource":"PurviewConfig","LocationType":"Group","Inclusions":[{"Type":"Tenant","Identity":"All","DisplayName":"All","Name":"All"}]}]' ``` -This example creates an enabled collection policy named "Browser collection policy for Microsoft Copilot" that: -- Includes UploadText activity for all supported classifiers +This example creates an enabled collection policy named "Collection policy for supported Copilots" that: +- Includes UploadText & DownloadText activity for all supported classifiers - Captures all AI prompts -- Includes Microsoft Copilot location, for all users & groups +- Includes Microsoft Copilot & Copilot Experiences locations, both scoped to all users & groups ### Example 2 ```powershell From c1cbc2c03f5a748ae7564d1ba434f46583e796ff Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Mon, 24 Mar 2025 11:41:22 -0700 Subject: [PATCH 17/21] New params per IM request --- .../exchange/Get-FeatureConfiguration.md | 58 ++++++++- .../exchange/New-FeatureConfiguration.md | 40 +++++- .../exchange/Remove-FeatureConfiguration.md | 38 +++++- .../exchange/Set-FeatureConfiguration.md | 117 +++++++++++++++++- 4 files changed, 240 insertions(+), 13 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 15c32b56e6..9ca3252922 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -20,9 +20,11 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX ``` -Get-FeatureConfiguration [-FeatureScenario] - [[-Identity] ] +Get-FeatureConfiguration [[-Identity] ] [-FeatureScenario] + [-All] [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] [-WhatIf] [] ``` @@ -56,7 +58,7 @@ The Identity policy specifies the Discovery policy that you want to view. You ca - GUID ```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter +Type: PolicyIdParameter Parameter Sets: (All) Aliases: Applicable: Security & Compliance @@ -72,7 +74,7 @@ Accept wildcard characters: False The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. ```yaml -Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario +Type: PolicyScenario Parameter Sets: (All) Aliases: Applicable: Security & Compliance @@ -84,6 +86,22 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -All +{{ Fill All Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Confirm This parameter is reserved for internal Microsoft use. @@ -100,6 +118,38 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -GeneralDiscovery +{{ Fill GeneralDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IrmDiscovery +{{ Fill IrmDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -WhatIf This parameter is reserved for internal Microsoft use. diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index 7b2d98f0d9..9b7933b253 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -20,9 +20,11 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX ``` -New-FeatureConfiguration [-Name] -Mode -FeatureScenario -ScenarioConfig +New-FeatureConfiguration [-Name] -Mode -FeatureScenario -ScenarioConfig [-Comment ] [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] [-Locations ] [-WhatIf] [] @@ -62,7 +64,7 @@ Accept wildcard characters: False The FeatureScenario parameter specifies the scenario for the Discovery policy. Currently, the only valid value is KnowYourData. ```yaml -Type: Microsoft.Office.CompliancePolicy.PolicyConfiguration.PolicyScenario +Type: PolicyScenario Parameter Sets: (All) Aliases: Applicable: Security & Compliance @@ -81,7 +83,7 @@ The Mode parameter specifies the action and notification level of the Discovery - Disable: The policy is disabled. ```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode +Type: PolicyMode Parameter Sets: (All) Aliases: Applicable: Security & Compliance @@ -144,6 +146,38 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -GeneralDiscovery +{{ Fill GeneralDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IrmDiscovery +{{ Fill IrmDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Locations The locations parameter specifies where the policy applies. diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md index 1a11ee88d5..6f31a5e5bd 100644 --- a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -20,8 +20,10 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX ``` -Remove-FeatureConfiguration [-Identity] +Remove-FeatureConfiguration [-Identity] [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] [-WhatIf] [] ``` @@ -48,7 +50,7 @@ The Identity policy specifies the Discovery policy that you want to remove. You - GUID ```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter +Type: PolicyIdParameter Parameter Sets: (All) Aliases: Applicable: Security & Compliance @@ -79,6 +81,38 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -GeneralDiscovery +{{ Fill GeneralDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IrmDiscovery +{{ Fill IrmDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -WhatIf The WhatIf switch simulates the actions of the command. You can use this switch to view the changes that would occur without actually applying those changes. You don't need to specify a value with this switch. diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index a57f471cda..557c3a4247 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -21,9 +21,86 @@ For information about the parameter sets in the Syntax section below, see [Excha ### Identity (Default) ``` -Set-FeatureConfiguration [-Identity] [-Locations ] [-Comment ] +Set-FeatureConfiguration [-Identity] [-Locations ] + [-Comment ] [-Confirm] - [-Mode ] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### AdaptiveScopeLocation +``` +Set-FeatureConfiguration [-Identity] + [-Comment ] + [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### TeamLocation +``` +Set-FeatureConfiguration [-Identity] + [-Comment ] + [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### OrganizationSegmentsDefault +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### InformationBarrierDefault +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### DisableRestrictiveRetentionParameterSet +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] + [-ScenarioConfig ] + [-WhatIf] + [] +``` + +### RetryDistributionParameterSet +``` +Set-FeatureConfiguration [-Identity] + [-Confirm] + [-GeneralDiscovery] + [-IrmDiscovery] + [-Mode ] [-ScenarioConfig ] [-WhatIf] [] @@ -51,7 +128,7 @@ The Identity policy specifies the Discovery policy that you want to modify. You - GUID ```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyIdParameter +Type: PolicyIdParameter Parameter Sets: (All) Aliases: Applicable: Security & Compliance @@ -98,6 +175,38 @@ Accept pipeline input: False Accept wildcard characters: False ``` +### -GeneralDiscovery +{{ Fill GeneralDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + +### -IrmDiscovery +{{ Fill IrmDiscovery Description }} + +```yaml +Type: SwitchParameter +Parameter Sets: (All) +Aliases: +Applicable: Security & Compliance + +Required: False +Position: Named +Default value: None +Accept pipeline input: False +Accept wildcard characters: False +``` + ### -Locations The locations parameter specifies where the policy applies. @@ -121,7 +230,7 @@ The Mode parameter specifies the action and notification level of the Discovery - Disable: The policy is disabled. ```yaml -Type: Microsoft.Office.CompliancePolicy.Tasks.PolicyMode +Type: PolicyMode Parameter Sets: (All) Aliases: Applicable: Security & Compliance From 5fb1e1e3535e60be31eccaa9e06cf0ef41baf04e Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Mon, 24 Mar 2025 11:57:31 -0700 Subject: [PATCH 18/21] New params to reserved Per IM request --- exchange/exchange-ps/exchange/Get-FeatureConfiguration.md | 6 +++--- exchange/exchange-ps/exchange/New-FeatureConfiguration.md | 4 ++-- .../exchange-ps/exchange/Remove-FeatureConfiguration.md | 4 ++-- exchange/exchange-ps/exchange/Set-FeatureConfiguration.md | 4 ++-- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 9ca3252922..0c2a81874e 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -87,7 +87,7 @@ Accept wildcard characters: False ``` ### -All -{{ Fill All Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter @@ -119,7 +119,7 @@ Accept wildcard characters: False ``` ### -GeneralDiscovery -{{ Fill GeneralDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter @@ -135,7 +135,7 @@ Accept wildcard characters: False ``` ### -IrmDiscovery -{{ Fill IrmDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index 9b7933b253..b42833e25e 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -147,7 +147,7 @@ Accept wildcard characters: False ``` ### -GeneralDiscovery -{{ Fill GeneralDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter @@ -163,7 +163,7 @@ Accept wildcard characters: False ``` ### -IrmDiscovery -{{ Fill IrmDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md index 6f31a5e5bd..989f971528 100644 --- a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -82,7 +82,7 @@ Accept wildcard characters: False ``` ### -GeneralDiscovery -{{ Fill GeneralDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter @@ -98,7 +98,7 @@ Accept wildcard characters: False ``` ### -IrmDiscovery -{{ Fill IrmDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index 557c3a4247..01ac81be43 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -176,7 +176,7 @@ Accept wildcard characters: False ``` ### -GeneralDiscovery -{{ Fill GeneralDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter @@ -192,7 +192,7 @@ Accept wildcard characters: False ``` ### -IrmDiscovery -{{ Fill IrmDiscovery Description }} +This parameter is reserved for internal Microsoft use. ```yaml Type: SwitchParameter From 4e155945f5f268bcbc9eb772cbcf46102ef6ffc2 Mon Sep 17 00:00:00 2001 From: brenle Date: Wed, 26 Mar 2025 23:24:10 -0400 Subject: [PATCH 19/21] Update Set-FeatureConfiguration.md --- .../exchange/Set-FeatureConfiguration.md | 109 ++++-------------- 1 file changed, 25 insertions(+), 84 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index 01ac81be43..cb8774b23a 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -9,19 +9,20 @@ 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 ] +Set-FeatureConfiguration -Identity [-Locations ] [-Comment ] [-Confirm] [-GeneralDiscovery] @@ -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) @@ -208,7 +149,7 @@ 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 @@ -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 From 9af094c85b6807aed35a1b8b4000bfd1c8dfce8d Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Thu, 27 Mar 2025 08:51:32 -0700 Subject: [PATCH 20/21] Update parameter sets in Set-FeatureConfiguration --- exchange/exchange-ps/exchange/Set-FeatureConfiguration.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index cb8774b23a..df23e33845 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -22,7 +22,7 @@ For information about the parameter sets in the Syntax section below, see [Excha ## SYNTAX ``` -Set-FeatureConfiguration -Identity [-Locations ] +Set-FeatureConfiguration [-Identity] [-Locations ] [-Comment ] [-Confirm] [-GeneralDiscovery] @@ -86,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 @@ -153,7 +153,7 @@ The locations parameter specifies where the feature configuration applies. ```yaml Type: String -Parameter Sets: Identity +Parameter Sets: (All) Aliases: Applicable: Security & Compliance From 1329544fad99abe8b653c3e6815b589c2281b021 Mon Sep 17 00:00:00 2001 From: Chris Davis Date: Thu, 27 Mar 2025 08:58:43 -0700 Subject: [PATCH 21/21] Minor Synopsis reformatting --- .../exchange-ps/exchange/Get-FeatureConfiguration.md | 10 ++++++---- .../exchange-ps/exchange/New-FeatureConfiguration.md | 10 ++++++---- .../exchange/Remove-FeatureConfiguration.md | 10 ++++++---- .../exchange-ps/exchange/Set-FeatureConfiguration.md | 10 ++++++---- 4 files changed, 24 insertions(+), 16 deletions(-) diff --git a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md index 86e7aee7e2..c0cd062a27 100644 --- a/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Get-FeatureConfiguration.md @@ -9,13 +9,15 @@ schema: 2.0.0 # Get-FeatureConfiguration ## SYNOPSIS -**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). +> [!NOTE] +> This cmdlet is currently available in Public Preview, isn't available in all organizations, and is subject to change. + Use the Get-FeatureConfiguration cmdlet to view Microsoft Purview feature configurations within your organization, including: -- Collection policies -- Endpoint DLP trust container + +- 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). diff --git a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md index 709b6feda9..c3dbf856db 100644 --- a/exchange/exchange-ps/exchange/New-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/New-FeatureConfiguration.md @@ -9,13 +9,15 @@ schema: 2.0.0 # New-FeatureConfiguration ## SYNOPSIS -**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). +> [!NOTE] +> This cmdlet is currently available in Public Preview, isn't available in all organizations, and is subject to change. + Use the New-FeatureConfiguration cmdlet to create Microsoft Purview feature configurations within your organization, including: -- Collection policies -- Endpoint DLP trust container + +- 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). diff --git a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md index 47ed8b508d..d2fc6efa33 100644 --- a/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Remove-FeatureConfiguration.md @@ -9,13 +9,15 @@ schema: 2.0.0 # Remove-FeatureConfiguration ## SYNOPSIS -**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). +> [!NOTE] +> This cmdlet is currently available in Public Preview, isn't available in all organizations, and is subject to change. + Use the Remove-FeatureConfiguration cmdlet to remove Microsoft Purview feature configurations within your organization, including: -- Collection policies -- Endpoint DLP trust container + +- 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). diff --git a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md index df23e33845..aef971fd05 100644 --- a/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md +++ b/exchange/exchange-ps/exchange/Set-FeatureConfiguration.md @@ -9,13 +9,15 @@ schema: 2.0.0 # Set-FeatureConfiguration ## SYNOPSIS -**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). +> [!NOTE] +> This cmdlet is currently available in Public Preview, isn't available in all organizations, and is subject to change. + Use the Set-FeatureConfiguration cmdlet to modify Microsoft Purview feature configurations within your organization, including: -- Collection policies -- Endpoint DLP trust container + +- 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).