# GPO and values for WorkSpaces Manager Agent

To deploy the **WSM Agent** software to AWS WorkSpaces via **Group Policy**, follow these steps:

1. **Open Group Policy Manager**: Create a new **Group Policy Object (GPO)** on the **Organizational Unit (OU)** containing your AWS WorkSpaces.
2. **Edit the Policy**:
   * Navigate to **Computer Configuration** > **Policies**.
3. **Expand Software Settings**:
   * Under **Computer Configuration**, expand **Software Settings**.
4. **Add a New Package**:
   * Right-click **Software Installation**, select **New** from the context menu, and then click on **Package**.
5. **Specify the Path**:
   * In the **Open** dialog, enter the full **UNC path** (e.g., `\\server\share\software.msi`) of the shared package you want to assign.
6. **Open and Assign**:
   * Click the **Open** button, then select **Assigned** and click **OK**. The package will be added to the right pane of the **Group Policy** window.

This will deploy the software to all WorkSpaces associated with the selected OU when the policy is applied, ensuring the software is installed on startup.

![](https://manula.r.sizr.io/large/user/21827/img/gpolicy.png)

To add the required **Registry values** through **Group Policy**, follow these steps:

1. **Open Group Policy Manager**: Edit the **GPO** created for the WorkSpaces.
2. **Navigate to Preferences**:
   * Under **Computer Configuration**, expand **Preferences** > **Windows Settings**.
3. **Create New Registry Items**:
   * Right-click **Registry** and select **New** > **Registry Item**.
4. **Add the Required Registry Keys and Values**:
   * **Portal**:
     * **Action**: Create
     * **Hive**: `HKEY_USERS`
     * **Key Path**: `.DEFAULT\Software\Nuvens`
     * **Value Name**: `Portal`
     * **Value Type**: `REG_SZ`
     * **Value Data**: The URL of your WorkSpaces Manager appliance (e.g., `http://wsmportal.nuvens.cloud` or `https://wsmportal.nuvens.cloud`).
   * **Frequency**:
     * **Action**: Create
     * **Hive**: `HKEY_USERS`
     * **Key Path**: `.DEFAULT\Software\Nuvens`
     * **Value Name**: `Frequency`
     * **Value Type**: `REG_DWORD (32-bit)`
     * **Value Data**: Set the frequency in minutes (e.g., `5` for reporting back every 5 minutes).
   * **UpdateFrequency**:
     * **Action**: Create
     * **Hive**: `HKEY_USERS`
     * **Key Path**: `.DEFAULT\Software\Nuvens`
     * **Value Name**: `UpdateFrequency`
     * **Value Type**: `REG_SZ`
     * **Value Data**: Leave empty or set accordingly.
   * **IdleMinutes**:
     * **Action**: Create
     * **Hive**: `HKEY_USERS`
     * **Key Path**: `.DEFAULT\Software\Nuvens`
     * **Value Name**: `IdleMinutes`
     * **Value Type**: `REG_DWORD (32-bit)`
     * **Value Data**: Set the idle time in minutes (e.g., `15` for 15 minutes of inactivity).
   * **Visible**:
     * **Action**: Create
     * **Hive**: `HKEY_USERS`
     * **Key Path**: `.DEFAULT\Software\Nuvens`
     * **Value Name**: `Visible`
     * **Value Type**: `REG_SZ`
     * **Value Data**: `False` (or `True` if you want the icon to be visible in the Windows tray).
   * **DisconnectonIdle**:
     * **Action**: Create
     * **Hive**: `HKEY_USERS`
     * **Key Path**: `.DEFAULT\Software\Nuvens`
     * **Value Name**: `DisconnectonIdle`
     * **Value Type**: `REG_SZ`
     * **Value Data**: `True` (to restart the PCoIP or WSP protocol when idle).
5. **Apply the Policy**:
   * Once all registry values have been added, apply the Group Policy. The changes will take effect during the next Group Policy update cycle on the WorkSpaces.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nuvens.cloud/install/appendices/gpo-and-values-for-workspaces-manager-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.