Add-MDMGatewayServer

2/9/2009

The Add-MDMGatewayServer cmdlet adds a new Mobile Device Manager Gateway Server to the 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> [-AddressPool <SubnetAddressParameter[]>] -AdminInterface <UriAddressParameter> [-BackupDNS <IPAddressParameter>] [-BackupWINS <IPAddressParameter>] [-PrimaryDNS <IPAddressParameter>] [-PrimaryWINS <IPAddressParameter>] [-TunnelDefaultGateway <IPAddressParameter>] [-VPNAddress <IPAddressParameter>] [-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Add-MDMGatewayServer cmdlet 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. If the value contains a space or other special characters, enclose the string in quotation marks.

• 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.

• 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.

• 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 TunnelDefaultGateway parameter, MDM Gateway Server uses the system default gateway for tunneled traffic.

• 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.

• 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-MDMGatewayServer cmdlet returns an MDMGatewayServer object. To see all the properties for this object, at the MDM Shell prompt, type Get-MDMGatewayServer | Get-Member.

Examples

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

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

This Add-MDMGatewayServer command example adds the gateway, Gateway1. The command specifies the following:

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

See Also

Reference

Remove-MDMGatewayServer
Set-MDMGatewayServer
Get-MDMGatewayServer