New-SCGatewayRoleConfiguration

Reference

Module:: VirtualMachineManager

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, 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