> For the complete documentation index, see [llms.txt](https://docs.parallels.com/landing/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/move-rasrdshostpoolmember.md).

# Move-RASRDSHostPoolMember

## SYNOPSIS

Moves one or multiple RD Session Host servers to a host pool.

## SYNTAX

```powershell
Move-RASRDSHostPoolMember [-HostPoolId] <uint> [-RDSIds] <uint[]> [<CommonParameters>]
```

```powershell
Move-RASRDSHostPoolMember [-HostPoolId] <uint> -RDSServer <string> [<CommonParameters>]
```

```powershell
Move-RASRDSHostPoolMember [-HostPoolName] <string> -RDSObject <RDSHost[]> [-SiteId <uint>]
 [<CommonParameters>]
```

```powershell
Move-RASRDSHostPoolMember [-HostPoolName] <string> -RDSServer <string> [-SiteId <uint>]
 [<CommonParameters>]
```

```powershell
Move-RASRDSHostPoolMember [-HostPoolObject] <RDSHostPool> -RDSObject <RDSHost[]>
 [<CommonParameters>]
```

```powershell
Move-RASRDSHostPoolMember [-HostPoolObject] <RDSHostPool> -RDSServer <string> [<CommonParameters>]
```

## DESCRIPTION

Moves one or multiple RD Session Host servers to an existing host pool.

## EXAMPLES

### Example 1

```powershell
Move-RASRDSHostPoolMember "My RD Session Host Pool" -RDSServer "server.company.dom"
```

Moves the specified RD Session Host server to the specified host pool.

### Example 2

```powershell
Move-RASRDSHostPoolMember "My RD Session Host Pool" -RDSObject $RDSList
```

Moves a list of RD Session Host servers ($RDSList) to the specified host pool.

The $RDSList variable is an array of objects of type RDS. An RDS object representing an RD Session Host server is obtained using the Get-RASRDSHost cmdlet.

### Example 3

```powershell
Move-RASRDSHostPoolMember $RDSHostPool -RDSServer "server.company.dom"
```

Moves the specified RD Session Host server to the host pool specified by the $RDSHostPool variable.

$RDSHostPool is an object of type RDSHostPool, which is obtained using the Get-RASRDSHostPool cmdlet.

### Example 4

```powershell
Get-RASRDSHostPool "My RD Session Host Pool" | Move-RASRDSHostPoolMember -RDSServer "server.company.dom"
```

Moves the specified RD Session Host server to the host pool obtained from the pipeline output.

## PARAMETERS

### -HostPoolName

RD Session Host Pool name.

```yaml
Type: string
Required: True
Position: 0
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -SiteId

Site ID where the RD Session Host Pool is located.

If the parameter is omitted, the site ID of the Licensing Server will be used.

```yaml
Type: uint
Required: False
Position: Named
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -HostPoolId

The ID of the target RD Session Host Pool.

```yaml
Type: uint
Required: True
Position: 0
Default value: 0
Accept pipeline input: False
Accept wildcard characters: False
```

### -HostPoolObject

An object of type RDS Group identifying the target RD Session Host Pool.

The object is obtained using the Get-RASRDSHostPool cmdlet.

Type reference: [RDSHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/rdshostpool.md)

```yaml
Type: RDSHostPool
Required: True
Position: 0
Default value: None
Accept pipeline input: true (ByValue)
Accept wildcard characters: False
```

### -RDSServer

The name of a RD Session Host server to add to the group.

```yaml
Type: string
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RDSObject

A list of RD Session Host servers (an array of objects of type RDS) to add to the group.

A RDS object representing a RD Session Host server is obtained using the Get-RASRDSHost cmdlet.

Type reference: [RDSHost\[\]](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/rdshost.md)

```yaml
Type: RDSHost[]
Required: True
Position: Named
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### -RDSIds

The IDs of RD Session Host servers to be added to the specified group.

```yaml
Type: uint[]
Required: True
Position: 1
Default value: None
Accept pipeline input: False
Accept wildcard characters: False
```

### CommonParameters

This cmdlet supports the common parameters: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutVariable, -OutBuffer, -PipelineVariable, -Verbose, -WarningAction, and -WarningVariable. For more information, see [about\_CommonParameters](https://go.microsoft.com/fwlink/?LinkID=113216).

## INPUTS

### [RDSHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/types/rdshostpool.md)

## OUTPUTS

### None

## RELATED LINKS

* [Get-RASRDSHost](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rasrdshost.md)
* [New-RASRDSHost](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/new-rasrdshost.md)
* [Get-RASRDSHostPool](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rasrdshostpool.md)
* [Get-RASRDSHostPoolMember](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-rasrdshostpoolmember.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/move-rasrdshostpoolmember.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
