Add PpacApplicationUser

---

external help file: d365bap.tools-help.xml Module Name: d365bap.tools online version: schema: 2.0.0

Add-PpacApplicationUser

SYNOPSIS

Add application user to Power Platform environment.

SYNTAX

Add-PpacApplicationUser [-EnvironmentId] <String> [-ServicePrincipal] <String> [-Role] <String>
 [-ProgressAction <ActionPreference>] [<CommonParameters>]

DESCRIPTION

Enables the user to add an application user to the environment and assign a security role to it.

EXAMPLES

EXAMPLE 1

Add-PpacApplicationUser -EnvironmentId "env-123" -ServicePrincipal "00000000-0000-0000-0000-000000000000" -Role "System Administrator"

This will add an application user to the Power Platform environment. It will use the Service Principal with the ServicePrincipal "00000000-0000-0000-0000-000000000000" from Azure AD / Entra ID It will then assign the "System Administrator" security role to it in the Power Platform environment.

EXAMPLE 2

Add-PpacApplicationUser -EnvironmentId "env-123" -ServicePrincipal "My Service Principal" -Role "System Administrator"

This will add an application user to the Power Platform environment. It will use the Service Principal with the display name "My Service Principal" from Azure AD / Entra ID It will then assign the "System Administrator" security role to it in the Power Platform environment.

PARAMETERS

-EnvironmentId

The id of the environment that you want to work against.

Can be either the environment name, the environment GUID (PPAC) or the LCS environment ID.

Type: String
Parameter Sets: (All)
Aliases:

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

-ServicePrincipal

The Service Principal in Azure AD / Entra ID that you want to add as an application user to the Power Platform environment.

You can provide either the id (objectId) or display name of the Service Principal.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 2
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-Role

The security role that you want to assign to the application user.

Type: String
Parameter Sets: (All)
Aliases: RoleName

Required: True
Position: 3
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-ProgressAction

{{ Fill ProgressAction Description }}

Type: ActionPreference
Parameter Sets: (All)
Aliases: proga

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.

INPUTS

OUTPUTS

NOTES

Author: Mötz Jensen (@Splaxi)

RELATED LINKS