New-AzAppServiceEnvironment

Reference

Module:: Az.Websites

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

Note

This is the previous version of our documentation. Please consult the most recent version for up-to-date information.

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

PS C:\> 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

PS C:\> 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
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
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
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
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-Name

The name of the app service environment.

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

-PassThru

Return the app service environment object.

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

-ResourceGroupName

The name of the resource group.

Type:	String
Position:	0
Default value:	None
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

-SubnetId

The subnet id.

Type:	String
Position:	Named
Default value:	None
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
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
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
Accept pipeline input:	False
Accept wildcard characters:	False

Inputs

None

Outputs

Object