powershellscripts.com

Tutorials  PowerShell Cmdlet Help for Update-Tools



NAME
Update-Tools

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

SYNTAX
Update-Tools [-NoReboot] [-RunAsync] [[-Guest] ] []

Update-Tools [-NoReboot] [-RunAsync] [[-VM] ] [[-Server] ] []


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


PARAMETERS
-NoReboot
Indicate that you don't want to reboot the system after updating VMware Tools. This parameter is supported only
for Windows operating systems. NoReboot passes the following set of options to the VMware Tools installer on t
he guest OS:

/s /v"/qn REBOOT=ReallySuppress"

However, the virtual machine might still reboot after updating VMware Tools, depending on the currently install
ed VMware Tools version, the VMware Tools version to which you want to upgrade, and the vCenter Center/ESX vers
ions.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-RunAsync
Indicate that the command returns immediately without waiting for the task to complete. In this mode, the outpu
t of the cmdlet is a Task object. For more information about the -RunAsync parameter run " help About_RunAsync"
in the vSphere PowerCLI console.

Required? false
Position? named
Default value
Accept pipeline input? false
Accept wildcard characters? false

-Guest
Specify the guest operating systems on which you want to update the VMware Tools.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? false

-VM
Provide a list of the virtual machines whose VMware Tools you want to upgrade.

Required? false
Position? 1
Default value
Accept pipeline input? true (ByValue)
Accept wildcard characters? true

-Server
Specify the vSphere servers on which you want to run the cmdlet. If no value is given to this parameter, the co
mmand runs on the default servers. For more information about default servers, see the description of Connect-V
IServer.

Required? false
Position? 2
Default value
Accept pipeline input? false
Accept wildcard characters? true


This cmdlet supports the common parameters: Verbose, Debug,
ErrorAction, ErrorVariable, WarningAction, WarningVariable,
OutBuffer and OutVariable. For more information, type,
"get-help about_commonparameters".

INPUTS



OUTPUTS
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 the VMware Tools installation drive and you must do the upgrade manually.

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

C:\PS>Update-Tools VM


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





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

C:\PS>Get-VMGuest VM | Update-Tools


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






RELATED LINKS
Online version: http://www.vmware.com/support/developer/PowerCLI/PowerCLI501/html/Update-Tools.html
Mount-Tools
Dismount-Tools
Wait-Tools