> 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/set-raspubdefaultsettings.md).

# Set-RASPubDefaultSettings

## SYNOPSIS

Modifies default settings used to configure published resources.

## SYNTAX

```powershell
Set-RASPubDefaultSettings
 [-ColorDepth {Colors8Bit | Colors15Bit | Colors16Bit | Colors24Bit | Colors32Bit | ClientSpecified}]
 [-ConCurrentLicenses <uint>] [-CreateShortcutInStartFolder <bool>]
 [-CreateShortcutInStartUpFolder <bool>] [-CreateShortcutOnDesktop <bool>]
 [-DisableSessionSharing <bool>]
 [-LicenseLimitNotify {WarnUserAndNoStart | WarnUserAndStart | NotifyAdminAndStart | NotifyUserAdminAndStart | NotifyUserAdminAndNoStart}]
 [-MaintenanceMessage_de_DE <string>] [-MaintenanceMessage_en_US <string>]
 [-MaintenanceMessage_es_ES <string>] [-MaintenanceMessage_fr_FR <string>]
 [-MaintenanceMessage_it_IT <string>] [-MaintenanceMessage_ja_JP <string>]
 [-MaintenanceMessage_ko_KR <string>] [-MaintenanceMessage_nl_NL <string>]
 [-MaintenanceMessage_pt_BR <string>] [-MaintenanceMessage_zh_CN <string>]
 [-MaintenanceMessage_zh_TW <string>] [-OneInstancePerUser <bool>]
 [-ReplicateDisplaySettings <bool>] [-ReplicateLicenseSettings <bool>]
 [-ReplicateMaintenance <bool>] [-ReplicateShortcutSettings <bool>] [-SiteId <uint>]
 [-StartFullscreen <bool>] [-StartMaximized <bool>] [-StartPath <string>] [-WaitForPrinters <bool>]
 [-WaitForPrintersTimeout <uint>] [<CommonParameters>]
```

## DESCRIPTION

Modifies default settings used to configure published resources.

For each setting, the cmdlet has a corresponding input parameter. To modify a setting, specify a matching parameter and its value.

To retrieve the current defaults settings, use the Get-RASPubDefaultSettings cmdlet.

## EXAMPLES

### Example 1

```powershell
Set-RASPubDefaultSettings -SiteId 2 -CreateShortcutOnDesktop $true
```

Enables the 'Create shortcut on Desktop' option in default settings of the specified site.

## PARAMETERS

### -SiteId

Site ID.

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

### -CreateShortcutOnDesktop

Enable or disable the 'Create shortcut on Desktop' option.

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

### -ReplicateShortcutSettings

Enable or disable the 'Replicate settings' option.

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

### -CreateShortcutInStartFolder

Enable or disable the 'Create shortcut in Start folder' option.

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

### -CreateShortcutInStartUpFolder

Enable or disable the 'Create shortcut in Auto Start folder' option.

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

### -StartPath

Specifies a path in the Start folder.

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

### -ReplicateDisplaySettings

Enable or disable the "Replicate settings option'. This will replicate display settings to all sites.

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

### -StartMaximized

Enable or disable the 'Start the application as maximized when using mobile clients" option.

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

### -StartFullscreen

Enable or disable the 'Start in fullscreen mode for WYSE ThinOS clients" option.

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

### -WaitForPrinters

Enable or disable the 'Wait until all RAS Universal Printers are redirected before showing the application" option.

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

### -WaitForPrintersTimeout

Printer redirection timeout (in seconds). Works together with the WaitForPrinters parameter.

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

### -ColorDepth

Specifies the display color depth setting.

Possible values are: Colors8Bit, Colors15Bit, Colors16Bit, Colors24Bit, Colors32Bit, ClientSpecified

Possible values: Colors8Bit, Colors15Bit, Colors16Bit, Colors24Bit, Colors32Bit, ClientSpecified

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

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

### -ReplicateLicenseSettings

Enable or disable the 'Replicate settings' option. This will replicate license settings to all sites.

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

### -DisableSessionSharing

Enable or disable the 'Disable session sharing' option.

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

### -OneInstancePerUser

Enable or disable the 'Allow users to start only one instance of the application' option.

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

### -ConCurrentLicenses

Specifies the number of concurrent licenses (the 'Concurrent licenses' option).

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

### -LicenseLimitNotify

Specifies an action to perform when the license limit is exceeded.

Possible values are: 0 (Warn user and do not start), 1 (Warn user and start),

2 (Notify administrator and start), 3 (Notify user, administrator and start),

4 (Notify user, administrator and do not start).

Possible values: WarnUserAndNoStart, WarnUserAndStart, NotifyAdminAndStart, NotifyUserAdminAndStart, NotifyUserAdminAndNoStart

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

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

### -MaintenanceMessage\_en\_US

Maintenance message for the published resource in English.

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

### -MaintenanceMessage\_ja\_JP

Maintenance message for the published resource in Japanese.

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

### -MaintenanceMessage\_fr\_FR

Maintenance message for the published resource in French.

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

### -MaintenanceMessage\_es\_ES

Maintenance message for the published resource in Spanish.

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

### -MaintenanceMessage\_it\_IT

Maintenance message for the published resource in Italian.

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

### -MaintenanceMessage\_pt\_BR

Maintenance message for the published resource in Portuguese.

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

### -MaintenanceMessage\_de\_DE

Maintenance message for the published resource in German.

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

### -MaintenanceMessage\_nl\_NL

Maintenance message for the published resource in Dutch.

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

### -MaintenanceMessage\_zh\_TW

Maintenance message for the published resource in Chinese (Traditional).

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

### -MaintenanceMessage\_zh\_CN

Maintenance message for the published resource in Chinese (Simplified).

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

### -MaintenanceMessage\_ko\_KR

Maintenance message for the published resource in Korean.

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

### -ReplicateMaintenance

Enable or disable the 'Replicate Maintenance' option.

```yaml
Type: bool
Required: False
Position: Named
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

### None

## OUTPUTS

### None

## RELATED LINKS

* [Get-RASPubDefaultSettings](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/get-raspubdefaultsettings.md)
* [Set-RASPubRDSDesktop](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-raspubrdsdesktop.md)
* [Set-RASPubRDSApp](https://docs.parallels.com/landing/ras-powershell-api-guide/rasadmin/cmdlets/set-raspubrdsapp.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/set-raspubdefaultsettings.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.
