See Also
The Set-MDMGatewayServercmdlet updates the current settings for the specified Mobile Device Manager (MDM) Gateway Server.
Syntax
Set-MDMGatewayServer [-Instance] <MDMGatewayServer> [-WhatIf] [-Confirm] [<CommonParameters>] Set-MDMGatewayServer [-Name] <String> [-NewName <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 Set-MDMGatewayServercmdlet parameters.
- Instance <MDMGatewayServer>
-
Accepts an instance of an MDMGatewayServerobject.
- Name <String>
-
Specifies the name of the computer that is running MDM Gateway Server. The nameparameter can be the logical name or the fully qualified domain name (FQDN).
- NewName <String>
-
Specifies the new name for the computer. This can be the logical name or the fully qualified domain name (FQDN).
- 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.
- 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 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 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
The Set-MDMGatewayServercmdlet accepts through the pipeline an MDMGatewayServerobject, a string, or an object that has the nameproperty 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-MDMGatewayServercmdlet returns an MDMGatewayServerobject. To see all the properties for this object, at the MDM Shell prompt, type Get-MDMGatewayServer | Get-Member.
Examples
This Set-MDMGatewayServercommand example changes the name of MDM Gateway Server, Gateway1, to the name, Gateway001.
 Copy Code
|
|
|---|---|
C:\PS>Set-MDMGatewayServer -name Gateway1 -newname Gateway001 |
|
This Set-MDMGatewayServercommand example changes the settings for MDM Gateway Server, Gateway1 to the following:
|
AdminInterface |
https://gateway01.com, port=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.60.1.12 |
|
BackupDNS |
10.70.60.1.13 |
|
PrimaryWINS |
10.70.60.1.14 |
|
BackupWINS |
10.70.60.1.15 |
|
Copy Code
|
|
|---|---|
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.60.1.12 –BackupDNS 10.70.60.1.13 –PrimaryWINS 10.70.60.1.14 –BackupWINS 10.70.60.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