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
CreateNewStorageAccount
New-AzureStorSimpleVirtualDevice
-VirtualDeviceName <String>
-VirtualNetworkName <String>
-SubNetName <String>
[-StorageAccountName <String>]
[-CreateNewStorageAccount]
[-PersistAzureVMOnFailrue]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
UseExistingStorageAccount
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.
Parameter properties
| Type: | SwitchParameter |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CreateNewStorageAccount
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-PersistAzureVMOnFailrue
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.
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 |
-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.
Parameter properties
| Type: | AzureSMProfile |
| 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 |
-StorageAccountName
Specifies the name of a storage account.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
CreateNewStorageAccount
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-SubNetName
Specifies the name of a virtual subnet.
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 |
-VirtualDeviceName
Specifies a name for the virtual device.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | Name |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| Value from pipeline: | False |
| Value from pipeline by property name: | False |
| Value from remaining arguments: | False |
-VirtualNetworkName
Specifies the name of a virtual network.
Parameter properties
| Type: | String |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
| Aliases: | VNetName |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | True |
| 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
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.