Add-ConnectorsToPolicy
Adds the given connectors to the given group of the DLP policy.
Syntax
Default (Default)
Add-ConnectorsToPolicy
[-PolicyName] <String>
[-Classification] <String>
[-Connectors] <Object[]>
[[-ApiVersion] <String>]
[<CommonParameters>]
Description
The Add-ConnectorsToPolicy takes the connectors as a list of objects and adds them to the specified group of the given DLP policy. If any of the connectors are already classified in a different group, they are moved to the specified group. Use Get-Help Add-ConnectorsToPolicy -Examples for more detail.
Examples
EXAMPLE 1
$connectorsToClassifyAsBusiness = @([pscustomobject]@{
id = "/providers/Microsoft.PowerApps/apis/shared_msnweather" name = "MSN Weather" type = "providers/Microsoft.PowerApps/apis" }) Add-ConnectorsToPolicy -PolicyName 7b914a18-ad8b-4f15-8da5-3155c77aa70a -Connectors $connectorsToClassifyAsBusiness -Classification Confidential Adds the MSN Weather connector to the Business group of the policy. If the connector is already in the policy, moves it to the Business group.
Parameters
-ApiVersion
The api version to call with. The default is 2018-01-01.
Parameter properties
| Type: | String |
| Default value: | 2018-01-01 |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 4 |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-Classification
The name of the group to which the connectors should be added. Allowed values are 'General', 'Confidential', and 'Blocked' (for Non-business, Business, and Blocked, respectively).
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 2 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-Connectors
The list of connectors to add to the policy. Each entry in the list is required to have 3 properties:
- id: The unique identifier of the connector. Examples:
- /providers/Microsoft.PowerApps/apis/shared_msnweather (for connectors)
- providers/Microsoft.ProcessSimple/operationGroups/DesktopFlow.Scripting (for Desktop Flow modules)
- type: The type of the connector:
- providers/Microsoft.PowerApps/apis (for connectors)
- Microsoft.ProcessSimple/operationGroups (for Desktop Flow modules)
- name: The friendly name of the connector, such as "MSN Weather" for the MSN Weather connector or "Active Directory" for the Active Directory Desktop Flow module
Parameter properties
| Type: | Object[] |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 3 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
-PolicyName
The policy name (GUID).
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | 1 |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | True |
| Value from remaining arguments: | False |
CommonParameters
This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.