Partilhar via

Add-PowerAppsAccount

Module:
Microsoft.PowerApps.Administration.PowerShell Module

Signs the specified user into the Power Platform.

Syntax

DerivedEndpoints 

Add-PowerAppsAccount
    [-Audience <String>]
    [-Endpoint <String>]
    [-Username <String>]
    [-Password <SecureString>]
    [-TenantID <String>]
    [-CertificateThumbprint <String>]
    [-ClientSecret <String>]
    [-ApplicationId <String>]
    [<CommonParameters>]

ProvidedEndpoints 

Add-PowerAppsAccount
    -AudienceOverride <String>
    -AuthBaseUriOverride <String>
    -FlowEndpointOverride <String>
    -PowerAppsEndpointOverride <String>
    -BapEndpointOverride <String>
    -GraphEndpointOverride <String>
    [-Username <String>]
    [-Password <SecureString>]
    [-TenantID <String>]
    [-CertificateThumbprint <String>]
    [-ClientSecret <String>]
    [-ApplicationId <String>]
    [-CdsOneEndpointOverride <String>]
    [-PvaEndpointOverride <String>]
    [<CommonParameters>]

Description

The Add-PowerAppsAccount cmdlet signs the specified user or application account and saves the authentication information to the cache. Use 'Get-Help Add-PowerAppsAccount -Detailed' for descriptions of the parameters and example usage.

Examples

EXAMPLE 1

Add-PowerAppsAccount

Signs the user in to the Power Platform using the supplied credentials from authentication prompt.

EXAMPLE 2

Add-PowerAppsAccount -Endpoint "prod" -Username "username@test.onmicrosoft.com" -Password "password"

Sign in to "prod" endpoint for user "username@test.onmicrosoft.com" by using the password "password."

EXAMPLE 3

Add-PowerAppsAccount -Endpoint "tip1" -TenantID aaaabbbb-0000-cccc-1111-dddd2222eeee -ClientSecret ABCDE\]NO_8:YDLp0J4o-:?=K9cmipuF@ -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444

Sign in to "tip1" for application 00001111-aaaa-2222-bbbb-3333cccc4444 in tenant aaaabbbb-0000-cccc-1111-dddd2222eeee by using a client secret.

EXAMPLE 4

Add-PowerAppsAccount -Endpoint "tip1" -TenantID aaaabbbb-0000-cccc-1111-dddd2222eeee -CertificateThumbprint 2345137C1B2D4FED804DB353D9A8A18465C8027 -ApplicationId 00001111-aaaa-2222-bbbb-3333cccc4444

Sign in to "tip1" for application 00001111-aaaa-2222-bbbb-3333cccc4444 in tenant aaaabbbb-0000-cccc-1111-dddd2222eeee by using certificate.

Parameters

-ApplicationId

The application ID.

Parameter properties

Type:String
Default value:1950a258-227b-4e31-a9cf-717495945fc2
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Audience

The service audience which is used for sign in.

Parameter properties

Type:String
Default value:Https://service.powerapps.com/
Supports wildcards:False
DontShow:False

Parameter sets

DerivedEndpoints
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-AudienceOverride

Must be provided if giving endpoint overrides; this audience will be used for all subsequent authentication calls, ignoring normally derived audiences.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-AuthBaseUriOverride

Must be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-BapEndpointOverride

Must be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CdsOneEndpointOverride

Can be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:Unsupported
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-CertificateThumbprint

The certificate thumbprint of the application.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-ClientSecret

The client secret of the application.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Endpoint

The service endpoint which to call. The value can be "prod", "preview", "tip1", "tip2", "usgov", "dod", "usgovhigh", or "china". Can't be used if providing endpoint overrides.

Parameter properties

Type:String
Default value:Prod
Supports wildcards:False
DontShow:False

Parameter sets

DerivedEndpoints
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-FlowEndpointOverride

Must be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-GraphEndpointOverride

Must be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-Password

The password for the user.

Parameter properties

Type:SecureString
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-PowerAppsEndpointOverride

Must be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:True
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-PvaEndpointOverride

Can be provided if giving endpoint overrides.

Parameter properties

Type:String
Default value:Unsupported
Supports wildcards:False
DontShow:False

Parameter sets

ProvidedEndpoints
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:True
Value from remaining arguments:False

-TenantID

The tenant ID of the user or application.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
Value from remaining arguments:False

-Username

The user name used for sign in.

Parameter properties

Type:String
Default value:None
Supports wildcards:False
DontShow:False

Parameter sets

(All)
Position:Named
Mandatory:False
Value from pipeline:False
Value from pipeline by property name:False
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.