Skip to content

Commit

Permalink
Add instructions for importing ADMX to Intune
Browse files Browse the repository at this point in the history
  • Loading branch information
jpassing committed Sep 20, 2024
1 parent 07ea522 commit 8d17d14
Show file tree
Hide file tree
Showing 3 changed files with 57 additions and 18 deletions.
1 change: 1 addition & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@
*.user
*.userosscache
*.sln.docstates
.idea/

# User-specific files (MonoDevelop/Xamarin Studio)
*.userprefs
Expand Down
74 changes: 56 additions & 18 deletions doc/site/sources/docs/group-policies.md
Original file line number Diff line number Diff line change
@@ -1,35 +1,73 @@
# Use group policies to customize IAP Desktop

You can use a group policy object (GPO) to configure policies for IAP Desktop. Policies take
precendence of user settings: When you configure a policy, users can't change the respectice
setting anymore.
You can use group policies to customize IAP Desktop for users of your organization.

## Use client-side group policies to customize IAP Desktop

By using group policies, you can customize the configuration of IAP Desktop and ensure that
all users in your organization use the same settings. Settings you manage using a group policies
are applied automatically, and can't be changed by users.

For a full list of settings that you can control using group policies, see [Group policy reference](group-policy-reference.md).

To configure policies, you first have to install the IAP Desktop Policy Templates:
You can manage IAP Desktop group policies using Active Directory or Intune.

=== "Active Directory"

Before you can configure a group policy, you must first install the IAP Desktop Policy Templates:

1. Download the `PolicyTemplates` package from the [downloads page](https://github.com/GoogleCloudPlatform/iap-desktop/releases).
1. Extract the package into the `PolicyDefinitions` folder of your
[central store :octicons-link-external-16:](https://docs.microsoft.com/en-us/troubleshoot/windows-server/group-policy/create-central-store-domain-controller).

You can now use the IAP Desktop templates to configure a group policy object:

1. In the **Group Policy Management Console**, create or select a GPO.
1. Link the GPO to an organizational unit that contains the users who should be able to use IAP Desktop.

Note: You can configure policies per-computer or per-user. Computer-based policies take precendence
over user-based policies.

1. Right-click the GPO and select **Edit**.
1. Navigate to **User (or Computer) Configuration > Policies > Administrative Templates > Google IAP Desktop**
and customize policies as necessary.

![Policies](images/Policies.png)

1. Close the Group Policy Management Editor window.

=== "Intune"

1. Download the `PolicyTemplates` package from the [downloads page](https://github.com/GoogleCloudPlatform/iap-desktop/releases).
1. Extract the package into the `PolicyDefinitions` folder of your
[central store :octicons-link-external-16:](https://docs.microsoft.com/en-us/troubleshoot/windows-server/group-policy/create-central-store-domain-controller).
Before you can configure a group policy, you must first install the IAP Desktop Policy Templates:

You can now use the IAP Desktop Policy Templates to configure policies:
1. In the [Intune admin center :octicons-link-external-16:](https://intune.microsoft.com/), go to
**Devices > Configuration**.
1. Select the **Import ADMX** tab.
1. Import the following templates:

1. In the **Group Policy Management Console**, create or select a GPO.
1. Link the GPO to an organizational unit that contains the users who should be able to use IAP Desktop.
* **Windows.admx and Windows.adml**: You can find these files on your local computer in the
`C:\Windows\PolicyDefinitions\` directory.

Note: You can configure policies per-computer or per-user. Computer-based policies take precendence
over user-based policies.
* **IapDesktop.admx and IapDesktop.adml**: You can find these files in the
`PolicyTemplates` package from the [downloads page](https://github.com/GoogleCloudPlatform/iap-desktop/releases).

You can now use the IAP Desktop templates to configure a group policy object:

1. Right-click the GPO and select **Edit**.
1. Navigate to **User (or Computer) Configuration > Policies > Administrative Templates > Google IAP Desktop**
and customize policies as necessary.
1. Select the **Policies** tab.
1. Click **Create > New policy** and select the following:

![Policies](images/Policies.png)
+ **Platform**: **Windows 10 and later**
+ **Profile type**: **Templates**
+ **Template name**: **Imported Administrative templates**

1. Close the Group Policy Management Editor window.
1. Click **Create**.
1. On the **Create profile** page, you can now see the IAP Desktop settings:

![Policies](images/Policies-Intune.png){ width="400" }

1. Customize the policy as necessary and assign them to relevant groups.

## Customize server-side policies
## Use server-side group policies to customize Remote Desktop

To disallow clipboard sharing or restrict the usage of other Remote Desktop features,
configure [group policies :octicons-link-external-16:](https://learn.microsoft.com/en-us/windows/client-management/mdm/policy-csp-remotedesktopservices)
Expand Down
Binary file added doc/site/sources/docs/images/Policies-Intune.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.

0 comments on commit 8d17d14

Please sign in to comment.