Disable-Wms Virtual Desktop Role

Disables a Hyper-V virtual desktop role.

Syntax

Disable-WmsVirtualDesktopRole
       [-Restart]
       [-WhatIf]
       [-Confirm]
       [<CommonParameters>]

Description

The Disable-WmsVirtualDesktopRole cmdlet switches all stations from Virtual Desktop Infrastructure (VDI) mode to Remote Desktop Session Host (RDSH) mode, and then uninstalls the Hyper-V virtual desktop role. The system reboots to apply the changes if you specify the Restart parameter.

Examples

Example 1: Disable a virtual desktop

PS C:\> Disable-WmsVirtualDesktopRole -Restart

This command switches all stations from Remote Desktop Virtualization Host (RDVH) sessions to RDSH sessions, removes the Hyper-V virtual desktop role, and automatically restarts the computer to apply the changes.

Optional Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type: SwitchParameter
Aliases: cf
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False
-Restart

Indicates that this operation automatically restarts the computer to apply the change.

Type: SwitchParameter
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
-WhatIf

Shows what would happen if the cmdlet runs. The cmdlet is not run.

Type: SwitchParameter
Aliases: wi
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

Inputs

None.

Outputs

None.