New-AzElasticSan
Syntax
CreateExpanded (Default)
New-AzElasticSan
-Name <String>
-ResourceGroupName <String>
-Location <String>
-SkuName <String>
[-SubscriptionId <String>]
[-AutoScalePolicyEnforcement <String>]
[-CapacityUnitScaleUpLimitTiB <Int64>]
[-IncreaseCapacityUnitByTiB <Int64>]
[-UnusedSizeTiB <Int64>]
[-AvailabilityZone <String[]>]
[-BaseSizeTiB <Int64>]
[-ExtendedCapacitySizeTiB <Int64>]
[-PublicNetworkAccess <String>]
[-SkuTier <String>]
[-Tag <Hashtable>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
CreateViaIdentityExpanded
New-AzElasticSan
-InputObject <IElasticSanIdentity>
-Location <String>
-SkuName <String>
[-AutoScalePolicyEnforcement <String>]
[-CapacityUnitScaleUpLimitTiB <Int64>]
[-IncreaseCapacityUnitByTiB <Int64>]
[-UnusedSizeTiB <Int64>]
[-AvailabilityZone <String[]>]
[-BaseSizeTiB <Int64>]
[-ExtendedCapacitySizeTiB <Int64>]
[-PublicNetworkAccess <String>]
[-SkuTier <String>]
[-Tag <Hashtable>]
[-DefaultProfile <PSObject>]
[-AsJob]
[-NoWait]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Description
Examples
Example 1: Create an Elastic SAN
New-AzElasticSan -ResourceGroupName myresourcegroup -Name myelasticsan -BaseSizeTib 1 -ExtendedCapacitySizeTib 6 -Location eastus -SkuName 'Premium_LRS' -AvailabilityZone 1 -Tag @{tag1="value1";tag2="value2"} -AutoScalePolicyEnforcement Enabled -CapacityUnitScaleUpLimitTiB 30 -IncreaseCapacityUnitByTiB 2 -UnusedSizeTiB 6
AutoScalePolicyEnforcement : Enabled
AvailabilityZone : {1}
BaseSizeTiB : 1
CapacityUnitScaleUpLimitTiB : 30
ExtendedCapacitySizeTiB : 6
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.ElasticSan/elasticSans/myelasticsan
IncreaseCapacityUnitByTiB : 2
Location : eastus2euap
Name : myelasticsan
PrivateEndpointConnection :
ProvisioningState : Succeeded
PublicNetworkAccess :
ResourceGroupName : myresourcegroup
SkuName : Premium_LRS
SkuTier :
SystemDataCreatedAt : 10/29/2025 3:07:36 AM
SystemDataCreatedBy : example@microsoft.com
SystemDataCreatedByType : User
SystemDataLastModifiedAt : 10/29/2025 3:07:36 AM
SystemDataLastModifiedBy : example@microsoft.com
SystemDataLastModifiedByType : User
Tag : {
"tag1": "value1",
"tag2": "value2"
}
TotalIops : 5000
TotalMBps : 200
TotalSizeTiB : 7
TotalVolumeSizeGiB : 0
Type : Microsoft.ElasticSan/ElasticSans
UnusedSizeTiB : 6
VolumeGroupCount : 0
This command creates an Elastic SAN.
Example 2: Create an Elastic SAN with default base size and extended capacity size
New-AzElasticSan -ResourceGroupName myresourcegroup -Name myelasticsan -Location eastus -SkuName 'Premium_LRS' -Tag @{tag1="value1";tag2="value2"}
AutoScalePolicyEnforcement :
AvailabilityZone : {1}
BaseSizeTiB : 20
CapacityUnitScaleUpLimitTiB :
ExtendedCapacitySizeTiB : 0
Id : /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myresourcegroup/providers/Microsoft.ElasticSan/elasticSans/myelasticsan
IncreaseCapacityUnitByTiB :
Location : eastus2euap
Name : myelasticsan
PrivateEndpointConnection :
ProvisioningState : Succeeded
PublicNetworkAccess :
ResourceGroupName : myresourcegroup
SkuName : Premium_LRS
SkuTier :
SystemDataCreatedAt : 10/29/2025 6:00:04 AM
SystemDataCreatedBy : example@microsoft.com
SystemDataCreatedByType : User
SystemDataLastModifiedAt : 10/29/2025 6:00:04 AM
SystemDataLastModifiedBy : example@microsoft.com
SystemDataLastModifiedByType : User
Tag : {
}
TotalIops : 100000
TotalMBps : 4000
TotalSizeTiB : 20
TotalVolumeSizeGiB : 0
Type : Microsoft.ElasticSan/ElasticSans
UnusedSizeTiB :
VolumeGroupCount : 0
This command creates an Elastic SAN.
Parameters
-AsJob
Run the command as a job
Parameter properties
Type: SwitchParameter
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
-AutoScalePolicyEnforcement
Enable or Disable scale up setting on Elastic San Appliance.
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
-AvailabilityZone
Logical zone for Elastic San resource; example: ["1"].
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
-BaseSizeTiB
Base size of the Elastic San appliance in TiB.
Default value is 20.
Parameter properties
Type: Int64
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
-CapacityUnitScaleUpLimitTiB
Maximum scale up size on Elastic San appliance in TiB.
Parameter properties
Type: Int64
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
-Confirm
Prompts you for confirmation before running the cmdlet.
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False Aliases: cf
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-DefaultProfile
The DefaultProfile parameter is not functional.
Use the SubscriptionId parameter when available if executing the cmdlet against a different subscription.
Parameter properties
Type: PSObject
Default value: None Supports wildcards: False DontShow: False Aliases: AzureRMContext, AzureCredential
Parameter sets
(All)
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-ExtendedCapacitySizeTiB
Extended size of the Elastic San appliance in TiB.
Default value is 0.
Parameter properties
Type: Int64
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
-IncreaseCapacityUnitByTiB
Unit to increase Capacity Unit on Elastic San appliance in TiB.
Parameter properties
Type: Int64
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
Identity Parameter
CreateViaIdentityExpanded
Position: Named Mandatory: True Value from pipeline: True Value from pipeline by property name: False Value from remaining arguments: False
-Location
The geo-location where the resource lives
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Name
The name of the ElasticSan.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False Aliases: ElasticSanName
Parameter sets
CreateExpanded
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-NoWait
Run the command asynchronously
Parameter properties
Type: SwitchParameter
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
-PublicNetworkAccess
Allow or disallow public network access to ElasticSan.
Value is optional but if passed in, must be 'Enabled' or 'Disabled'.
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
-ResourceGroupName
The name of the resource group.
The name is case insensitive.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
CreateExpanded
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-SkuName
The sku name.
Parameter properties
Type: String
Default value: None Supports wildcards: False DontShow: False
Parameter sets
(All)
Position: Named Mandatory: True Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-SkuTier
The sku tier.
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
-SubscriptionId
The ID of the target subscription.
Parameter properties
Type: String
Default value: (Get-AzContext).Subscription.Id Supports wildcards: False DontShow: False
Parameter sets
CreateExpanded
Position: Named Mandatory: False Value from pipeline: False Value from pipeline by property name: False Value from remaining arguments: False
-Tag
Resource tags.
Parameter properties
Type: Hashtable
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
-UnusedSizeTiB
Unused size on Elastic San appliance in TiB.
Parameter properties
Type: Int64
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
-WhatIf
Shows what would happen if the cmdlet runs.
The cmdlet is not run.
Parameter properties
Type: SwitchParameter
Default value: None Supports wildcards: False DontShow: False Aliases: wi
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 .
Outputs
