11/11/2008

The Add-MDMGatewayServercmdlet adds a new Mobile Device Manager (MDM) Gateway Server to the System Center Mobile Device Manager (MDM) system.

You should run this cmdlet after you install MDM Gateway Server in the perimeter network and confirm that you can access the server for remote management. Even if you cannot access MDM Gateway Server remotely, or if MDM Gateway Server rejects the new configuration settings, this cmdlet adds the new MDM Gateway Server.

Syntax


Add-MDMGatewayServer [-Name] <String> -AdminInterface <UriAddressParameter> [-VPNAddress <IPAddressParameter>] [-AddressPool <SubnetAddressParameter[]>] [-PrimaryDNS <IPAddressParameter>] [-BackupDNS <IPAddressParameter>] [-PrimaryWINS <IPAddressParameter>] [-BackupWINS <IPAddressParameter>] [-TunnelDefaultGateway <IPAddressParameter>] [-WhatIf] [-Confirm] [<CommonParameters>]

Add-MDMGatewayServer [-Name] <String> -AdminInterface
<UriAddressParameter> [-VPNAddress
<IPAddressParameter>] [-AddressPool
<SubnetAddressParameter[]>] [-PrimaryDNS
<IPAddressParameter>] [-BackupDNS <IPAddressParameter>]
[-PrimaryWINS <IPAddressParameter>] [-BackupWINS
<IPAddressParameter>] [-TunnelDefaultGateway
<IPAddressParameter>] [-WhatIf] [-Confirm]
[<CommonParameters>]

Parameters

The following describes the Add-MDMGatewayServercmdlet parameters.

Name <String>: Specifies the name of the computer that is running MDM Gateway Server. The name parameter can be the fully qualified domain name (FQDN) or any other logical name.

AdminInterface <UriAddressParameter>: Specifies the Uniform Resource Identifier (URI) address for remote MDM Gateway Server management. This can be accessed within the company network and it points to the same internal IP address that you specified during MDM Gateway Server Setup. The format is protocol:address[:port]. For example, https://gateway01.com:443.

VPNAddress <IPAddressParameter>: Specifies the external IP address that a managed Windows Mobile device uses for remote virtual private network (VPN) connections to MDM Gateway Server.

AddressPool <SubnetAddressParameter[]>: Specifies an array of IP addresses that are used as the VPN address pool. An address may be in Classless InterDomain Routing (CIDR) format, for example, 196.168.0.0/24. Or, subnet mask format, for example, 196.168.0.0/255.255.255.0. You can enter multiple addresses, separated by commas.

PrimaryDNS <IPAddressParameter>: Specifies the primary Domain Name System (DNS) IP address that MDM Gateway Server provides to a managed device.

BackupDNS <IPAddressParameter>: Specifies the backup DNS IP address that MDM Gateway Server provides to a managed device.

PrimaryWINS <IPAddressParameter>: Specifies the primary Windows Internet Naming System (WINS) IP address that MDM Gateway Server provides to a managed device.

BackupWINS <IPAddressParameter>: Specifies the backup WINS IP address that MDM Gateway Server provides to a managed device.

TunnelDefaultGateway <IPAddressParameter>

Specifies the IP address of the default gateway for tunneled traffic that originates from managed devices. After you set this parameter, if MDM Gateway Server must use a default gateway address for tunneled network traffic from managed devices, MDM Gateway Server redirects the traffic to the IP address that you specify in this parameter. That is, MDM Gateway Server redirects the managed device traffic to the IP address instead of routing it to the default gateway address on MDM Gateway Server.

Note that MDM Gateway Server continues to use the local routing table for routing decisions for both tunneled and non-tunneled traffic. MDM Gateway Server uses the system default gateway for all non-tunneled traffic. If you do not specify the TunnelDefaultGatewayparameter, MDM Gateway Server uses the system default gateway for tunneled traffic.

WhatIf: Informs you of what changes would be made if the action were to be performed (the cmdlet is not executed).

Confirm: Prompts you for confirmation before the cmdlet executes.

CommonParameters: This cmdlet supports the common parameters: -Verbose, -Debug, -ErrorAction, -ErrorVariable, and -OutVariable. For more information, at the MDM Shell prompt, type get-help about_commonparameters.

Input Type

None

Output Type

The Add-MDMGatewayServercmdlet returns an MDMGatewayServerobject. To see all the properties for this object, at the MDM Shell prompt, type Get-MDMGatewayServer | Get-Member.

Examples

This Add-MDMGatewayServercommand example adds the gateway, Gateway1. The command specifies the remote gateway management address as https://gateway01.com on port 443.

	Copy Code
C:\PS>Add-MDMGatewayServer -Name Gateway1 -AdminInterface https://gateway01.com:443

This Add-MDMGatewayServercommand example adds MDM Gateway Server to the gateway, Gateway1. The command specifies the following:

AdminInterface	https://gateway01.com, port=443
VPNAddress	207.68.172.234
AddressPool	192.168.0.0/24
	192.168.1.0/255.255.255.0
	192.168.2.0/24
PrimaryDNS	10.70.1.12
BackupDNS	10.70.1.13
PrimaryWINS	10.70.1.14
BackupWINS	10.70.1.15

	Copy Code
C:\PS>Add-MDMGatewayServer -Name Gateway1 -AdminInterface https://gateway01.com:443 -VPNAddress 207.68.172.234 –AddressPool 192.168.0.0/24,192.168.1.0/255.255.255.0, 192.168.2.0/24 –PrimaryDNS 10.70.1.12 –BackupDNS 10.70.1.13 –PrimaryWINS 10.70.1.14 –BackupWINS 10.70.1.15

Copy Code

C:\PS>Add-MDMGatewayServer -Name Gateway1 -AdminInterface
https://gateway01.com:443 -VPNAddress 207.68.172.234 –AddressPool
192.168.0.0/24,192.168.1.0/255.255.255.0, 192.168.2.0/24
–PrimaryDNS 10.70.1.12 –BackupDNS 10.70.1.13 –PrimaryWINS
10.70.1.14 –BackupWINS 10.70.1.15

Cmdlet Help

To view this information online, at the MDM Shell prompt, type:

get-help Add-MDMGatewayServer -detailed, or get-help Add-MDMGatewayServer -full