New-SCGatewayRoleConfiguration
Creates a gateway role configuration.
Syntax
Default (Default)
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.
Parameter properties
| Type: | UInt64 |
| 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 |
-GreVipSubnets
The New-SCGatewayRoleConfiguration cmdlet creates a gateway role configuration in Virtual Machine Manager (VMM).
Parameter properties
| Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.SubnetVLan] |
| 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 |
-PublicIPAddresses
Note
From 2019 UR2, IPv6 addresses can also be added to this parameter.
Parameter properties
| Type: | System.Collections.Generic.List`1[Microsoft.SystemCenter.VirtualMachineManager.AllocatedIPAddress] |
| 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 |
-RedundantResourceCount
The New-SCGatewayRoleConfiguration cmdlet creates a gateway role configuration in Virtual Machine Manager (VMM).
Parameter properties
| Type: | UInt32 |
| 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 |
-VMMServer
Specifies a VMM server object.
Parameter properties
| Type: | ServerConnection |
| Default value: | None |
| Supports wildcards: | False |
| DontShow: | False |
Parameter sets
(All)
| Position: | Named |
| Mandatory: | False |
| Value from pipeline: | True |
| 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.