Remove-MDMGatewayServer

Article
02/10/2009

2/9/2009

The Remove-MDMGatewayServer cmdlet removes the specified Mobile Device Manager Gateway Server and all corresponding properties from MDM, and issues the Stop-MDMVPNService cmdlet on the server.

You should also remove the specified MDM Gateway Server from the perimeter network and the IP address of MDM Gateway Server from the Domain Name System (DNS) entry. Otherwise, the computer that is running MDM Gateway Server will continue to service virtual private network (VPN) connections.

Syntax

Remove-MDMGatewayServer [-Name] <string> [-confirm] [-whatif] [<CommonParameters>]

Parameters

The following describes the Remove-MDMGatewayServer cmdlet parameters.

Name <String>
Specifies the name of the MDM Gateway Server to remove. 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.

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 Remove-MDMGatewayServer cmdlet accepts a string through the pipeline, or an object that has the property, name that identifies the MDM Gateway Server.

Output Type

None

Examples

This Remove-MDMGatewayServer command example removes MDM Gateway Server, Gateway1, from MDM.

C:\PS>Remove-MDMGatewayServer -Name Gateway1

Cmdlet Help

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

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