Remove-VApp

Synopsis

Removes virtual appliances from the server.

Syntax

Remove-VApp [-DeleteFromDisk] [-VApp] <VApp[]> [-Server <VIServer[]>] [-RunAsync] [-WhatIf] [-Confirm] [<CommonParameters>]

Related Commands

Export-VApp
Get-VApp
Import-VApp
New-VApp
Set-VApp
Start-VApp
Stop-VApp

Detailed Description

Removes virtual appliances from the server.

Parameters

NameDescriptionRequired?Pipeline InputDefault Value
DeleteFromDiskIndicate that you want not only to remove the virtual appliances from the inventory, but also to delete the virtual machines from the disk.falsefalse
VAppSpecify the virtual appliance you want to remove.truetrue (ByValue)
ServerSpecify the vSphere servers 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 Connect-VIServer.falsefalse
RunAsyncIndicate that the command returns immediately without waiting for the task to complete. In this mode, the output of the cmdlet is a Task object. For more information about the -RunAsync parameter run " help About_RunAsync" in the vSphere PowerCLI console.falsefalse
WhatIfIndicate that the cmdlet is run only to display the changes that would be made and actually no objects are modified.falsefalse
ConfirmIndicate that the cmdlet asks for confirmation before running.falsefalse

Input Type

Return Type

none

Notes

Examples

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

C:\PS>Get-VMHost myHost | Get-VIApp | Remove-VApp


Retrieves and removes all virtual appliances available on the myHost host.

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