Add-ConnectorsToPolicy

Adds the given connectors to the given group of the DLP policy.

Syntax

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.

Type:String
Position:4
Default value:2018-01-01
Required:False
Accept pipeline input:False
Accept wildcard characters: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).

Type:String
Position:2
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters: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
Type:Object[]
Position:3
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False

-PolicyName

The policy name (GUID).

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:True
Accept wildcard characters:False