New-AzNetworkCloudRackDefinitionObject

  • Reference
Module:
Az.NetworkCloud

Create an in-memory object for RackDefinition.

Syntax

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 -String "****" -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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-BareMetalMachineConfigurationData

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

Type:IBareMetalMachineConfigurationData[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-NetworkRackId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RackLocation

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RackSkuId

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

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters: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.

Type:IStorageApplianceConfigurationData[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Outputs

RackDefinition