VMware vSphere Automation SDK for .NET 7.0.0.1
vmware::vcenter::vm::Tools Interface Reference

The Tools interface provides methods for managing VMware Tools in the guest operating system. More...

Inherited by vmware::vcenter::vm::ToolsStub.

List of all members.

Public Member Functions

vmware.vcenter.vm.ToolsTypes.Info Get (string vm)
 Get the properties of VMware Tools.
vmware.vcenter.vm.ToolsTypes.Info Get (string vm, global::System.Action< vmware.vapi.std.Progress > _progress, vmware.vapi.bindings.client.InvocationConfig _invocationConfig)
 Get the properties of VMware Tools.
global::System.Threading.Tasks.Task
< vmware.vcenter.vm.ToolsTypes.Info
GetAsync (string vm)
 Get the properties of VMware Tools.
global::System.Threading.Tasks.Task
< vmware.vcenter.vm.ToolsTypes.Info
GetAsync (string vm, global::System.Action< vmware.vapi.std.Progress > _progress, vmware.vapi.bindings.client.InvocationConfig _invocationConfig)
 Get the properties of VMware Tools.
void Update (string vm, vmware.vcenter.vm.ToolsTypes.UpdateSpec spec)
 Update the properties of VMware Tools.
void Update (string vm, vmware.vcenter.vm.ToolsTypes.UpdateSpec spec, global::System.Action< vmware.vapi.std.Progress > _progress, vmware.vapi.bindings.client.InvocationConfig _invocationConfig)
 Update the properties of VMware Tools.
global::System.Threading.Tasks.Task UpdateAsync (string vm, vmware.vcenter.vm.ToolsTypes.UpdateSpec spec)
 Update the properties of VMware Tools.
global::System.Threading.Tasks.Task UpdateAsync (string vm, vmware.vcenter.vm.ToolsTypes.UpdateSpec spec, global::System.Action< vmware.vapi.std.Progress > _progress, vmware.vapi.bindings.client.InvocationConfig _invocationConfig)
 Update the properties of VMware Tools.
void Upgrade (string vm, string commandLineOptions)
 Begins the Tools upgrade process.
void Upgrade (string vm, string commandLineOptions, global::System.Action< vmware.vapi.std.Progress > _progress, vmware.vapi.bindings.client.InvocationConfig _invocationConfig)
 Begins the Tools upgrade process.
global::System.Threading.Tasks.Task UpgradeAsync (string vm, string commandLineOptions)
 Begins the Tools upgrade process.
global::System.Threading.Tasks.Task UpgradeAsync (string vm, string commandLineOptions, global::System.Action< vmware.vapi.std.Progress > _progress, vmware.vapi.bindings.client.InvocationConfig _invocationConfig)
 Begins the Tools upgrade process.

Detailed Description

The Tools interface provides methods for managing VMware Tools in the guest operating system.

This interface was added in vSphere API 7.0.0.


Member Function Documentation

vmware.vcenter.vm.ToolsTypes.Info vmware::vcenter::vm::Tools::Get ( string  vm)

Get the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
Returns:
VMware Tools properties.

Implemented in vmware::vcenter::vm::ToolsStub.

vmware.vcenter.vm.ToolsTypes.Info vmware::vcenter::vm::Tools::Get ( string  vm,
global::System.Action< vmware.vapi.std.Progress >  _progress,
vmware.vapi.bindings.client.InvocationConfig  _invocationConfig 
)

Get the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
_progressProgress notification call back
_invocationConfigConfiguration for the method invocation
Returns:
VMware Tools properties.

Implemented in vmware::vcenter::vm::ToolsStub.

global::System.Threading.Tasks.Task<vmware.vcenter.vm.ToolsTypes.Info> vmware::vcenter::vm::Tools::GetAsync ( string  vm,
global::System.Action< vmware.vapi.std.Progress >  _progress,
vmware.vapi.bindings.client.InvocationConfig  _invocationConfig 
)

Get the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
_progressProgress notification call back
_invocationConfigConfiguration for the method invocation
Returns:
VMware Tools properties.

Implemented in vmware::vcenter::vm::ToolsStub.

global::System.Threading.Tasks.Task<vmware.vcenter.vm.ToolsTypes.Info> vmware::vcenter::vm::Tools::GetAsync ( string  vm)

Get the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
Returns:
VMware Tools properties.

Implemented in vmware::vcenter::vm::ToolsStub.

void vmware::vcenter::vm::Tools::Update ( string  vm,
vmware.vcenter.vm.ToolsTypes.UpdateSpec  spec 
)

Update the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.InvalidArgumentif the Tools.UpdateSpec.upgradePolicy field contains a value that is not supported by the server.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
specThe new values.

Implemented in vmware::vcenter::vm::ToolsStub.

void vmware::vcenter::vm::Tools::Update ( string  vm,
vmware.vcenter.vm.ToolsTypes.UpdateSpec  spec,
global::System.Action< vmware.vapi.std.Progress >  _progress,
vmware.vapi.bindings.client.InvocationConfig  _invocationConfig 
)

Update the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.InvalidArgumentif the Tools.UpdateSpec.upgradePolicy field contains a value that is not supported by the server.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
specThe new values.
_progressProgress notification call back
_invocationConfigConfiguration for the method invocation

Implemented in vmware::vcenter::vm::ToolsStub.

global::System.Threading.Tasks.Task vmware::vcenter::vm::Tools::UpdateAsync ( string  vm,
vmware.vcenter.vm.ToolsTypes.UpdateSpec  spec,
global::System.Action< vmware.vapi.std.Progress >  _progress,
vmware.vapi.bindings.client.InvocationConfig  _invocationConfig 
)

Update the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.InvalidArgumentif the Tools.UpdateSpec.upgradePolicy field contains a value that is not supported by the server.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
specThe new values.
_progressProgress notification call back
_invocationConfigConfiguration for the method invocation

Implemented in vmware::vcenter::vm::ToolsStub.

global::System.Threading.Tasks.Task vmware::vcenter::vm::Tools::UpdateAsync ( string  vm,
vmware.vcenter.vm.ToolsTypes.UpdateSpec  spec 
)

Update the properties of VMware Tools.

This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.Errorif the system reports an error while responding to the request.
vmware.vapi.std.errors.InvalidArgumentif the Tools.UpdateSpec.upgradePolicy field contains a value that is not supported by the server.
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
specThe new values.

Implemented in vmware::vcenter::vm::ToolsStub.

void vmware::vcenter::vm::Tools::Upgrade ( string  vm,
string  commandLineOptions,
global::System.Action< vmware.vapi.std.Progress >  _progress,
vmware.vapi.bindings.client.InvocationConfig  _invocationConfig 
)

Begins the Tools upgrade process.

To monitor the status of the Tools upgrade, clients should check the Tools status by calling Tools.Get and examining versionStatus and runState . This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
vmware.vapi.std.errors.ServiceUnavailableif the VMware Tools are not running.
vmware.vapi.std.errors.NotAllowedInCurrentStateif the virtual machine is not powered on.
vmware.vapi.std.errors.AlreadyInDesiredStateis an upgrade is already in progress.
vmware.vapi.std.errors.Errorif the upgrade process fails inside the guest operating system.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
commandLineOptionsCommand line options passed to the installer to modify the installation procedure for Tools. Set if any additional options are desired.
_progressProgress notification call back
_invocationConfigConfiguration for the method invocation

Implemented in vmware::vcenter::vm::ToolsStub.

void vmware::vcenter::vm::Tools::Upgrade ( string  vm,
string  commandLineOptions 
)

Begins the Tools upgrade process.

To monitor the status of the Tools upgrade, clients should check the Tools status by calling Tools.Get and examining versionStatus and runState . This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
vmware.vapi.std.errors.ServiceUnavailableif the VMware Tools are not running.
vmware.vapi.std.errors.NotAllowedInCurrentStateif the virtual machine is not powered on.
vmware.vapi.std.errors.AlreadyInDesiredStateis an upgrade is already in progress.
vmware.vapi.std.errors.Errorif the upgrade process fails inside the guest operating system.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
commandLineOptionsCommand line options passed to the installer to modify the installation procedure for Tools. Set if any additional options are desired.

Implemented in vmware::vcenter::vm::ToolsStub.

global::System.Threading.Tasks.Task vmware::vcenter::vm::Tools::UpgradeAsync ( string  vm,
string  commandLineOptions 
)

Begins the Tools upgrade process.

To monitor the status of the Tools upgrade, clients should check the Tools status by calling Tools.Get and examining versionStatus and runState . This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
vmware.vapi.std.errors.ServiceUnavailableif the VMware Tools are not running.
vmware.vapi.std.errors.NotAllowedInCurrentStateif the virtual machine is not powered on.
vmware.vapi.std.errors.AlreadyInDesiredStateis an upgrade is already in progress.
vmware.vapi.std.errors.Errorif the upgrade process fails inside the guest operating system.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
commandLineOptionsCommand line options passed to the installer to modify the installation procedure for Tools. Set if any additional options are desired.

Implemented in vmware::vcenter::vm::ToolsStub.

global::System.Threading.Tasks.Task vmware::vcenter::vm::Tools::UpgradeAsync ( string  vm,
string  commandLineOptions,
global::System.Action< vmware.vapi.std.Progress >  _progress,
vmware.vapi.bindings.client.InvocationConfig  _invocationConfig 
)

Begins the Tools upgrade process.

To monitor the status of the Tools upgrade, clients should check the Tools status by calling Tools.Get and examining versionStatus and runState . This method was added in vSphere API 7.0.0.

Exceptions:
vmware.vapi.std.errors.NotFoundif the virtual machine is not found.
vmware.vapi.std.errors.ServiceUnavailableif the VMware Tools are not running.
vmware.vapi.std.errors.NotAllowedInCurrentStateif the virtual machine is not powered on.
vmware.vapi.std.errors.AlreadyInDesiredStateis an upgrade is already in progress.
vmware.vapi.std.errors.Errorif the upgrade process fails inside the guest operating system.
Parameters:
vmIdentifier of the virtual machine. The parameter must be an identifier for the resource type: VirtualMachine .
commandLineOptionsCommand line options passed to the installer to modify the installation procedure for Tools. Set if any additional options are desired.
_progressProgress notification call back
_invocationConfigConfiguration for the method invocation

Implemented in vmware::vcenter::vm::ToolsStub.


The documentation for this interface was generated from the following file: