< Back

New-AzureStorSimpleVirtualDevice

Wed Jan 30, 2019 5:49 pm

NAME New-AzureStorSimpleVirtualDevice



SYNOPSIS

Creates a virtual StorSimple device.





SYNTAX

New-AzureStorSimpleVirtualDevice [-VirtualDeviceName] <System.String> [-VirtualNetworkName] <System.String> [-SubNetName] <System.String>

[-CreateNewStorageAccount] [[-StorageAccountName] <System.String>] [-PersistAzureVMOnFailrue] [-Profile

<Microsoft.Azure.Common.Authentication.Models.AzureProfile>] [<CommonParameters>]



New-AzureStorSimpleVirtualDevice [-VirtualDeviceName] <System.String> [-VirtualNetworkName] <System.String> [-SubNetName] <System.String>

[-StorageAccountName] <System.String> [-PersistAzureVMOnFailrue] [-Profile <Microsoft.Azure.Common.Authentication.Models.AzureProfile>]

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





PARAMETERS

-CreateNewStorageAccount <SwitchParameter>

Indicates that this cmdlet creates a new storage account.



Required? true

Position? 4

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-PersistAzureVMOnFailrue [<SwitchParameter>]





Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Profile [<Microsoft.Azure.Common.Authentication.Models.AzureProfile>]

Specifies an Azure profile.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-StorageAccountName [<System.String>]

Specifies the name of a storage account.



Required? false

Position? 5

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-SubNetName <System.String>

Specifies the name of a virtual subnet.



Required? true

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-VirtualDeviceName <System.String>

Specifies a name for the virtual device.



Required? true

Position? 1

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-VirtualNetworkName <System.String>

Specifies the name of a virtual network.



Required? true

Position? 2

Default value none

Accept pipeline input? false

Accept wildcard characters? false



<CommonParameters>

This cmdlet supports the common parameters: Verbose, Debug,

ErrorAction, ErrorVariable, WarningAction, WarningVariable,

OutBuffer, PipelineVariable, and OutVariable. For more information, see

about_CommonParameters (https:/go.microsoft.com/fwlink/?LinkID=113216).



INPUTS











OUTPUTS

String



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

Get-AzureStorSimpleJob cmdlet.





NOTES





Keywords: azure, azuresm, servicemanagement, management, service, store, storsimple



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.







RELATED LINKS

Set-AzureStorSimpleVirtualDevice

Get-AzureStorSimpleJob