New-VCFEdgeCluster¶

Aliases¶

New-NSXEdgeCluster

Synopsis¶

Creates an NSX Edge cluster managed by SDDC Manager.

Syntax¶

New-VCFEdgeCluster [-json] <String> [-validate] [<CommonParameters>]

Description¶

The New-VCFEdgeCluster cmdlet creates an NSX Edge cluster managed by SDDC Manager.

Examples¶

Example 1¶

New-VCFEdgeCluster -json (Get-Content -Raw .\samples\nsx\nsx-edge-clusters\edgeClusterSpec.json)

This example shows how to create an NSX Edge cluster using a JSON specification file.

Sample JSON: NSX Edge cluster

{
  "edgeClusterName": "sfo-m01-ec01",
  "edgeClusterProfileType": "CUSTOM",
  "edgeClusterProfileSpec": {
    "bfdAllowedHop": 255,
    "bfdDeclareDeadMultiple": 3,
    "bfdProbeInterval": 1000,
    "edgeClusterProfileName": "sfo-m01-ecp01",
    "standbyRelocationThreshold": 30
  },
  "edgeClusterType": "NSX-T",
  "edgeRootPassword": "VMw@re1!VMw@re1!",
  "edgeAdminPassword": "VMw@re1!VMw@re1!",
  "edgeAuditPassword": "VMw@re1!VMw@re1!",
  "edgeFormFactor": "MEDIUM",
  "tier0ServicesHighAvailability": "ACTIVE_ACTIVE",
  "mtu": 8900,
  "asn": 65003,
  "tier0RoutingType": "EBGP",
  "tier0Name": "sfo-m01-ec01-t0-gw01",
  "tier1Name": "sfo-m01-ec01-t1-gw01",
  "edgeNodeSpecs": [
    {
      "edgeNodeName": "sfo-m01-en01.sfo.rainpole.io",
      "managementIP": "172.16.11.75/24",
      "managementGateway": "172.16.11.1",
      "edgeTepGateway": "172.27.13.1",
      "edgeTep1IP": "172.27.13.2/24",
      "edgeTep2IP": "172.27.13.3/24",
      "edgeTepVlan": 2713,
      "clusterId": "246555e3-7737-4427-9863-1b5a7bef5681",
      "interRackCluster": "false",
      "uplinkNetwork": [
        {
          "uplinkVlan": 2711,
          "uplinkInterfaceIP": "172.27.11.2/24",
          "peerIP": "172.27.11.1/24",
          "asnPeer": 65001,
          "bgpPeerPassword": "VMw@re1!"
        },
        {
          "uplinkVlan": 2712,
          "uplinkInterfaceIP": "172.27.12.2/24",
          "peerIP": "172.27.12.1/24",
          "asnPeer": 65001,
          "bgpPeerPassword": "VMw@re1!"
        }
      ]
    },
    {
      "edgeNodeName": "sfo-m01-en02.sfo.rainpole.io",
      "managementIP": "172.16.11.76/24",
      "managementGateway": "172.16.11.1",
      "edgeTepGateway": "172.27.13.1",
      "edgeTep1IP": "172.27.13.4/24",
      "edgeTep2IP": "172.27.13.5/24",
      "edgeTepVlan": 2713,
      "clusterId": "246555e3-7737-4427-9863-1b5a7bef5681",
      "interRackCluster": "false",
      "uplinkNetwork": [
        {
          "uplinkVlan": 2711,
          "uplinkInterfaceIP": "172.27.11.3/24",
          "peerIP": "172.27.11.1/24",
          "asnPeer": 65001,
          "bgpPeerPassword": "VMw@re1!"
        },
        {
          "uplinkVlan": 2712,
          "uplinkInterfaceIP": "172.27.12.3/24",
          "peerIP": "172.27.12.1/24",
          "asnPeer": 65001,
          "bgpPeerPassword": "VMw@re1!"
        }
      ]
    }
  ]
}

Example 2¶

New-VCFEdgeCluster -json (Get-Content -Raw .\samples\nsx\nsx-edge-clusters\edgeClusterSpec.json) -validate

This example shows how to validate the NSX Edge cluster JSON specification file.

Parameters¶

-json¶

Specifies the JSON specification to be used.

Type: String
Parameter Sets: (All)
Aliases:

Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False

-validate¶

Specifies to validate the JSON specification file.

Type: SwitchParameter
Parameter Sets: (All)
Aliases:

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

Common Parameters¶

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.