# Move-RASRDSHostPoolMember

## NAME

Move-RASRDSHostPoolMember

## SYNOPSIS

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

## SYNTAX

**Move-RASRDSHostPoolMember** \[[HostPoolId](#hostpoolid-string)] *(uint)* \[-[RDSIds](#RDSIds)] *(uint\[])* \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Move-RASRDSHostPoolMember** \[[HostPoolId](#hostpoolid-string)] *(uint)* -[RDSServer](#rdsserver-string) *(string)* \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Move-RASRDSHostPoolMember** \[[HostPoolName](#hostpoolname-string)] *(string)* -[RDSObject](#RDSObject) *(*[*RDSHost\[\]*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshost)*)* \[[SiteId](#siteid-string) *(uint)*] \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Move-RASRDSHostPoolMember** \[[HostPoolName](#hostpoolname-string)] *(string)* -[RDSServer](#rdsserver-string) *(string)* \[[SiteId](#siteid-string) *(uint)*] \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Move-RASRDSHostPoolMember** \[-[HostPoolObject](#HostPoolObject)] *(*[*RDSHostPool*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshostpool)*)* -[RDSObject](#RDSObject) *(*[*RDSHost\[\]*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshost)*)* \[*(*[*CommonParameters*](#CommonParameters)*)*]

**Move-RASRDSHostPoolMember** \[-[HostPoolObject](#HostPoolObject)] *(*[*RDSHostPool*](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshostpool)*)* -[RDSServer](#rdsserver-string) *(string)* \[*(*[*CommonParameters*](#CommonParameters)*)*]

## DESCRIPTION

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

## PARAMETERS

## HostPoolName (string)

RD Session Host Pool name.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SiteId (uint)

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.

```
        Required?                    false

        Position?                    named

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## HostPoolId (uint)

The ID of the target RD Session Host Pool.

```
        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

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

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

The object is obtained using the Get-RASRDSHostPool cmdlet.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false
```

## RDSServer (string)

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

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RDSObject ([RDSHost\[\]](https://docs.parallels.com/landing/ras-powershell-api-guide/parallels-ras-powershell-admin-module/types/rdshost))

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-RDS cmdlet.

```
        Required?                    true

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RDSIds (uint\[])

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

```
        Required?                    true

        Position?                    1

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

(CommonParameters)

```
        This cmdlet supports the common parameters: Verbose, Debug,

        ErrorAction, ErrorVariable, WarningAction, WarningVariable,

        OutBuffer, PipelineVariable, and OutVariable. For more information, see 

        about_CommonParameters documentation. 
```

## INPUTS

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

## OUTPUTS

-none-

## EXAMPLES

**---------- EXAMPLE 1 ----------**

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

Moves the specified RD Session Host server to the specified host pool.\
\&#xNAN;**---------- EXAMPLE 2 ----------**

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.\
\&#xNAN;**---------- EXAMPLE 3 ----------**

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.\
\&#xNAN;**---------- EXAMPLE 4 ----------**

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.

## RELATED LINKS

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