Remove-RDServer

NAME Remove-RDServer



SYNOPSIS

Removes a server from a Remote Desktop deployment.





SYNTAX

Remove-RDServer [-Server] <String> [-Role] {RDS-CONNECTION-BROKER | RDS-VIRTUALIZATION | RDS-RD-SERVER | RDS-WEB-ACCESS | RDS-GATEWAY |

RDS-LICENSING} [[-ConnectionBroker] <String>] [-Force] [<CommonParameters>]





DESCRIPTION

The Remove-RDServer cmdlet removes a specified Remote Desktop Services (RDS) server from a Remote Desktop deployment. This cmdlet does not

uninstall a server or server role.





PARAMETERS

-ConnectionBroker [<String>]

Specifies the Remote Desktop Connection Broker (RDConnection Broker) server for a Remote Desktop deployment. If you do not specify a value,

the cmdlet uses the fully qualified domain name (FQDN) of the local computer.



Required? false

Position? 3

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Force [<SwitchParameter>]

Forces the command to run without asking for user confirmation.



Required? false

Position? named

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Role <String>

Specifies an RDS role service name. The acceptable values for this parameter are:



-- RDS-VIRTUALIZATION. Remote Desktop Virtualization Host (RD?? Virtualization Host).

-- RDS-RD-SERVER. Remote Desktop Session Host (RD?? Session Host).

-- RDS-CONNECTION-BROKER. RD?? Connection Broker.

-- RDS-WEB-ACCESS. Remote Desktop Web Access (RD?? Web?? Access).

-- RDS-GATEWAY. Remote Desktop Gateway (RD?? Gateway).

-- RDS-LICENSING. Remote Desktop Licensing (RD?? Licensing).



Required? true

Position? 2

Default value none

Accept pipeline input? false

Accept wildcard characters? false



-Server <String>

Specifies the FQDN of the server to be removed from the Remote Desktop deployment.



Required? true

Position? 1

Default value none

Accept pipeline input? false

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 (http://go.microsoft.com/fwlink/?LinkID=113216).



INPUTS









OUTPUTS

Null









Example 1: Remove an RD?? Virtualization Host



PS C:\\> Remove-RDServer -Server "RDVH.Contoso.com" -Role "RDS-VIRTUALIZATION" -ConnectionBroker "RDCB.Contoso.com"



This command removes an RDVirtualization Host server named RDVH.Contoso.com from the deployment that has an RDConnection Broker server named

RDCB.Contoso.com.







RELATED LINKS

Online Version: http://go.microsoft.com/fwlink/?LinkId=294247

Add-RDServer

Get-RDServer