New-SCGatewayRoleConfiguration

Creates a gateway role configuration.

Syntax

New-SCGatewayRoleConfiguration
   [-VMMServer <ServerConnection>]
   -RedundantResourceCount <UInt32>
   -GatewayCapacityKbps <UInt64>
   -PublicIPAddresses <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.AllocatedIPAddress]>
   -GreVipSubnets <System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.SubnetVLan]>
   [<CommonParameters>]

Description

The New-SCGatewayRoleConfiguration cmdlet creates a gateway role configuration in Virtual Machine Manager (VMM).

Examples

Example 1: Create gateway role configuration

PS C:\> $FabricRoleConfiguration = New-SCGatewayRoleConfiguration -GatewayCapacityKbps 1024000 -PublicIPAddresses $publicIPV4Address -RedundantResourceCount 1 -GreVipSubnets $SubnetVlansGreVip
PS C:\> $FabricRole = Set-SCFabricRole -FabricRole $FabricRole -GatewayConfiguration $FabricRoleConfiguration

The first command creates a gateway role configuration by using New-SCGatewayRoleConfiguration.

The second command configures the gateway fabric role with that configuration.

Parameters

-GatewayCapacityKbps

Specifies the gateway capacity in Kbps.

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

-GreVipSubnets

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.SubnetVLan]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-PublicIPAddresses

Note

From 2019 UR2 and later, IPv6 addresses can also be added to this parameter.

Type:System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.AllocatedIPAddress]
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False

-RedundantResourceCount

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

-VMMServer

Specifies a VMM server object.

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