Update-Tools

Synopsis

Upgrades the VMware Tools on the specified virtual machine guest OS.

Syntax

Update-Tools [-NoReboot] [[-Guest] <VMGuest[]>] [<CommonParameters>]
Update-Tools [-NoReboot] [[-VM] <VirtualMachine[]>] [[-Server] <VIServer[]>] [<CommonParameters>]

Related Commands

Mount-Tools
Dismount-Tools

Detailed Description

Upgrades the VMware Tools on the specified virtual machine guest OS. VMware Tools must be installed prior to updating it. After VMware Tools is updated, the virtual machine is restarted unless the NoReboot parameter is specified.

Parameters

NameDescriptionRequired?Pipeline InputDefault Value
NoRebootIndicate that you don't want to reboot the system after updating VMware Tools.falsefalse
GuestSpecify the guest operating systems on which you want to update the VMware Tools.falsetrue (ByValue)
VMProvide a list of the virtual machines whose VMware Tools you want to upgrade.falsetrue (ByValue)
ServerWhen virtual machine names are specified, this parameter indicates the servers which to search for the given names. If specific value is not specified, search is performed on the default server.falsefalse

Input Type

Return Type

None

Notes

On non-Windows operating systems, Update-Tools might not be able to perform
     automatic upgrade of VMware Tools. In such cases, the cmdlet only mounts t
    he VMware Tools installation drive and you must do the upgrade manually.

Examples

--------------  Example 1 --------------

C:\PS>Update-Tools 'myVM'


Updates the VMware Tools on the specified virtual machine. The virtual machine m
ust be powered on.




--------------  Example 2 --------------

C:\PS>Get-VMGuest 'myVM' | Update-Tools


Updates the VMware Tools on the virtual machine specified by its guest operating
 system. The virtual machine must be powered on.

Copyright © 1998 - 2009 VMware, Inc. All rights reserved.