Set-RASRDSDefaultSettings
Last updated
Last updated
Set-RASRDSDefaultSettings
Modifies default settings used to configure an RD Session Host server.
Set-RASRDSDefaultSettings [ (bool)] [- {Disabled | Enabled | EnabledWithAppRegistration}] [ (SwitchParameter)] [ (uint)] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [ (bool)] [ (bool)] [ (bool)] [- (string[])] [- (string[])] [ (string)] [ (bool)] [- {Disabled | ClientToServer | ServerToClient | Bidirectional}] [- (string[])] [- (string[])] [ (uint)] [- {Disabled | BothUDPTCP | OnlyTCP | EitherUDPTCP}] [ (uint)] [ (uint)] [ (uint)] [ (uint)] [- ()] [- {PrnFormat_PRN_CMP_SES | PrnFormat_SES_CMP_PRN | PrnFormat_PRN_REDSES}] [ (bool)] [ (bool)] [ (bool)] [- (string[])] [ (uint)] [ (bool)] [- {DoNotManage | UPD | FSLogix | FSLogixProfileContainer}] [ (string)] [- {DoNotChange | Enabled | Disabled}] [- {Exclude | Include}] [ (bool)] [()]
Modifies default settings used to configure an RD Session Host server.
For each setting, the cmdlet has a corresponding input parameter. To modify a setting, specify a matching parameter and its value.
Default settings are defined on a site level and are applied to an RD Session Host server when it is initially added to the site.
To retrieve the current defaults settings, use the Get-RASRDSDefaultSettings cmdlet.
Site ID for which to modify the default RD Session Host server settings.
Specifies the RD Session Host agent port number.
Specifies the 'Maximum Sessions' option.
Disconnect active session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'.
Logoff disconnected session after (in seconds). Accepted values: 20-1641600 seconds; 0 for 'Never'; 1 for 'Immediate'.
Possible values: Disabled, Enabled, EnabledWithAppRegistration
Enable or disable the 'Support Shell URL Namespace Objects' option.
Set the 'Preferred Connection Broker' option to 'Automatically".
The preferred Connection Broker.
To obtain an object of type Broker representing the preferred Connection Broker, use the Get-RASBroker cmdlet.
The preferred Connection Broker.
Enable or disable the 'Enable Drive Redirection Cache' option.
Enable or disable the 'Enable Z-Order' option. (Experimental)
Enable or disable the 'Allow 2XRemoteExec to send command to the client' option.
Enable or disable the 'Enable application monitoring' option.
Enable or disable the 'Use RemoteApps if available' option.
Possible values: Disabled, ClientToServer, ServerToClient, Bidirectional
Location where the File Transfer takes place, if and where it is allowed.
Lock Location where the File Transfer takes place, if and where it is allowed.
Possible values: Disabled, ClientToServer, ServerToClient, Bidirectional
Possible values: Disabled, BothUDPTCP, OnlyTCP, EitherUDPTCP
Possible values: PrnFormat_PRN_CMP_SES, PrnFormat_SES_CMP_PRN, PrnFormat_PRN_REDSES
Enable or disable the 'Remove client name from printer name' option.
Enable or disable the 'Remove session number from printer name' option.
Specifies the 'User Profile Technology' value.
Possible values: DoNotManage, UPD, FSLogix, FSLogixProfileContainer
Specifies the 'User Profile Disk Mode' option. Accepted values: DoNotChange, Enabled, Disabled.
Possible values: DoNotChange, Enabled, Disabled
Specifies the 'UPD Roaming Mode' option. Accepted values: Exclude, Include.
Possible values: Exclude, Include
Specifies the User Profile Disk path.
Specifies the max user profile disk size (in GB).
Specifies the UPD 'Include' folder paths.
Specifies the UPD 'Include' file paths.
Specifies the UPD 'Exclude' folder paths.
Specifies the UPD 'Exclude' file paths.
Enable or disable the 'Restrict direct desktop access to the following users' option.
To specify the list of users, use the RestrictedUsers parameter.
Specifies the list of users for the RestrictDesktopAccess option (the option should be enabled).
The list can contain User account names and User SIDs.
(CommonParameters)
-none-
-none-
**---------- EXAMPLE 1 ----------
Set-RASRDSDefaultSettings -SiteId 2 -MaxSessions 100
Modifies the default value of the MaxSessions property for the specified site.
() Specifies the 'Allow mail and URL redirection' option. Accepted values: Disabled, Enabled, EnabledWithAppRegistration (Enable with app registration).
() File Transfer option. Possible values are: 0 (Disabled), 1 (client to Server only), 2 {Server To Client only), 3 (Bidirectional).
() Specifies the mode the client server drag and drop feature will operate.
() Manage RDP transport protocol.
() Specifies the 'Printer Name Format' option. Accepted values: PrnFormat_PRN_CMP_SES, PrnFormat_SES_CMP_PRN, PrnFormat_PRN_REDSES.