New-AzAppServiceEnvironment

Module:

Az.Websites

Creates an App Service Environment including the recommended Route Table and Network Security Group

Syntax

New-AzAppServiceEnvironment
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [[-Kind] <String>]
   -VirtualNetworkName <String>
   -SubnetName <String>
   -LoadBalancerMode <String>
   [-SkipRouteTable]
   [-SkipNetworkSecurityGroup]
   [-PassThru]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAppServiceEnvironment
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [[-Kind] <String>]
   -VirtualNetworkName <String>
   -SubnetName <String>
   [-PassThru]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAppServiceEnvironment
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [[-Kind] <String>]
   -SubnetId <String>
   -LoadBalancerMode <String>
   [-SkipRouteTable]
   [-SkipNetworkSecurityGroup]
   [-PassThru]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

New-AzAppServiceEnvironment
   [-ResourceGroupName] <String>
   [-Name] <String>
   [-Location] <String>
   [[-Kind] <String>]
   -SubnetId <String>
   [-PassThru]
   [-AsJob]
   [-DefaultProfile <IAzureContextContainer>]
   [-WhatIf]
   [-Confirm]
   [<CommonParameters>]

Description

The New-AzAppServiceEnvironment cmdlet creates an App Service Environment.

Examples

Example 1

New-AzAppServiceEnvironment -ResourceGroupName MyResourceGroup -Name MyAseV2 -Location WestEurope -VirtualNetworkName MyVirtualNetwork -SubnetName AseSubnet -LoadBalancerMode Internal

Create App Service Environment named MyAseV2 including recommended Route Table and Network Security Group

Example 2

New-AzAppServiceEnvironment -ResourceGroupName MyResourceGroup -Name MyAseV2 -Location WestEurope -VirtualNetworkName MyVirtualNetwork -SubnetName AseSubnet -LoadBalancerMode Internal -SkipRouteTable -SkipNetworkSecurityGroup

Create App Service Environment named MyAseV2 without recommended Route Table and Network Security Group. These should be create before or right after provisioning the App Service Environment to ensure a functional instance.

Parameters

-AsJob

Run cmdlet in the background and return a Job to track progress.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-DefaultProfile

The credentials, account, tenant, and subscription used for communication with Azure.

Type:	IAzureContextContainer
Aliases:	AzContext, AzureRmContext, AzureCredential
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-Kind

The version of the app service environment.

Type:	String
Accepted values:	ASEv2, ASEv3
Position:	3
Default value:	ASEv2
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-LoadBalancerMode

Load balancer mode of the app service environment.

Type:	String
Accepted values:	Internal, External
Position:	Named
Default value:	None
Required:	True
Accept pipeline input:	False
Accept wildcard characters:	False

-Location

The Location of the app service environment eg: West Europe.

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

-Name

The name of the app service environment.

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

-PassThru

Return the app service environment object.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-ResourceGroupName

The name of the resource group.

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

-SkipNetworkSecurityGroup

Do not create the recommended network security group as part of the app service environment.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SkipRouteTable

Do not create the recommended route table as part of the app service environment.

Type:	SwitchParameter
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

The subnet id.

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

-SubnetName

The subnet name. Used in combination with -VirtualNetworkName and must be in same resource group as ASE. If not, use -SubnetId

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

-VirtualNetworkName

The vNet name. Used in combination with -SubnetName and must be in same resource group as ASE. If not, use -SubnetId

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

-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

Object

Related Links

• Get-AzAppServiceEnvironment
• New-AzAppServiceEnvironmentInboundServices
• Remove-AzAppServiceEnvironment