Remove-SCVMHostProfile

Removes a host profile object from the VMM database.

Description

The Remove-SCVMHostProfile cmdlet removes a host profile object from the System Center Virtual Machine Manager (VMM) database.

For more information about Remove-SCVMHostProfile, type: "Get-Help Remove-SCVMHostProfile -online".

Parameters

VMHostProfile

Required? true
Accept Pipeline Input? true (ByValue)
Position? 0
Specifies a virtual machine host profile object.

Confirm

Required? false
Accept Pipeline Input? false
Position? named
Prompts for confirmation before running the command.

Force

Required? false
Accept Pipeline Input? false
Position? named
Forces the operation to complete. 

For example:
- Remove-SCSCVMHost -Force
  Forces the removal of a host object from the VMM database.

- Stop-SCVirtualMachine -Force
  Stops a virtual machine.

JobVariable

Required? false
Accept Pipeline Input? false
Position? named
Specifies that job progress is tracked and stored in the variable named by this parameter. 

PROTipID

Required? false
Accept Pipeline Input? false
Position? named
Specifies the ID of the PRO tip that triggered this action. This allows for auditing of PRO tips.

RunAsynchronously

Required? false
Accept Pipeline Input? false
Position? named
Indicates that the job runs asynchronously so that control returns to the command shell immediately. 

Examples

1: Remove a specified host profile.
PS C:\> Get-SCVMHostProfile -Name "HostProfile01" | Remove-SCVMHostProfile
This command removes the host profile object named HostProfile01.

See Also