Add-PowerAppsAccount
Adds a Power Platform account.
Syntax
Add-PowerAppsAccount
[-Audience <String>]
[-Endpoint <String>]
[-Username <String>]
[-Password <SecureString>]
[-TenantID <String>]
[-CertificateThumbprint <String>]
[-ClientSecret <String>]
[-ApplicationId <String>]
[<CommonParameters>]
Add-PowerAppsAccount
[-Username <String>]
[-Password <SecureString>]
[-TenantID <String>]
[-CertificateThumbprint <String>]
[-ClientSecret <String>]
[-ApplicationId <String>]
-AudienceOverride <String>
-AuthBaseUriOverride <String>
-FlowEndpointOverride <String>
-PowerAppsEndpointOverride <String>
-BapEndpointOverride <String>
-GraphEndpointOverride <String>
[-CdsOneEndpointOverride <String>]
[-PvaEndpointOverride <String>]
[<CommonParameters>]
Description
The Add-PowerAppsAccount cmdlet logins the user or application account and saves login information to the cache. Use 'Get-Help Add-PowerAppsAccount -Detailed' for descriptions of the parameters and example usages.
Examples
EXAMPLE 1
Add-PowerAppsAccount
Sign in to "prod" endpoint.
EXAMPLE 2
Add-PowerAppsAccount -Endpoint "prod" -Username "username@test.onmicrosoft.com" -Password "password"
Sign in to "prod" for user "username@test.onmicrosoft.com" by using the password "password."
EXAMPLE 3
Add-PowerAppsAccount `
-Endpoint "tip1" ` -TenantID 1a1fbe33-1ff4-45b2-90e8-4628a5112345 ` -ClientSecret ABCDE]NO_8:YDLp0J4o-:?=K9cmipuF@ ` -ApplicationId abcdebd6-e62c-4f68-ab74-b046579473ad Login to "tip1" for application abcdebd6-e62c-4f68-ab74-b046579473ad in tenant 1a1fbe33-1ff4-45b2-90e8-4628a5112345 by using client secret.
EXAMPLE 4
Add-PowerAppsAccount `
-Endpoint "tip1" ` -TenantID 1a1fbe33-1ff4-45b2-90e8-4628a5112345 ` -CertificateThumbprint 12345137C1B2D4FED804DB353D9A8A18465C8027 ` -ApplicationId 08627eb8-8eba-4a9a-8c49-548266012345 Login to "tip1" for application 08627eb8-8eba-4a9a-8c49-548266012345 in tenant 1a1fbe33-1ff4-45b2-90e8-4628a5112345 by using certificate.
EXAMPLE 5
Add-PowerAppsAccount `
-AudienceOverride: "https://service.powerapps.com/" ` -AuthBaseUriOverride: "https://login.microsoftonline.com" ` -BapEndpointOverride: "api.bap.microsoft.com" ` -CdsOneEndpointOverride: "api.cds.microsoft.com" ` -FlowEndpointOverride: "api.flow.microsoft.com" ` -GraphEndpointOverride: "graph.windows.net" ` -PowerAppsEndpointOverride: "api.powerapps.com" ` -PvaEndpointOverride: "powerva.microsoft.com" Login to an environment with the provided endpoints (examples above are for 'PROD')
EXAMPLE 6
$Inputs | Add-PowerAppsAccount
Login to an environment with the endpionts stored in a PS Custom Object variable; where its content is defined as: $Inputs = [pscustomobject]@{ ` "AudienceOverride" = "https://service.powerapps.com/"; ` "AuthBaseUriOverride" = "https://login.microsoftonline.com"; ` "BapEndpointOverride" = "api.bap.microsoft.com"; ` "CdsOneEndpointOverride" = "api.cds.microsoft.com"; ` "FlowEndpointOverride" = "api.flow.microsoft.com"; ` "GraphEndpointOverride" = "graph.windows.net"; ` "PowerAppsEndpointOverride" = "api.powerapps.com"; ` "PvaEndpointOverride" = "powerva.microsoft.com" }
EXAMPLE 7
Get-Content -Raw ".\OverrideEndpoints.json" | ConvertFrom-Json | Add-PowerAppsAccount
Login to an environment with the endpoints stored in 'OverrideEndpoints.json'; where its content is of the form: { "AudienceOverride": "https://service.powerapps.com/", "AuthBaseUriOverride": "https://login.microsoftonline.com", "BapEndpointOverride": "api.bap.microsoft.com", "CdsOneEndpointOverride": "api.cds.microsoft.com", "FlowEndpointOverride": "api.flow.microsoft.com", "GraphEndpointOverride": "graph.windows.net", "PowerAppsEndpointOverride": "api.powerapps.com", "PvaEndpointOverride": "powerva.microsoft.com" }
Parameters
-ApplicationId
The application ID.
Type: | String |
Position: | Named |
Default value: | 1950a258-227b-4e31-a9cf-717495945fc2 |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Audience
The service audience which is used for login.
Type: | String |
Position: | Named |
Default value: | Https://service.powerapps.com/ |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AudienceOverride
Must be provided if giving endpoint overrides; this audience will be used for all subsequent authentication calls, ignoring normally derived audiences.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-AuthBaseUriOverride
Must be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-BapEndpointOverride
Must be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CdsOneEndpointOverride
Can be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | Unsupported |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-CertificateThumbprint
The certificate thumbprint of the application.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ClientSecret
The client secret of the application.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | 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
Type: | String |
Position: | Named |
Default value: | Prod |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-FlowEndpointOverride
Must be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-GraphEndpointOverride
Must be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-Password
The password for the user.
Type: | SecureString |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PowerAppsEndpointOverride
Must be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-PvaEndpointOverride
Can be provided if giving endpoint overrides.
Type: | String |
Position: | Named |
Default value: | Unsupported |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-TenantID
The tenant Id of the user or application.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Username
The user name used for sign in.
Type: | String |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |