Set-MDMGatewayServer

2/9/2009

The Set-MDMGatewayServer cmdlet updates the current settings for the specified Mobile Device Manager Gateway Server.

Syntax

Set-MDMGatewayServer [-Name] <string> [-AddressPool <SubnetAddressParameter[]>] [-AdminInterface <UriAddressParameter>] [-BackupDNS <IPAddressParameter>] [-BackupWINS <IPAddressParameter>] [-NewName <string>] [-PrimaryDNS <IPAddressParameter>] [-PrimaryWINS <IPAddressParameter>] [-TunnelDefaultGateway <IPAddressParameter>] [-VPNAddress <IPAddressParameter>] [-confirm] [-whatif] [<CommonParameters>]

Set-MDMGatewayServer [-Server] <MDMGatewayServer> [-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Set-MDMGatewayServer cmdlet parameters.

• Server <MDMGatewayServer>
  Accepts an MDMGatewayServer object.

• Name <String>
  Specifies the name of the computer that is running MDM Gateway Server. The name parameter can be the logical name or the fully qualified domain name (FQDN). If the value contains a space or other special characters, enclose the string in quotation marks.

• NewName <String>
  Specifies the new name for the computer. This can be the logical name or the fully qualified domain name (FQDN). 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. You can access this address within the company network. 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 Name Service (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

The Set-MDMGatewayServer cmdlet accepts through the pipeline an MDMGatewayServer object, a string, or an object that has the name property that identifies the computer that is running MDM Gateway Server. To see all the properties for this object, at the MDM Shell prompt, type Get-MDMGatewayServer | Get-Member.

Output Type

The Set-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 Set-MDMGatewayServer command example changes the name of MDM Gateway Server, Gateway1, to the name, Gateway001.

C:\PS>Set-MDMGatewayServer -Name Gateway1 -NewName Gateway001

This Set-MDMGatewayServer command example changes the settings for MDM Gateway Server, Gateway1 to the following:

C:\PS>Set-MDMGatewayServer -Name Gateway1 -AdminInterface https://gateway01.com:443 -NewName Gateway01 -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 Set-MDMGatewayServer -detailed, or get-help Set-MDMGatewayServer -full

See Also

Reference

Get-MDMGatewayServer
Remove-MDMGatewayServer
Set-MDMGlobalGatewayConfig
Start-MDMVPNService
Stop-MDMVPNService