Invoke-RASHostPool

NAME

Invoke-RASHostPool

SYNOPSIS

Perform RAS Host Pool commands.

SYNTAX

Invoke-RASHostPool [Id] (uint)** -Command {RecreateHosts | CreateHosts} -ObjType {RDSHostPool | VDIHostPool | AVDHostPool} [NoOfHostsToCreate (uint)] [(CommonParameters)]

Invoke-RASHostPool [-InputObject] (RASListObj) -Command {RecreateHosts | CreateHosts} [NoOfHostsToCreate (uint)] [(CommonParameters)]

Invoke-RASHostPool [Name]** (string) [[-SiteId] (uint)] -Command {RecreateHosts | CreateHosts} -ObjType {RDSHostPool | VDIHostPool | AVDHostPool} [NoOfHostsToCreate (uint)] [(CommonParameters)]

DESCRIPTION

Triggers an action on the selected HostPool such as: CreateHosts or RecreateHosts.

CreateHosts: Creates one or more Hosts.

RecreateHosts: Re-creates all of the Hosts.

PARAMETERS

Name (string)

The name of the target RAS HostPool.

SiteId (uint)

Site ID of the specified RAS HostPool.

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

Id (uint)

The ID of the target RAS HostPool.

InputObject (RASListObj)

An object of type RDS, VDI, or AVD HostPool representing a RAS HostPool.

ObjType (HostPoolObjType)

HostPool object type.

Possible values: RDSHostPool, VDIHostPool, AVDHostPool

Command (HostPoolCmd)

Host Pool command.

Accepted values: RecreateHosts, CreateHosts.

Possible values: RecreateHosts, CreateHosts

NoOfHostsToCreate (uint)

The number of hosts to be created from the specified RAS HostPool. Default: 1.

(CommonParameters)

INPUTS

RASListObj

OUTPUTS

-none-

EXAMPLES

---------- EXAMPLE 1 ----------

Invoke-RASHostPool -Id 10 -ObjType RDSHostPool -Command CreateHosts -NoOfHostsToCreate 2

Add new desktop VMs to the RAS HostPool specified by ID.

If -NoOfHostsToCreate is not specified, 1 desktop VM will be added. ---------- EXAMPLE 2 ----------

Invoke-RASHostPool -InputObject $HostPool -Command RecreateHosts

Re-create all desktop VMs of the RAS HostPool specified by the $HostPool object.

Last updated