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 statusThis 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 statusThis 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.