Syntax
Open-VMConsoleWindow [-VM] <RemoteConsoleVM[]> [-FullScreen] [-Server <VIConnection[]>] [-UrlOnly] [-Confirm] [-WhatIf] [<CommonParameters>]Related Commands
Online VersionDetailed Description
This cmdlet opens a window to the virtual machine's console.Parameters
Name | Type | Description | Required? | Pipeline Input | Default Value |
---|---|---|---|---|---|
VM | RemoteConsoleVM[] | Specifies the virtual machine for which you want to open a remote console. Supports vCloud and vSphere virtual machines. | true | True (ByValue) | |
Confirm | SwitchParameter | If the value is $true, indicates that the cmdlet asks for confirmation before running. If the value is $false, the cmdlet runs without asking for user confirmation. | false | False | |
FullScreen | SwitchParameter | If specified, opens the virtual machine's console window in full-screen mode. | false | False | |
Server | VIConnection[] | Specifies the vCenter Server systems or cloud server instances on which you want to run the cmdlet. If no value is given to this parameter, the command runs on the default servers. For more information about default servers, see the description of the Connect-VIServer cmdlet. | false | False | |
UrlOnly | SwitchParameter | If specified, the cmdlet returns the URL for opening a console window to the virtual machine without actually opening the console window.
Note: The URL is valid for 30 seconds. After 30 seconds, the screen authentication ticket contained in the URL expires. | false | False | |
WhatIf | SwitchParameter | Indicates that the cmdlet is run only to display the changes that would be made and actually no objects are modified. | false | False |
Return Type
Notes
The VM parameter accepts powered-on vSphere and vCloud Director virtual machines. This cmdlet assumes that either VMware Remote Console, VMware Workstation or VMware Fusion is installed.Examples
-------------------------- Example 1 --------------------------
Get-CIVM myVM | Open-VMConsoleWindow -FullScreen
Opens the console of the specified virtual machine in full-screen mode.