New-AzureStorSimpleNetworkConfig
Prepares a network configuration object.
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
Default (Default)
New-AzureStorSimpleNetworkConfig
-InterfaceAlias <String>
[-EnableIscsi <Boolean>]
[-EnableCloud <Boolean>]
[-Controller0IPv4Address <String>]
[-Controller1IPv4Address <String>]
[-IPv6Gateway <String>]
[-IPv4Gateway <String>]
[-IPv4Address <String>]
[-IPv6Prefix <String>]
[-IPv4Netmask <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>]
Description
The New-AzureStorSimpleNetworkConfig cmdlet prepares a network configuration object to pass to the Set-AzureStorSimpleDevice cmdlet. Set the Controller0IPAddress parameter and Controller1IPAddress parameter only on the Data0 interface. Data0 supports only three settings: Controller0IPAddress, Controller1IPAdress, and EnableIscsi.
Examples
Example 1: Configure a Data0 interface
PS C:\>New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49"
VERBOSE: ClientRequestId: 0621d220-a460-48ec-84ec-02a3a82f88b2_PS
IsIscsiEnabled : True
IsCloudEnabled :
Controller0IPv4Address : 10.67.64.48
Controller1IPv4Address : 10.67.64.49
IPv6Gateway :
IPv4Gateway :
IPv4Address :
IPv6Prefix :
IPv4Netmask :
InterfaceAlias : Data0
VERBOSE: Successfully created a StorSimple Network Configuration for interface Data0
This command creates network configuration for the Data0 interface. This command specifies the Controller0IPv4Address, Controller1IPv4Address, and EnableIscsi parameters. This cmdlet can configure Data0 for only these three parameters.
Example 2: Configure an interface other than Data0 an
PS C:\>New-AzureStorSimpleNetworkConfig -InterfaceAlias Data1 -EnableIscsi $True -EnableCloud $True -IPv6Gateway "db8:421e:9a8::a4:1c50" -IPv4Gateway "10.67.64.1" -IPv4Address "10.67.64.48" -IPv6Prefix "2001:db8:a::123/64" -IPv4Netmask "255.255.0.0"
VERBOSE: ClientRequestId: 3a15ff0e-b769-4329-9147-676b1e0acd7d_PS
IsIscsiEnabled : True
IsCloudEnabled : True
Controller0IPv4Address :
Controller1IPv4Address :
IPv6Gateway : db8:421e:9a8::a4:1c50
IPv4Gateway : 10.67.64.1
IPv4Address : 10.67.64.48
IPv6Prefix : 2001:db8:a::123/64
IPv4Netmask : 255.255.0.0
InterfaceAlias : Data1
VERBOSE: Successfully created a StorSimple Network Configuration for interface Data1
This command configures the Data1 interface.
Example 3: Modify a configuration for a device
PS C:\>$NetworkConfigData0 = New-AzureStorSimpleNetworkConfig -InterfaceAlias Data0 -EnableIscsi $True -Controller0IPv4Address "10.67.64.48" -Controller1IPv4Address "10.67.64.49"
$OnlineDevice = @(Get-AzureStorSimpleDevice | Where { $_.Status -eq "Online"})[0]
$UpdatedDetails = Set-AzureStorSimpleDevice -DeviceId $OnlineDevice.DeviceId -StorSimpleNetworkConfig $NetworkConfigData0
VERBOSE: ClientRequestId: 0f163163-5ad0-4635-a7b5-870d47297f66_PS
VERBOSE: Successfully created a StorSimple Network Configuration for interface Data0
VERBOSE: ClientRequestId: 552e4a6c-7006-4015-a20b-9def6428a85e_PS
VERBOSE: ClientRequestId: f31cc84c-bc8a-404a-9da6-4670a7999e75_PS
VERBOSE: 1 StorSimple device found!
VERBOSE: ClientRequestId: 545bc1a9-3c1b-4e50-89a6-9678aefe79e5_PS
VERBOSE: ClientRequestId: f114ad08-47f5-4fb8-8a01-1ea7f1ed1b98_PS
VERBOSE: About to configure the device : newDeviceName !
VERBOSE: ClientRequestId: 6afe7927-1c19-48d3-ac22-68148fd056b8_PS
VERBOSE: The task created for your Setup operation has completed successfully.
VERBOSE: ClientRequestId: 467c142c-90da-4d75-82a4-c114afce953d_PS
VERBOSE: Successfully updated configuration for device newDeviceName with id 865e68f6-1e71-47b6-80d5-15d3a23bd2b0
The first command creates a network configuration for the Data0 interface. This command specifies the Controller0IPv4Address, Controller1IPv4Address, and EnableIscsi parameters. The command stores the result in the $NetworkConfigData0 variable.
The second command uses the Get-AzureStorSimpleDevice cmdlet and the Where-Object core cmdlet to get an online StorSimple device, and then stores it in the $OnlineDevice variable.
The final command modifies the configuration for the device that has the specified device ID by using the Set-AzureStorSimpleDevice cmdlet. The command uses the configuration object that the current cmdlet created in the first command.
Parameters
-Controller0IPv4Address
Specifies the IPv4 address for controller 0. Specify this parameter only for the Data0 interface.
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 |
-Controller1IPv4Address
Specifies the IPv4 address for controller 1. Specify this parameter only for the Data0 interface.
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 |
-EnableCloud
Indicates whether to cloud-enable the interface.
Parameter properties
| Type: | Boolean |
| 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 |
-EnableIscsi
Indicates whether to enable Internet SCSI (ISCSI) for the interface.
Parameter properties
| Type: | Boolean |
| 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 |
-InterfaceAlias
Specifies the interface alias of interface for which this cmdlet supplies settings. Valid values are from Data0 to Data5.
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 |
-IPv4Address
Specifies the IPv4 address for the interface.
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 |
-IPv4Gateway
Specifies the IPv4 address of a gateway.
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 |
-IPv4Netmask
Specifies the IPv4 netmask for the interface.
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 |
-IPv6Gateway
Specifies the IPv6 gateway for the interface.
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 |
-IPv6Prefix
Specifies the IPv6 prefix for the interface.
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 |
-Profile
Specifies an Azure 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 |
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.
Inputs
None
Outputs
NetworkConfig
This cmdlet returns a NetworkConfig object that contains the following properties:
- IsIscsiEnabled (Boolean)
- IsCloudEnabled (Boolean)
- Controller0IPv4Address (IPAddress)
- Controller1IPv4Address (IPAddress)
- IPv6Gateway (IPAddress)
- IPv4Gateway (IPAddress)
- IPv4Address (IPAddress)
- IPv6Prefix (String)
- IPv4Netmask (IPAddress)
- InterfaceAlias (NetInterfaceId)