# Set-RASRDSHostPool

## NAME

Set-RASRDSHostPool

## SYNOPSIS

Modifies an RD Session Host Pool.

## SYNTAX

**Set-RASRDSHostPool** \[[Id](#id-string)] _(uint)_\*\*\
\[[AllowRemoteExec](#allowremoteexec-string)_(bool)_]\
\[-[AllowURLAndMailRedirection](#AllowURLAndMailRedirection)\
{Disabled | Enabled | EnabledWithAppRegistration}]\
\[[AutoPreferredBroker](#autopreferredbroker-string)_(SwitchParameter)_]\
\[[Autoscale](#autoscale-string) _(bool)_]\
\[-[AWSSubnetsIds](#AWSSubnetsIds)_(List\`1)_] \[-[DatastoreIDs](#DatastoreIDs)_(string\[])_]\
\[-[DatastoreSource](#DatastoreSource) {Template\
\| Selection}]\
\[-[DefaultPowerState](#DefaultPowerState)\
{PoweredOn | PoweredOff | Suspended}]\
\[[Description](#description-string) _(string)_]\
\[[DisconnectActiveSessionAfter](#disconnectactivesessionafter-string)_(uint)_]\
\[-[DragAndDropMode](#DragAndDropMode) {Disabled\
\| ClientToServer | ServerToClient | Bidirectional}]\
\[[DrainRemainsBelowSec](#drainremainsbelowsec-string)_(uint)_]\
\[[EnableAppMonitoring](#enableappmonitoring-string)_(bool)_] \[[Enabled](#enabled-string) _(bool)_]\
\[[EnableDriveRedirectionCache](#enabledriveredirectioncache-string)_(bool)_] \[[EnableZOrder](#enablezorder-string)_(bool)_]\
\[-[ExcludeFilePath](#ExcludeFilePath)_(string\[])_]\
\[-[ExcludeFolderPath](#ExcludeFolderPath)_(string\[])_]\
\[[FileTransferLocation](#filetransferlocation-string)_(string)_]\
\[[FileTransferLockLocation](#filetransferlocklocation-string)_(bool)_]\
\[-[FileTransferMode](#FileTransferMode)\
{Disabled | ClientToServer | ServerToClient | Bidirectional}]\
\[[HostName](#hostname-string) _(string)_]\
\[-[IncludeFilePath](#IncludeFilePath)_(string\[])_]\
\[-[IncludeFolderPath](#IncludeFolderPath)_(string\[])_]\
\[[InheritDefaultAgentSettings](#inheritdefaultagentsettings-string)_(bool)_]\
\[[InheritDefaultAppPackageSettings](#inheritdefaultapppackagesettings-string)_(bool)_]\
\[[InheritDefaultAutoUpgradeSettings](#inheritdefaultautoupgradesettings-string)_(bool)_]\
\[[InheritDefaultDesktopAccessSettings](#inheritdefaultdesktopaccesssettings-string)_(bool)_]\
\[[InheritDefaultPrinterSettings](#inheritdefaultprintersettings-string)_(bool)_]\
\[[InheritDefaultUserProfileSettings](#inheritdefaultuserprofilesettings-string)_(bool)_]\
\[[LogoffDisconnectedSessionAfter](#logoffdisconnectedsessionafter-string)_(uint)_]\
\[-[ManageRDPTransportProtocol](#ManageRDPTransportProtocol)\
{Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}]\
\[[MaxServersFromTemplate](#maxserversfromtemplate-string)_(uint)_] \[[MaxSessions](#maxsessions-string)_(uint)_]\
\[[MaxUserProfileDiskSizeGB](#maxuserprofiledisksizegb-string)_(uint)_]\
\[[MinServersFromTemplate](#minserversfromtemplate-string)_(uint)_] \[[NewName](#newname-string)_(string)_] \[[Port](#port-string) _(uint)_]\
\[[PreferredBrokerId](#preferredbrokerid-string)_(uint)_]\
\[-[PreferredBrokerObj](#PreferredBrokerObj)_(_[_Broker_](../types/broker)_)_]\
\[-[PrinterNameFormat](#PrinterNameFormat)\
{PrnFormat\_PRN\_CMP\_SES | PrnFormat\_SES\_CMP\_PRN |\
PrnFormat\_PRN\_REDSES}]\
\[-[RASTemplate](#RASTemplate)_(_[_Template_](../types/template)_)_]\
\[[RASTemplateId](#rastemplateid-string) _(uint)_]\
\[[RASTemplateVersionId](#rastemplateversionid-string)_(uint)_]\
\[[RemoveClientNameFromPrinterName](#removeclientnamefromprintername-string)_(bool)_]\
\[[RemoveServersAfterDrainAndPowerOff](#removeserversafterdrainandpoweroff-string)_(bool)_]\
\[[RemoveSessionNumberFromPrinterName](#removesessionnumberfromprintername-string)_(bool)_]\
\[[RestrictDesktopAccess](#restrictdesktopaccess-string)_(bool)_]\
\[-[RestrictedUsers](#RestrictedUsers)_(string\[])_]\
\[[ServersToAddPerRequest](#serverstoaddperrequest-string)_(uint)_]\
\[[SupportShellURLNamespaceObjects](#supportshellurlnamespaceobjects-string)_(bool)_] \[-[Technology](#Technology)\
{DoNotManage | UPD | FSLogix | FSLogixProfileContainer}]\
\[-[Template](#Template)_(_[_Template_](../types/template)_)_]\
\[[TemplateId](#templateid-string) _(uint)_]\
\[[TemplateTagId](#templatetagid-string) _(uint)_]\
\[[TemplateVersionId](#templateversionid-string)_(uint)_] \[[UPDiskPath](#updiskpath-string)_(string)_] \[-[UPDMode](#UPDMode)\
{DoNotChange | Enabled | Disabled}]\
\[-[UPDRoamingMode](#UPDRoamingMode) {Exclude |\
Include}] \[[UseRemoteApps](#useremoteapps-string)_(bool)_]\
\[[WorkLoadThreshold](#workloadthreshold-string)_(uint)_]\
\[[WorkLoadToDrain](#workloadtodrain-string)_(uint)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

**Set-RASRDSHostPool**\
\[-[InputObject](#inputobject)]_(_[_RDSHostPool_](../types/rdshostpool)_)_\
\[[AllowRemoteExec](#allowremoteexec-string)_(bool)_]\
\[-[AllowURLAndMailRedirection](#AllowURLAndMailRedirection)\
{Disabled | Enabled | EnabledWithAppRegistration}]\
\[[AutoPreferredBroker](#autopreferredbroker-string)_(SwitchParameter)_]\
\[[Autoscale](#autoscale-string) _(bool)_]\
\[-[AWSSubnetsIds](#AWSSubnetsIds)_(List\`1)_] \[-[DatastoreIDs](#DatastoreIDs)_(string\[])_]\
\[-[DatastoreSource](#DatastoreSource) {Template\
\| Selection}]\
\[-[DefaultPowerState](#DefaultPowerState)\
{PoweredOn | PoweredOff | Suspended}]\
\[[Description](#description-string) _(string)_]\
\[[DisconnectActiveSessionAfter](#disconnectactivesessionafter-string)_(uint)_]\
\[-[DragAndDropMode](#DragAndDropMode) {Disabled\
\| ClientToServer | ServerToClient | Bidirectional}]\
\[[DrainRemainsBelowSec](#drainremainsbelowsec-string)_(uint)_]\
\[[EnableAppMonitoring](#enableappmonitoring-string)_(bool)_] \[[Enabled](#enabled-string) _(bool)_]\
\[[EnableDriveRedirectionCache](#enabledriveredirectioncache-string)_(bool)_] \[[EnableZOrder](#enablezorder-string)_(bool)_]\
\[-[ExcludeFilePath](#ExcludeFilePath)_(string\[])_]\
\[-[ExcludeFolderPath](#ExcludeFolderPath)_(string\[])_]\
\[[FileTransferLocation](#filetransferlocation-string)_(string)_]\
\[[FileTransferLockLocation](#filetransferlocklocation-string)_(bool)_]\
\[-[FileTransferMode](#FileTransferMode)\
{Disabled | ClientToServer | ServerToClient | Bidirectional}]\
\[[HostName](#hostname-string) _(string)_]\
\[-[IncludeFilePath](#IncludeFilePath)_(string\[])_]\
\[-[IncludeFolderPath](#IncludeFolderPath)_(string\[])_]\
\[[InheritDefaultAgentSettings](#inheritdefaultagentsettings-string)_(bool)_]\
\[[InheritDefaultAppPackageSettings](#inheritdefaultapppackagesettings-string)_(bool)_]\
\[[InheritDefaultAutoUpgradeSettings](#inheritdefaultautoupgradesettings-string)_(bool)_]\
\[[InheritDefaultDesktopAccessSettings](#inheritdefaultdesktopaccesssettings-string)_(bool)_]\
\[[InheritDefaultPrinterSettings](#inheritdefaultprintersettings-string)_(bool)_]\
\[[InheritDefaultUserProfileSettings](#inheritdefaultuserprofilesettings-string)_(bool)_]\
\[[LogoffDisconnectedSessionAfter](#logoffdisconnectedsessionafter-string)_(uint)_]\
\[-[ManageRDPTransportProtocol](#ManageRDPTransportProtocol)\
{Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}]\
\[[MaxServersFromTemplate](#maxserversfromtemplate-string)_(uint)_] \[[MaxSessions](#maxsessions-string)_(uint)_]\
\[[MaxUserProfileDiskSizeGB](#maxuserprofiledisksizegb-string)_(uint)_]\
\[[MinServersFromTemplate](#minserversfromtemplate-string)_(uint)_] \[[NewName](#newname-string)_(string)_] \[[Port](#port-string) _(uint)_]\
\[[PreferredBrokerId](#preferredbrokerid-string)_(uint)_]\
\[-[PreferredBrokerObj](#PreferredBrokerObj)_(_[_Broker_](../types/broker)_)_]\
\[-[PrinterNameFormat](#PrinterNameFormat)\
{PrnFormat\_PRN\_CMP\_SES | PrnFormat\_SES\_CMP\_PRN |\
PrnFormat\_PRN\_REDSES}]\
\[-[RASTemplate](#RASTemplate)_(_[_Template_](../types/template)_)_]\
\[[RASTemplateId](#rastemplateid-string) _(uint)_]\
\[[RASTemplateVersionId](#rastemplateversionid-string)_(uint)_]\
\[[RemoveClientNameFromPrinterName](#removeclientnamefromprintername-string)_(bool)_]\
\[[RemoveServersAfterDrainAndPowerOff](#removeserversafterdrainandpoweroff-string)_(bool)_]\
\[[RemoveSessionNumberFromPrinterName](#removesessionnumberfromprintername-string)_(bool)_]\
\[[RestrictDesktopAccess](#restrictdesktopaccess-string)_(bool)_]\
\[-[RestrictedUsers](#RestrictedUsers)_(string\[])_]\
\[[ServersToAddPerRequest](#serverstoaddperrequest-string)_(uint)_]\
\[[SupportShellURLNamespaceObjects](#supportshellurlnamespaceobjects-string)_(bool)_] \[-[Technology](#Technology)\
{DoNotManage | UPD | FSLogix | FSLogixProfileContainer}]\
\[-[Template](#Template)_(_[_Template_](../types/template)_)_]\
\[[TemplateId](#templateid-string) _(uint)_]\
\[[TemplateTagId](#templatetagid-string) _(uint)_]\
\[[TemplateVersionId](#templateversionid-string)_(uint)_] \[[UPDiskPath](#updiskpath-string)_(string)_] \[-[UPDMode](#UPDMode)\
{DoNotChange | Enabled | Disabled}]\
\[-[UPDRoamingMode](#UPDRoamingMode) {Exclude |\
Include}] \[[UseRemoteApps](#useremoteapps-string)_(bool)_]\
\[[WorkLoadThreshold](#workloadthreshold-string)_(uint)_]\
\[[WorkLoadToDrain](#workloadtodrain-string)_(uint)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

**Set-RASRDSHostPool** \[[Name](#name-string)]\*\*_(string)_ \[\[-[SiteId](#siteid-string)]_(uint)_]\
\[[AllowRemoteExec](#allowremoteexec-string)_(bool)_]\
\[-[AllowURLAndMailRedirection](#AllowURLAndMailRedirection)\
{Disabled | Enabled | EnabledWithAppRegistration}]\
\[[AutoPreferredBroker](#autopreferredbroker-string)_(SwitchParameter)_]\
\[[Autoscale](#autoscale-string) _(bool)_]\
\[-[AWSSubnetsIds](#AWSSubnetsIds)_(List\`1)_] \[-[DatastoreIDs](#DatastoreIDs)_(string\[])_]\
\[-[DatastoreSource](#DatastoreSource) {Template\
\| Selection}]\
\[-[DefaultPowerState](#DefaultPowerState)\
{PoweredOn | PoweredOff | Suspended}]\
\[[Description](#description-string) _(string)_]\
\[[DisconnectActiveSessionAfter](#disconnectactivesessionafter-string)_(uint)_]\
\[-[DragAndDropMode](#DragAndDropMode) {Disabled\
\| ClientToServer | ServerToClient | Bidirectional}]\
\[[DrainRemainsBelowSec](#drainremainsbelowsec-string)_(uint)_]\
\[[EnableAppMonitoring](#enableappmonitoring-string)_(bool)_] \[[Enabled](#enabled-string) _(bool)_]\
\[[EnableDriveRedirectionCache](#enabledriveredirectioncache-string)_(bool)_] \[[EnableZOrder](#enablezorder-string)_(bool)_]\
\[-[ExcludeFilePath](#ExcludeFilePath)_(string\[])_]\
\[-[ExcludeFolderPath](#ExcludeFolderPath)_(string\[])_]\
\[[FileTransferLocation](#filetransferlocation-string)_(string)_]\
\[[FileTransferLockLocation](#filetransferlocklocation-string)_(bool)_]\
\[-[FileTransferMode](#FileTransferMode)\
{Disabled | ClientToServer | ServerToClient | Bidirectional}]\
\[[HostName](#hostname-string) _(string)_]\
\[-[IncludeFilePath](#IncludeFilePath)_(string\[])_]\
\[-[IncludeFolderPath](#IncludeFolderPath)_(string\[])_]\
\[[InheritDefaultAgentSettings](#inheritdefaultagentsettings-string)_(bool)_]\
\[[InheritDefaultAppPackageSettings](#inheritdefaultapppackagesettings-string)_(bool)_]\
\[[InheritDefaultAutoUpgradeSettings](#inheritdefaultautoupgradesettings-string)_(bool)_]\
\[[InheritDefaultDesktopAccessSettings](#inheritdefaultdesktopaccesssettings-string)_(bool)_]\
\[[InheritDefaultPrinterSettings](#inheritdefaultprintersettings-string)_(bool)_]\
\[[InheritDefaultUserProfileSettings](#inheritdefaultuserprofilesettings-string)_(bool)_]\
\[[LogoffDisconnectedSessionAfter](#logoffdisconnectedsessionafter-string)_(uint)_]\
\[-[ManageRDPTransportProtocol](#ManageRDPTransportProtocol)\
{Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}]\
\[[MaxServersFromTemplate](#maxserversfromtemplate-string)_(uint)_] \[[MaxSessions](#maxsessions-string)_(uint)_]\
\[[MaxUserProfileDiskSizeGB](#maxuserprofiledisksizegb-string)_(uint)_]\
\[[MinServersFromTemplate](#minserversfromtemplate-string)_(uint)_] \[[NewName](#newname-string)_(string)_] \[[Port](#port-string) _(uint)_]\
\[[PreferredBrokerId](#preferredbrokerid-string)_(uint)_]\
\[-[PreferredBrokerObj](#PreferredBrokerObj)_(_[_Broker_](../types/broker)_)_]\
\[-[PrinterNameFormat](#PrinterNameFormat)\
{PrnFormat\_PRN\_CMP\_SES | PrnFormat\_SES\_CMP\_PRN |\
PrnFormat\_PRN\_REDSES}]\
\[-[RASTemplate](#RASTemplate)_(_[_Template_](../types/template)_)_]\
\[[RASTemplateId](#rastemplateid-string) _(uint)_]\
\[[RASTemplateVersionId](#rastemplateversionid-string)_(uint)_]\
\[[RemoveClientNameFromPrinterName](#removeclientnamefromprintername-string)_(bool)_]\
\[[RemoveServersAfterDrainAndPowerOff](#removeserversafterdrainandpoweroff-string)_(bool)_]\
\[[RemoveSessionNumberFromPrinterName](#removesessionnumberfromprintername-string)_(bool)_]\
\[[RestrictDesktopAccess](#restrictdesktopaccess-string)_(bool)_]\
\[-[RestrictedUsers](#RestrictedUsers)_(string\[])_]\
\[[ServersToAddPerRequest](#serverstoaddperrequest-string)_(uint)_]\
\[[SupportShellURLNamespaceObjects](#supportshellurlnamespaceobjects-string)_(bool)_] \[-[Technology](#Technology)\
{DoNotManage | UPD | FSLogix | FSLogixProfileContainer}]\
\[-[Template](#Template)_(_[_Template_](../types/template)_)_]\
\[[TemplateId](#templateid-string) _(uint)_]\
\[[TemplateTagId](#templatetagid-string) _(uint)_]\
\[[TemplateVersionId](#templateversionid-string)_(uint)_] \[[UPDiskPath](#updiskpath-string)_(string)_] \[-[UPDMode](#UPDMode)\
{DoNotChange | Enabled | Disabled}]\
\[-[UPDRoamingMode](#UPDRoamingMode) {Exclude |\
Include}] \[[UseRemoteApps](#useremoteapps-string)_(bool)_]\
\[[WorkLoadThreshold](#workloadthreshold-string)_(uint)_]\
\[[WorkLoadToDrain](#workloadtodrain-string)_(uint)_]\
\[_(_[_CommonParameters_](#CommonParameters)_)_]

## DESCRIPTION

Modifies properties of an RD Session Host Pool.

## PARAMETERS

## Name (string)

The name of the host pool to modify.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SiteId (uint)

Site ID where the target host pool is located.

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

```
        Required?                    false

        Position?                    1

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Id (uint)

The ID of a RD Session Host Pool to modify.

```
        Required?                    true

        Position?                    0

        Default value                0

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InputObject ([RDSHostPool](../types/rdshostpool))

A RD Session Host Pool object (an object of type RDSHostPool) to\
modify.

A RDSHostPool object representing a group is obtained using the\
Get-RASRDSHostPool cmdlet.

```
        Required?                    true

        Position?                    0

        Default value                

        Accept pipeline input?       true (ByValue)

        Accept wildcard characters?  false
```

## Enabled (bool)

Enable or disable the specified host pool(s) in a site.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## NewName (string)

A new name to assign to the specified host pool.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Description (string)

A description of the specified host pool.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Autoscale (bool)

Enable or disable Autoscaling.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Template ([Template](../types/template))

The RDSH Template object.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RASTemplate ([Template](../types/template))

The RDSH Template object.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## TemplateId (uint)

The RDSH Template ID.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RASTemplateId (uint)

The RDSH Template ID.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## TemplateVersionId (uint)

The RDSH Template Version ID.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RASTemplateVersionId (uint)

Deprecated: The RDSH Template Version ID.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## TemplateTagId (uint)

The RDSH Template Tag ID.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## MinServersFromTemplate (uint)

Min number of servers to be added to the host pool from the RAS\
Template.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## MaxServersFromTemplate (uint)

Max number of servers to be added to the host pool from the RAS\
Template.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## HostName (string)

The VM name format. All VMs created from the template will have this\
name with %ID:N:S% replaced.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DefaultPowerState

([DefaultPowerState](../types/defaultpowerstate))\
The Default Power State

Possible values: PoweredOn, PoweredOff, Suspended

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## WorkLoadThreshold (uint)

Send a request to the RAS template when the workload threshold is above\
the specified value.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## ServersToAddPerRequest (uint)

Number of servers to be added to the host pool per request.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## WorkLoadToDrain (uint)

Drain and unassign servers from host pool when workload is below the\
specified value.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DrainRemainsBelowSec (uint)

Drain and unassign servers from host pool when workload remains below\
the specified level for the below specified time (in seconds).

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RemoveServersAfterDrainAndPowerOff (bool)

Remove servers from host pool after drain and power off.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InheritDefaultAgentSettings (bool)

Enable or disable the 'Inherit default agent settings' option. This will\
inherit Global agent settings from the default profile.

If you would like to specify custom settings, you need to disable this\
option and specify the desired parameters.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InheritDefaultPrinterSettings (bool)

Enable or disable the 'Inherit default printer settings' option. This\
will inherit Global printer settings from the default profile.

If you would like to specify custom settings, you need to disable this\
option and specify the desired parameters.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InheritDefaultUserProfileSettings (bool)

Enable or disable the 'Inherit default user profile settings' option.\
This will inherit Global User Profile settings from the default\
profile.

If you would like to specify custom settings, you need to disable this\
option and specify the desired parameters.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InheritDefaultDesktopAccessSettings (bool)

Enable or disable the 'Inherit default desktop access settings' option.\
This will inherit Global Desktop Access settings from the default\
profile.

If you would like to specify custom settings, you need to disable this\
option and specify the desired parameters.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InheritDefaultAppPackageSettings (bool)

Enable or disable the 'Inherit default app package settings' option.\
This will inherit Global App Package settings from the default\
profile.

If you would like to specify custom settings, you need to disable this\
option and specify the desired parameters.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## InheritDefaultAutoUpgradeSettings (bool)

Enable or disable the 'Inherit Auto-upgrade settings' option. This will\
inherit Global Auto-upgrade settings from the default profile.

If you would like to specify custom settings, you need to disable this\
option and specify the desired parameters.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Port (uint)

Specifies the port number for the RD Session Host agent.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## MaxSessions (uint)

Specifies the 'Maximum Sessions' property.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DisconnectActiveSessionAfter (uint)

Disconnect active session after (in seconds). Accepted values:\
20-1641600 seconds; 0 for 'Never'.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## LogoffDisconnectedSessionAfter (uint)

Logoff disconnected session after (in seconds). Accepted values:\
20-1641600 seconds; 0 for 'Never'; 1 for 'Immediate'.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## AllowURLAndMailRedirection

([AllowURLAndMailRedirection](../types/allowurlandmailredirection))\
Specifies the 'Allow Client URL/Mail Redirection' option. Accepted\
values: Disabled, Enabled, EnabledWithAppRegistration (Enable with app\
registration).

Possible values: Disabled, Enabled, EnabledWithAppRegistration

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## SupportShellURLNamespaceObjects (bool)

Enable or disable the 'Support Shell URL Namespace Objects' option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## AutoPreferredBroker (SwitchParameter)

Set the 'Preferred Connection Broker' option to 'Automatically".

```
        Required?                    false

        Position?                    named

        Default value                False

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## PreferredBrokerObj ([Broker](../types/broker))

The preferred Connection Broker.

To obtain an object of type Broker representing the preferred Connection\
Broker, use the Get-RASBroker cmdlet.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## PreferredBrokerId (uint)

The preferred Connection Broker.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## EnableDriveRedirectionCache (bool)

Enable or disable the 'Enable Drive Redirection Cache' option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## EnableZOrder (bool)

Enable or disable the 'Enable Z-Order' option. (Experimental)

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## AllowRemoteExec (bool)

Enable or disable the 'Allow 2XRemoteExec to send command to the client'\
option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## EnableAppMonitoring (bool)

Enable or disable the 'Application Monitoring' option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## UseRemoteApps (bool)

Enable or disable the 'Use RemoteApps if available' option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## FileTransferMode

([FileTransferControlMode](../types/filetransfercontrolmode))\
File Transfer option. Possible values are: 0 (Disabled), 1 (client to\
Server only), 2 {Server To Client only), 3 (Bidirectional).

Possible values: Disabled, ClientToServer, ServerToClient,\
Bidirectional

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## FileTransferLocation (string)

Location where the File Transfer takes place, if and where it is\
allowed.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## FileTransferLockLocation (bool)

Lock Location where the File Transfer takes place, if and where it is\
allowed.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DragAndDropMode

([DragAndDropModeValue](../types/draganddropmodevalue))\
Specifies the mode the client server drag and drop feature will\
operate.

Possible values: Disabled, ClientToServer, ServerToClient,\
Bidirectional

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## ManageRDPTransportProtocol

([ManageRDPTransportProtocol](../types/managerdptransportprotocol))\
Manage RDP transport protocol.

Possible values: Disabled, BothUDPTCP, OnlyTCP, EitherUDPTCP

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## PrinterNameFormat

([PrnNameFormat](../types/prnnameformat))\
Specifies the 'Printer Name Format' option. Accepted values:\
PrnFormat\_PRN\_CMP\_SES, PrnFormat\_SES\_CMP\_PRN, PrnFormat\_PRN\_REDSES.

Possible values: PrnFormat\_PRN\_CMP\_SES, PrnFormat\_SES\_CMP\_PRN,\
PrnFormat\_PRN\_REDSES

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RemoveClientNameFromPrinterName (bool)

Enable or disable the 'Remove client name from printer name' option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RemoveSessionNumberFromPrinterName (bool)

Enable or disable the 'Remove session number from printer name'\
option.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## Technology ([UserProfileTech](../types/userprofiletech))

Specifies the 'User Profile Technology' value.

Possible values: DoNotManage, UPD, FSLogix, FSLogixProfileContainer

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## UPDMode ([UPDMode](../types/updmode))

Specifies the 'User Profile Disk Mode' option. Accepted values:\
DoNotChange, Enabled, Disabled.

Possible values: DoNotChange, Enabled, Disabled

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## UPDRoamingMode ([UPDRoamingMode](../types/updroamingmode))

Specifies the 'UPD Roaming Mode' option. Accepted values: Exclude,\
Include.

Possible values: Exclude, Include

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## UPDiskPath (string)

Specifies the User Profile Disk path.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## MaxUserProfileDiskSizeGB (uint)

Specifies the max user profile disk size (in GB).

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## IncludeFolderPath (string\[])

Specifies the UPD 'Include' folder paths.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## IncludeFilePath (string\[])

Specifies the UPD 'Include' file paths.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## ExcludeFolderPath (string\[])

Specifies the UPD 'Exclude' folder paths.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## ExcludeFilePath (string\[])

Specifies the UPD 'Exclude' file paths.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RestrictDesktopAccess (bool)

Enable or disable the 'Restrict direct desktop access to the following\
users' option.

Use the RestrictedUsers parameter to specify the list of users.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## RestrictedUsers (string\[])

Specifies the list of users for the RestrictDesktopAccess option (the\
option should be enabled).

The list can contain user account names and user SIDs.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## AWSSubnetsIds (List\`1)

Add or remove Amazon Web Service Subnets.

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DatastoreSource

([DatastoreSourceType](../types/datastoresourcetype))\
Datastore Source.

Possible values: Template, Selection

```
        Required?                    false

        Position?                    named

        Default value                

        Accept pipeline input?       false

        Accept wildcard characters?  false
```

## DatastoreIDs (string\[])

Datastore IDs.

```
        Required?                    false

        Position?                    named

        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](../types/rdshostpool)

## OUTPUTS

-none-

## EXAMPLES

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

Set-RASRDSHostPool "My RD Session Host Pool" -Enabled $False

Disables the RD Session Host Pool specified by name.\
\*\*---------- EXAMPLE 2 ----------

Set-RASRDSHostPool -Id 11 -Enabled $False

Disables the RD Session Host Pool specified by ID.\
\*\*---------- EXAMPLE 3 ----------

Set-RASRDSHostPool $RDSHostPool -Enabled $False

Disables the RD Session Host Pool specified by the $RDSHostPool\
variable (an object of type RDSHostPool).

To obtain an RDSHostPool object representing a host pool, use the\
Get-RASRDSHostPool cmdlet.\
\*\*---------- EXAMPLE 4 ----------

Get-RASRDSHostPool -Id 11 | Set-RASRDSHostPool -Enabled $False

Disables the RD Session Host Pool obtained from the pipeline output.

## RELATED LINKS

* [New-RASRDSHostPool](new-rasrdshostpool)
* [Get-RASRDSHostPool](get-rasrdshostpool)
* [Remove-RASRDSHostPool](remove-rasrdshostpool)
