< Back
New-AdminPowerAppEnvironment
Post
NAME New-AdminPowerAppEnvironment
SYNOPSIS
Creates an Environment.
SYNTAX
New-AdminPowerAppEnvironment [-ProvisionDatabase] [-CurrencyName <String>] [-LanguageName <String>] [-Templates
<String[]>] [-SecurityGroupId <String>] [-DomainName <String>] [-WaitUntilFinished <Boolean>] [-ApiVersion
<String>] [<CommonParameters>]
New-AdminPowerAppEnvironment [-DisplayName <String>] -LocationName <String> -EnvironmentSku <String>
[-ProvisionDatabase] [-CurrencyName <String>] [-LanguageName <String>] [-Templates <String[]>] [-SecurityGroupId
<String>] [-DomainName <String>] [-WaitUntilFinished <Boolean>] [-ApiVersion <String>] [<CommonParameters>]
DESCRIPTION
The New-AdminPowerAppEnvironment cmdlet creates a new Environment by the logged in user.
Api version 2019-05-01 adds the capability to create an environment with a database. The new commandline argument
'ProvisionDatabase'
acts as switch to indicate we need to create an environment with the database. If the switch is set, LanguageName
and CurrencyName arguments
are mandatory to pass while Templates,SecurityGroupId and DomainName are optional.
Use Get-Help New-AdminPowerAppEnvironment -Examples for more detail.
PARAMETERS
-DisplayName <String>
The display name of the new Environment.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-LocationName <String>
The location of the new Environment. Use Get-AdminPowerAppEnvironmentLocations to see the valid locations.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-EnvironmentSku <String>
The Environment type (Trial or Production).
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProvisionDatabase [<SwitchParameter>]
The switch to provision Cds database along with creating the environment. If set, LanguageName and
CurrencyName are mandatory to pass as arguments.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-CurrencyName <String>
The default currency for the database, use Get-AdminPowerAppCdsDatabaseCurrencies to get the supported values
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-LanguageName <String>
The default languages for the database, use Get-AdminPowerAppCdsDatabaseLanguages to get the support values
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Templates <String[]>
The list of templates used for provisioning. If it is null, an empty Common Data Service database will be
created
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecurityGroupId <String>
The Azure Active Directory security group object identifier to restrict database membership.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DomainName <String>
The domain name.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WaitUntilFinished <Boolean>
If set to true, the function will not return until provisioning the database is complete (as either a success
or failure)
Required? false
Position? named
Default value True
Accept pipeline input? false
Accept wildcard characters? false
-ApiVersion <String>
Required? false
Position? named
Default value 2019-05-01
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-AdminPowerAppEnvironment -DisplayName 'HQ Apps' -Location unitedstates -EnvironmentSku Trial
Creates a new Trial Environment in the United States with the display name 'HQ Apps'
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>New-AdminPowerAppEnvironment -DisplayName 'Asia Dev' -Location asia -EnvironmentSku Production
Creates a new Production Environment in Asia with the display name 'Asia Dev'
RELATED LINKS
SYNOPSIS
Creates an Environment.
SYNTAX
New-AdminPowerAppEnvironment [-ProvisionDatabase] [-CurrencyName <String>] [-LanguageName <String>] [-Templates
<String[]>] [-SecurityGroupId <String>] [-DomainName <String>] [-WaitUntilFinished <Boolean>] [-ApiVersion
<String>] [<CommonParameters>]
New-AdminPowerAppEnvironment [-DisplayName <String>] -LocationName <String> -EnvironmentSku <String>
[-ProvisionDatabase] [-CurrencyName <String>] [-LanguageName <String>] [-Templates <String[]>] [-SecurityGroupId
<String>] [-DomainName <String>] [-WaitUntilFinished <Boolean>] [-ApiVersion <String>] [<CommonParameters>]
DESCRIPTION
The New-AdminPowerAppEnvironment cmdlet creates a new Environment by the logged in user.
Api version 2019-05-01 adds the capability to create an environment with a database. The new commandline argument
'ProvisionDatabase'
acts as switch to indicate we need to create an environment with the database. If the switch is set, LanguageName
and CurrencyName arguments
are mandatory to pass while Templates,SecurityGroupId and DomainName are optional.
Use Get-Help New-AdminPowerAppEnvironment -Examples for more detail.
PARAMETERS
-DisplayName <String>
The display name of the new Environment.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-LocationName <String>
The location of the new Environment. Use Get-AdminPowerAppEnvironmentLocations to see the valid locations.
Required? true
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-EnvironmentSku <String>
The Environment type (Trial or Production).
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-ProvisionDatabase [<SwitchParameter>]
The switch to provision Cds database along with creating the environment. If set, LanguageName and
CurrencyName are mandatory to pass as arguments.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false
-CurrencyName <String>
The default currency for the database, use Get-AdminPowerAppCdsDatabaseCurrencies to get the supported values
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-LanguageName <String>
The default languages for the database, use Get-AdminPowerAppCdsDatabaseLanguages to get the support values
Required? false
Position? named
Default value
Accept pipeline input? true (ByPropertyName)
Accept wildcard characters? false
-Templates <String[]>
The list of templates used for provisioning. If it is null, an empty Common Data Service database will be
created
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-SecurityGroupId <String>
The Azure Active Directory security group object identifier to restrict database membership.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-DomainName <String>
The domain name.
Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false
-WaitUntilFinished <Boolean>
If set to true, the function will not return until provisioning the database is complete (as either a success
or failure)
Required? false
Position? named
Default value True
Accept pipeline input? false
Accept wildcard characters? false
-ApiVersion <String>
Required? false
Position? named
Default value 2019-05-01
Accept pipeline input? false
Accept wildcard characters? false
<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).
INPUTS
OUTPUTS
-------------------------- EXAMPLE 1 --------------------------
PS C:\\>New-AdminPowerAppEnvironment -DisplayName 'HQ Apps' -Location unitedstates -EnvironmentSku Trial
Creates a new Trial Environment in the United States with the display name 'HQ Apps'
-------------------------- EXAMPLE 2 --------------------------
PS C:\\>New-AdminPowerAppEnvironment -DisplayName 'Asia Dev' -Location asia -EnvironmentSku Production
Creates a new Production Environment in Asia with the display name 'Asia Dev'
RELATED LINKS