# Remove-BomWindowEntity

Removes an entity from the [BOM Window](/bom_window).

## Syntax

```{code-block} powershell
:linenos: true

Remove-BomWindowEntity [[-InputObject] <PSObject>] [<CommonParameters>]
```

## Parameters

| Type                                                                                                                                 | Name        | Description                                                                | Optional |
|--------------------------------------------------------------------------------------------------------------------------------------|-------------|----------------------------------------------------------------------------|----------|
| [BomRow](/code_reference/commandlets/show-bomwindow/objects/bom)  / [Item](/code_reference/commandlets/show-bomwindow/objects/item)  | InputObject | An entity displayed in the BOM Window. The argument accepts pipeline input | no       |


## Return type

**empty** ← On failure the Exception/ErrorMessage can be accessed using [\$Error](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_automatic_variables?view=powershell-5.1#error).

## Remarks

The Cmdlets's purpose is to remove a [BomRow](/code_reference/commandlets/show-bomwindow/objects/bomrow) or an [Item](/code_reference/commandlets/show-bomwindow/objects/item) from the [BOM Window](/bom_window).\
When removing a BomRow, the row and the associated Item will be removed together!\
The same applies when removing an Item that depends on a BomRow: the item and the associated [BomRow](/code_reference/commandlets/show-bomwindow/objects/bomrow) will be removed at the same time.

**Restrictions:**

- [Items](/code_reference/commandlets/show-bomwindow/objects/item) that are used in multiple [BOM's](/code_reference/commandlets/show-bomwindow/objects/bom) can not be removed
- Only [BomRows](/code_reference/commandlets/show-bomwindow/objects/bomrow) without any children can be removed

## Examples

**Removing an item from the BOM Window:**

```{code-block} powershell
:linenos: true

$item | Remove-BomWindowEntity
```

**Removing rows from a BOM:**

```{code-block} powershell
:linenos: true

foreach($bomRow in $bom.Children) {
        $bomRow | Remove-BomWindowEntity
}
```

**Deletes an item when marked as "Remove" and when successfully deleted in ERP:**

```{code-block} powershell
:linenos: true

function Transfer-Items($items) {
        foreach($item in $items) {
                if($item._Status -eq 'Remove'){
                        $removed = Remove-ERPObject -EntitySet 'Materials' -Keys @{'Number'=$item._PartNumber}
                        if($removed) {
                                $item | Remove-BomWindowEntity
                        }
                }
        }
}
```