Edit

Share via

Disable-WmsVirtualDesktopRole

  • Reference
Module:
MultipointVdi

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.

Parameters

-Confirm

Prompts you for confirmation before running the cmdlet.

Type:SwitchParameter
Aliases:cf
Position:Named
Default value:False
Required: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
Required:False
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
Required:False
Accept pipeline input:False
Accept wildcard characters:False

Inputs

None

Outputs

None