New-AzureStorSimpleVirtualDevice

Creates a virtual StorSimple device.

Note

The cmdlets referenced in this documentation are for managing legacy Azure resources that use Azure Service Manager (ASM) APIs. This legacy PowerShell module isn't recommended when creating new resources since ASM is scheduled for retirement. For more information, see Azure Service Manager retirement.

The Az PowerShell module is the recommended PowerShell module for managing Azure Resource Manager (ARM) resources with PowerShell.

Syntax

New-AzureStorSimpleVirtualDevice
   -VirtualDeviceName <String>
   -VirtualNetworkName <String>
   -SubNetName <String>
   [-StorageAccountName <String>]
   [-CreateNewStorageAccount]
   [-PersistAzureVMOnFailrue]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]
New-AzureStorSimpleVirtualDevice
   -VirtualDeviceName <String>
   -VirtualNetworkName <String>
   -SubNetName <String>
   -StorageAccountName <String>
   [-PersistAzureVMOnFailrue]
   [-Profile <AzureSMProfile>]
   [<CommonParameters>]

Description

The New-AzureStorSimpleVirtualDevice cmdlet creates a virtual StorSimple device. Specify a device name for the device. Specify virtual network and subnet details for the virtual network in the same subscription. The geo should match the geo in which the StorSimple resource is created. To use an existing storage account for this virtual device, specify the name. To create a new storage account for this virtual device, specify both the StorageAccountName and the CreateNewStorageAccount parameters.

Examples

Example 1: Create a virtual device with a new account and an existing network

PS C:\>New-AzureStorSimpleVirtualDevice -VirtualDeviceName "Contosodevice02" -VirtualNetworkName "Saas2vpn" -SubNetName "TenantSubnet" -StorageAccountName "AzureTenant04" -CreateNewStorageAccount
64e4c564-b0ac-44b0-afb4-adf28ac24ad0
VERBOSE: The create job is triggered successfully. Please use the command Get-AzureStorSimpleJob -InstanceId 64e4c564-b0ac-44b0-afb4-adf28ac24ad0 for tracking the job's status

This command creates a virtual device that uses a new storage account and an existing virtual network.

Example 2: Create a virtual device with an existing account and virtual network

PS C:\>New-AzureStorSimpleVirtualDevice -VirtualDeviceName "ContosoDevice07" -VirtualNetworkName "Saas2vpn" -SubNetName TenantSubnet -StorageAccountName azurecisbvtdnd
2a18a3b7-1ec6-481d-b95d-66ba8f67ceaf
VERBOSE: The create job is triggered successfully. Please use the command Get-AzureStorSimpleJob -InstanceId 2a18a3b7-1ec6-481d-b95d-66ba8f67ceaf for tracking the job's status

This command creates a virtual device that uses an existing storage account and an existing virtual network.

Parameters

-CreateNewStorageAccount

Indicates that this cmdlet creates a new storage account.

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

-PersistAzureVMOnFailrue

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

-Profile

Specifies the Azure profile from which this cmdlet reads. If you do not specify a profile, this cmdlet reads from the local default profile.

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

-StorageAccountName

Specifies the name of a storage account.

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

-SubNetName

Specifies the name of a virtual subnet.

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

-VirtualDeviceName

Specifies a name for the virtual device.

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

-VirtualNetworkName

Specifies the name of a virtual network.

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

Outputs

String

This cmdlet returns the ID of the job that creates the virtual device. You can use this ID to track the progress using the Get-AzureStorSimpleJob cmdlet.