About Help

Choose a topic from the list on the left or search for a specific topic. Choose a topic from the list or search for a specific topic.
Cmdlets  Providers  Aliases  Modules
 

UsingtheRunAsyncParameter

Runasync

VMware.VimAutomation.Core
 
 

SHORT DESCRIPTION

 
Specifying the RunAsync parameter indicates that the command is invoked asynchronously. In this mode, the command returns immediately without waiting for the task to complete and the output is a Task object.  
 

LONG DESCRIPTION

 
By default, vSphere PowerCLI cmdlets return only after completion of the requested tasks. If you want the cmdlet to return immediately, without waiting for the tasks to complete, you can specify the RunAsync parameter. In this case, the cmdlet returns Task objects instead of its usual output.  
 
The Status property of a returned Task object contains a snapshot of the task initial state. This state is not automatically updated and has one of the following values - Error, Queued, Running, and Success. To refresh the task status, pass the Task object to the Get-Task cmdlet. To interrupt a running task, use the Stop-Task cmdlet. If you want to observe the progress of a running task and wait for its completion before initiating other commands, use the Wait-Task cmdlet. 
 
	Example 1:  Running Remove-VM With and Without the RunAsync Parameter. 
 
		     Remove-VM $vmList   
 
		     //The command returns without an output when all virtual machines stored in the $vmList variable are                                        removed (simultaneously or not).  
 
		     Remove-VM $vmList -RunAsync 
 
		     //The command returns immediately and the output is one or more Task objects.  
 
In vSphere PowerCLI,  the RunAsync parameter affects only the cmdlets invocation and does not control whether the initiated tasks run consecutively or in parallel. For example, the virtual machines passed to the Remove-VM cmdlet might be removed simultaneously or consecutively depending on the vSphere PowerCLI internal design. 
 
To make sure that tasks initiated by a cmdlet do not run in parallel, run the cmdlet in a loop, each time applying it to a single object.  
 
	Example 2: Removing Virtual Machines Consecutively.  
 
		foreach ($vm in $vmList) 
		{ 
  			 Remove-VM $vm1 
		} 
 
 
Send feedback to docfeedback@vmware.com | Copyright (C) VMware, Inc. All rights reserved. Protected by one or more U.S. Patents listed at http://www.vmware.com/go/patents.