Edit

Share via

New-AzNetworkCloudRackDefinitionObject

Module:
Az.NetworkCloud Module

Create an in-memory object for RackDefinition.

Syntax

Default (Default) 

New-AzNetworkCloudRackDefinitionObject
    -NetworkRackId <String>
    -RackSerialNumber <String>
    -RackSkuId <String>
    [-AvailabilityZone <String>]
    [-BareMetalMachineConfigurationData <IBareMetalMachineConfigurationData[]>]
    [-RackLocation <String>]
    [-StorageApplianceConfigurationData <IStorageApplianceConfigurationData[]>]
    [<CommonParameters>]

Description

Create an in-memory object for RackDefinition.

Examples

Example 1: Create an in-memory object for RackDefinition.

$password = ConvertTo-SecureString "********" -AsPlainText -Force
$bmmConfigurationData = New-AzNetworkCloudBareMetalMachineConfigurationDataObject -BmcCredentialsPassword $password -BmcCredentialsUsername "username" -BmcMacAddress "00:BB:CC:DD:EE:FF" -BootMacAddress "00:BB:CC:DD:EE:FF" -RackSlot 1 -SerialNumber "serialNumber" -MachineDetail "machineDetail" -MachineName "machineName"
$saConfigurationData = New-AzNetworkCloudStorageApplianceConfigurationDataObject -AdminCredentialsPassword $password -AdminCredentialsUsername "username" -RackSlot 1 -SerialNumber "serialNumber" -StorageApplianceName "storageApplianceName"

$object = New-AzNetworkCloudRackDefinitionObject -NetworkRackId "/subscriptions/subscriptionId/resourceGroups/resourceGroup/providers/Microsoft.Network/virtualNetworks/vNet/subnets/Subnet" -RackSerialNumber "aa5678" -RackSkuId "/subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/VNearEdge1_Compute_DellR750_16C2M" -AvailabilityZone "1" -BareMetalMachineConfigurationData $bmmConfigurationData -RackLocation "Foo Datacenter, Floor 3, Aisle 9, Rack 2" -StorageApplianceConfigurationData $saConfigurationData

Write-Host ($object | Format-List | Out-String)

AvailabilityZone                  : 1
BareMetalMachineConfigurationData : {{
                                      "bmcCredentials": {
                                        "password": "redacted",
                                        "username": "username"
                                      },
                                      "bmcMacAddress": "00:BB:CC:DD:EE:FF",
                                      "bootMacAddress": "00:BB:CC:DD:EE:FF",
                                      "machineDetails": "machineDetail",
                                      "machineName": "machineName",
                                      "rackSlot": 1,
                                      "serialNumber": "serialNumber"
                                    }}
NetworkRackId                     : /subscriptions/subscription/resourceGroups/resourceGroup/providers/Microsoft.Network/virtualNetworks/vNet/subnets/Subnet
RackLocation                      : Foo Datacenter, Floor 3, Aisle 9, Rack 2
RackSerialNumber                  : aa5678
RackSkuId                         : /subscriptions/subscriptionId/providers/Microsoft.NetworkCloud/rackSkus/VNearEdge1_Compute_DellR750_16C2M
StorageApplianceConfigurationData : {{
                                      "adminCredentials": {
                                        "password": "redacted",
                                        "username": "username"
                                      },
                                      "rackSlot": 1,
                                      "serialNumber": "serialNumber",
                                      "storageApplianceName": "storageApplianceName"
                                    }}

Create an in-memory object for RackDefinition.

Parameters

-AvailabilityZone

The zone name used for this rack when created. Availability zones are used for workload placement.

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

-BareMetalMachineConfigurationData

The unordered list of bare metal machine configuration. To construct, see NOTES section for BAREMETALMACHINECONFIGURATIONDATA properties and create a hash table.

Parameter properties

Type:

IBareMetalMachineConfigurationData[]

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

-NetworkRackId

The resource ID of the network rack that matches this rack definition.

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

-RackLocation

The free-form description of the rack's location.

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

-RackSerialNumber

The unique identifier for the rack within Network Cloud cluster. An alternate unique alphanumeric value other than a serial number may be provided if desired.

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

-RackSkuId

The resource ID of the sku for the rack being added.

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

-StorageApplianceConfigurationData

The list of storage appliance configuration data for this rack. To construct, see NOTES section for STORAGEAPPLIANCECONFIGURATIONDATA properties and create a hash table.

Parameter properties

Type:

IStorageApplianceConfigurationData[]

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.

Outputs

RackDefinition