Table of contents
TLS
TOC
Collapse the table of content
Expand the table of content

Disable-WmsVirtualDesktopRole

Brian Lich|Last Updated: 3/31/2017

SYNOPSIS

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
Parameter Sets: (All)
Aliases: cf

Required: False
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
Parameter Sets: (All)
Aliases: 

Required: False
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
Parameter Sets: (All)
Aliases: wi

Required: False
Position: Named
Default value: False
Accept pipeline input: False
Accept wildcard characters: False

CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see about_CommonParameters.

INPUTS

None.

OUTPUTS

None.

NOTES

Enable-WmsVirtualDesktopRole

© 2017 Microsoft