Remove-RASGateway
NAME
Remove-RASGateway
SYNOPSIS
Removes a RAS Secure Gateway server from a site.
SYNTAX
Remove-RASGateway [-Id] <uint> [-NoUninstall <SwitchParameter>] [<CommonParameters>]
Remove-RASGateway [-Id] <uint> -Password <SecureString> -Username <string> [<CommonParameters>]
Remove-RASGateway [-InputObject] <Gateway> [-NoUninstall <SwitchParameter>] [<CommonParameters>]
Remove-RASGateway [-InputObject] <Gateway> -Password <SecureString> -Username <string> [<CommonParameters>]
Remove-RASGateway [-Server] <string> [[-SiteId] <uint>] [-NoUninstall <SwitchParameter>] [<CommonParameters>]
Remove-RASGateway [-Server] <string> [[-SiteId] <uint>] -Password <SecureString> -Username <string> [<CommonParameters>]
DESCRIPTION
Removes a specified RAS Secure Gateway server from a site.
The cmdlet will also uninstall the Gateway software from the server by default.
You can optionally keep the Gateway software by including the -NoUninstall parameter.
PARAMETERS
-Server <string> The name of a Secure Gateway server to remove from the site.
The name can be either FQDN or IP address, but you have to enter the actual name this server has in the RAS farm.
Required? true
Position? 0
Default value
Accept pipeline input? false
Accept wildcard characters? false-SiteId <uint> Site ID from which to remove the specified Secure Gateway.
If the parameter is omitted, the site ID of the Licensing Server will be used.
Required? false
Position? 1
Default value 0
Accept pipeline input? false
Accept wildcard characters? false-Id <uint> The ID of the Secure Gateway to remove.
To obtain the ID of a Secure Gateway, use the Get-RASGateway cmdlet.
Required? true
Position? 0
Default value 0
Accept pipeline input? false
Accept wildcard characters? false-NoUninstall <SwitchParameter> When this parameter is included, the Secure Gateway software will not be removed from the server.
If you want to remove the software, omit this parameter.
When removing the software, your RAS admin credentials will be used to remotely execute the uninstaller on the target server.
You can specify different credentials if needed using the Username and Password parameters.
Required? false
Position? named
Default value False
Accept pipeline input? false
Accept wildcard characters? false-Username <string> An administrator account name to remotely uninstall the Secure Gateway software from the server.
If this parameter is omitted, your RAS admin username (and password) will be used.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false-Password <SecureString> The password of the account specified in the Username parameter.
Required? true
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false-InputObject <Gateway> The Secure Gateway object to remove from a site.
To obtain an object of type Gateway representing a Secure Gateway, use the Get-RASGateway cmdlet.
Required? true
Position? 0
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false<CommonParameters>
This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer, PipelineVariable, and OutVariable. For more information, see
about_CommonParameters documentation. INPUTS
OUTPUTS
-none-
EXAMPLES
---------- EXAMPLE 1 ----------
Remove-RASGateway "server.company.dom"
Removes the specified RAS Secure Gateway server from the Licensing Server site (default).
To remove the server from a specific site, specify the -SiteId parameter.
The RAS Secure Gateway software will be uninstalled from the server by default. The uninstaller will be remotely executed using your RAS admin credentials (default). ---------- EXAMPLE 2 ----------
Remove-RASGateway -Server "server.company.dom" -SiteId 3 -Username "myname" -Password $pass
Removes the specified RAS Secure Gateway server from the specified site.
The RAS Secure Gateway software will be remotely uninstalled from the server using the specified credentials. ---------- EXAMPLE 3 ----------
Remove-RASGateway -Id "6" -NoUninstall
Removes a RAS Secure Gateway specified by ID. To obtain the ID of a RAS Secure Gateway, use the Get-RASGateway cmdlet.
The RAS Secure Gateway software will not be uninstalled from the server. ---------- EXAMPLE 4 ----------
Remove-RASGateway -InputObject $Gateway
Removes a RAS Secure Gateway. The $Gateway variable must contain the gateway object to be removed.
To obtain a Gateway object representing a Gateway, use the Get-RASGateway cmdlet ---------- EXAMPLE 5 ----------
Get-RASGateway -Id 11 | Remove-RASGateway
Removes the RAS Secure Gateway, which is identified by an object obtained from the pipeline output.
RELATED LINKS
Last updated