---
title: "Disconnect-NectarRoomDevice"
slug: "disconnect-nectarroomdevice"
updated: 2023-08-18T16:18:51Z
published: 2023-08-18T16:18:51Z
canonical: "support.nectarcorp.com/disconnect-nectarroomdevice"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://support.nectarcorp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Disconnect-NectarRoomDevice

Disonnects one or more devices from a Nectar Room

## Syntax

```
Disconnect-NectarRoomDevice
  -DeviceUnitedId  <Int32>
  -TenantName  <String>
```

## Examples

### Example 1

```
Get-NectarDevice -SearchQuery Dallas | Disconnect-NectarRoomDevice
```

Disconnects all devices with 'Dallas' in any field from any associated room

## Parameters

**-DeviceUnitedId <Int32>** The numeric ID of the device to disconnect from a room. Accepts pipeline input from Get-NectarDevice

| Parameter | Value |
| --- | --- |
| Required | true |
| Position | 1 |
| Required | true |
| Default Value | 0 |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |

**-TenantName <String>** The name of the Nectar DXP tenant. Used in multi-tenant configurations.

| Parameter | Value |
| --- | --- |
| Required | false |
| Position | 2 |
| Required | false |
| Default Value | None |
| Accept pipeline input? | true (ByPropertyName) |
| Accept wildcard characters? | false |