Skip to content

Commit 0be9099

Browse files
ErikjeMSErikjeMS
authored
Merge pull request #8735 from MicrosoftDocs/release-win365-citrix
merge citrix into app release branch
2 parents 56e6f67 + 67a8cc8 commit 0be9099

6 files changed

Lines changed: 235 additions & 0 deletions

File tree

‎windows-365/enterprise/TOC.yml‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -89,6 +89,12 @@ items:
8989
items:
9090
- name: Set up tenants for Windows 365 Government
9191
href: set-up-tenants-windows-365-gcc.md
92+
- name: Citrix HDX Plus for Windows 365
93+
items:
94+
- name: Requirements
95+
href: requirements-citrix.md
96+
- name: Set up Citrix HDX Plus for Windows 365
97+
href: set-up-citrix.md
9298
- name: Provisioning
9399
items:
94100
- name: Create and assign provisioning policy
@@ -215,6 +221,8 @@ items:
215221
href: connection-errors.md
216222
- name: Provisioning errors
217223
href: provisioning-errors.md
224+
- name: Citrix HDX Plus
225+
href: troubleshoot-citrix-hdx-plus.md
218226
- name: Windows 365 app
219227
href: troubleshoot-windows-365-app.md
220228
- name: Reference

‎windows-365/enterprise/media/set-up-citrix/connectors-tokens.png‎

115 KB
Loading

‎windows-365/enterprise/media/set-up-citrix/turn-on-connector.png‎

120 KB
Loading

‎windows-365/enterprise/requirements-citrix.md‎

Lines changed: 86 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,86 @@
1+
---
2+
# required metadata
3+
title: Requirements to set up Citrix HDX Plus for Windows 365 Enterprise
4+
titleSuffix:
5+
description: Learn about requirements for using Citrix HDX Plus with Windows 365 Enterprise.
6+
keywords:
7+
author: ErikjeMS
8+
ms.author: erikje
9+
manager: dougeby
10+
ms.date: 10/12/2022
11+
ms.topic: overview
12+
ms.service: cloudpc
13+
ms.subservice:
14+
ms.localizationpriority: high
15+
ms.technology:
16+
ms.assetid:
17+
18+
# optional metadata
19+
20+
#ROBOTS:
21+
#audience:
22+
23+
ms.reviewer: aradinger
24+
ms.suite: ems
25+
search.appverid: MET150
26+
#ms.tgt_pltfrm:
27+
ms.custom: intune-azure; get-started
28+
ms.collection: M365-identity-device-management
29+
---
30+
31+
# Requirements for using Citrix HDX Plus for Windows 365 Enterprise
32+
33+
> [!IMPORTANT]
34+
> Citrix HDX Plus is currently in tech preview and isn't officially supported by Citrix.
35+
36+
To use Citrix HDX Plus for Windows 365, you must meet the following requirements:
37+
38+
## Citrix requirements
39+
40+
- Citrix Cloud tenant with HDX Plus for Windows 365 entitlement
41+
- Citrix HDX Plus for Windows 365
42+
- Citrix DaaS Premium
43+
- Citrix DaaS Premium Plus
44+
- Citrix admin account with full admin rights
45+
- Cloud PCs must have access to:
46+
- https://*.*.nssvc.net on TCP 443 and UDP 443 for HDX sessions over TCP and EDT, respectively. If you can’t allow all subdomains in that manner, you can instead use https://*.c.nssvc.net and https://*.g.nssvc.net. For more information, see the [Citrix Support Knowledge Center article CTX270584](https://support.citrix.com/article/CTX270584/citrix-gateway-service-pointsofpresence-pops).
47+
- https://*.xendesktop.net on TCP 443. If you can’t allow all subdomains in that manner, you can use https://<customer_ID>.xendesktop.net, where customer_ID is your Citrix Cloud customer ID as shown in the Citrix Cloud administrator portal.
48+
- For Hybrid Azure Active Directory (Azure AD) joined deployments:
49+
- The Azure AD domain must be synchronized from the Azure AD domain that the Cloud PCs belong to.
50+
- Cloud Connectors to allow Citrix Cloud to connect to your Active Directory domain. For more information, see [Citrix Cloud Connector](https://docs.citrix.com/en-us/citrix-cloud/citrix-cloud-resource-locations/citrix-cloud-connector.html).
51+
52+
## Microsoft requirements
53+
54+
- Microsoft Endpoint Manager entitlement
55+
- Azure AD domain in the same tenant as Microsoft Endpoint Manager
56+
- Windows 365 Enterprise licenses in the same tenant as Microsoft Endpoint Manager
57+
- Azure admin account:
58+
- Azure AD Global Admin for required authorizations in Citrix Cloud.
59+
- Intune Admin for enabling Citrix connector in Microsoft Endpoint Manager.
60+
- For more information about the Windows 365 requirements, see [Windows 365 requirements](requirements.md).
61+
62+
## Supported configurations
63+
64+
Citrix HDX Plus for Windows 365 supports integrating with Windows 365 deployments with for Azure AD joined Cloud PCs and Hybrid Azure AD joined Cloud PCs. The following tables detail the configurations for each scenario.
65+
66+
### Supported infrastructures
67+
68+
| Identity | Citrix Cloud | CVAD (on-premises) | Citrix Workspace | Citrix Storefront | Citrix Gateway Service | Citrix Gateway |
69+
| --- | --- | --- | --- | --- | --- | --- |
70+
| Azure AD joined | Yes | No | Yes | No | Yes | No |
71+
| Hybrid Azure AD joined | Yes | No | Yes | No | Yes | No |
72+
73+
### Supported identity providers
74+
75+
| Identity | Azure AD | Active Directory | Active Directory + Token | Okta | SAML | Citrix Gateway | Adaptive Authentication |
76+
| --- | --- | --- | --- | --- | --- | --- | --- |
77+
| Azure AD joined | Yes | No | No | No | No | No | No |
78+
| Hybrid Azure AD joined | Yes | Yes | Yes | Yes | Yes | Yes | Yes |
79+
80+
> [!NOTE]
81+
> For Hybrid AD joined deployments, if you're using an IdP other than Active Directory or Active Directory + Token, you'll need Citrix Federated Authentication Service (FAS). If you don't use FAS, you won't be able to use single sign-on (SSO) to the Cloud PC. For more information, see the [FAS documentation](https://docs.citrix.com/en-us/federated-authentication-service).
82+
83+
<!-- ########################## -->
84+
## Next steps
85+
86+
[Set up Citrix HDX Plus for Windows 365 Enterprise](set-up-citrix.md).

‎windows-365/enterprise/set-up-citrix.md‎

Lines changed: 62 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,62 @@
1+
---
2+
# required metadata
3+
title: Set up Citrix HDX Plus for Windows 365 Enterprise
4+
titleSuffix:
5+
description: Learn about using Citrix HDX Plus with Windows 365 Enterprise.
6+
keywords:
7+
author: ErikjeMS
8+
ms.author: erikje
9+
manager: dougeby
10+
ms.date: 10/12/2022
11+
ms.topic: overview
12+
ms.service: cloudpc
13+
ms.subservice:
14+
ms.localizationpriority: high
15+
ms.technology:
16+
ms.assetid:
17+
18+
# optional metadata
19+
20+
#ROBOTS:
21+
#audience:
22+
23+
ms.reviewer: aradinger
24+
ms.suite: ems
25+
search.appverid: MET150
26+
#ms.tgt_pltfrm:
27+
ms.custom: intune-azure; get-started
28+
ms.collection: M365-identity-device-management
29+
---
30+
31+
# Set up Citrix HDX Plus for Windows 365 Enterprise
32+
33+
> [!IMPORTANT]
34+
> Citrix HDX Plus is currently in tech preview and isn't officially supported by Citrix.
35+
36+
Citrix HDX Plus for Windows 365 lets you integrate Citrix Cloud with Windows 365. This integration gives you access to Citrix HDX technologies for enhanced Cloud PC security and manageability.
37+
38+
## Set up overview
39+
40+
To set up Citrix HDX Plus for Windows 365 Enterprise, follow these steps. The first two steps are explained here at learn.microsoft.com. The remaining steps are explained on the citrix.com web site.
41+
42+
1. [Fulfill requirements](requirements-citrix.md).
43+
2. [Turn on the Citrix connector in Intune](#turn-on-the-windows-365-citrix-connector-in-intune).
44+
3. [Connect Azure Active Directory to Citrix Cloud](https://docs.citrix.com/en-us/citrix-hdxplus-w365).
45+
4. [Configure Citrix Workspace](https://docs.citrix.com/en-us/citrix-hdxplus-w365).
46+
5. [Connect Windows 365 to Citrix Cloud](https://docs.citrix.com/en-us/citrix-hdxplus-w365).
47+
6. [Assign Citrix licenses to users](https://docs.citrix.com/en-us/citrix-hdxplus-w365).
48+
7. [Provision Cloud PCs](https://docs.citrix.com/en-us/citrix-hdxplus-w365).
49+
50+
### Turn on the Windows 365 Citrix connector in Intune
51+
52+
To turn on the Citrix connector, follow these steps:
53+
54+
1. As a Global administrator, sign in to [Microsoft Endpoint Manager admin center](https://go.microsoft.com/fwlink/?linkid=2109431), select **Tenant administration** > **Connectors and tokens**.
55+
![Screenshot of navigating to Connectors and tokens](./media/set-up-citrix/connectors-tokens.png)
56+
2. Select **Windows 365 Citrix connector (preview)** > next to **Allow people to use Citrix to connect to their Cloud PCs**, set the toggle to **On**.
57+
![Screenshot of turning on the connector](./media/set-up-citrix/turn-on-connector.png)
58+
59+
<!-- ########################## -->
60+
## Next steps
61+
62+
Proceed to the Citrix Cloud to complete the integration. For more information about Citrix HDX Plus set up in Citrix Cloud, see [https://docs.citrix.com/en-us/citrix-hdxplus-w365](https://docs.citrix.com/en-us/citrix-hdxplus-w365).

‎windows-365/enterprise/troubleshoot-citrix-hdx-plus.md‎

Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
---
2+
# required metadata
3+
title: Troubleshoot Citrix HDX Plus for Windows 365
4+
titleSuffix:
5+
description: Troubleshoot Citrix HDX Plus for Windows 365.
6+
keywords:
7+
author: ErikjeMS
8+
ms.author: erikje
9+
manager: dougeby
10+
ms.date: 10/12/2022
11+
ms.topic: troubleshooting
12+
ms.service: cloudpc
13+
ms.subservice:
14+
ms.localizationpriority: high
15+
ms.technology:
16+
ms.assetid:
17+
18+
# optional metadata
19+
20+
#ROBOTS:
21+
#audience:
22+
23+
ms.reviewer: aradinger
24+
ms.suite: ems
25+
search.appverid: MET150
26+
#ms.tgt_pltfrm:
27+
ms.custom: intune-azure; get-started
28+
ms.collection: M365-identity-device-management
29+
---
30+
31+
# Troubleshoot Citrix HDX Plus for Windows 365
32+
33+
When you turn on Citrix HDX Plus for a user, the Citrix Virtual Delivery Agent is automatically installed on that user's Cloud PCs. The agent enables the HDX protocol. If this installation runs into a problem, you'll receive an error message in the All Cloud PC list. The description of the error includes advice on how to troubleshoot the error.
34+
35+
If the Citrix HDX Plus agent installation fails, the user can still connect to their Cloud PC by using Remote Desktop.
36+
37+
While troubleshooting errors, make sure that the following steps have all been successful:
38+
39+
- The users license state is synchronized from Citrix to Microsoft Endpoint Manager, including the users Azure Active Directory (Azure AD) user ID.
40+
- The prerequisites have been met.
41+
- The Citrix connector is enabled and healthy in Microsoft Endpoint Manager.
42+
- The correct permissions have been set for the Citrix third-party apps in Azure AD. For more information on required permissions, see [Requirements for using Citrix HDX Plus for Windows 365 Enterprise](requirements-citrix.md).
43+
- The Azure AD user is added and discoverable in the Citrix console.
44+
- The Citrix agent is downloaded on the Cloud PC.
45+
- The Cloud PC can access Citrix download URL.
46+
- No security policy is blocking PowerShell or any app/agent installation as System.
47+
- The Citrix Virtual Delivery Agent is installed.
48+
- Check **Apps & Features** to see if the Citrix Virtual Apps and Desktops Virtual Delivery Agent is installed on the Cloud PC.
49+
- Check Windows event viewer (eventvwr.msc) logs to make sure that the agent installation is executed.
50+
- Check Citrix installation logs for any failures: %TEMPsystemdrive%\Windows\Temp\Citrix\XenDesktop Installer.
51+
- The Cloud PC is registered into the Citrix cloud tenant.
52+
- Check the Cloud PC registration status in the Citrix configuration console.
53+
- If the Cloud PC is unregistered, check the Application sign-in Windows event viewer (eventvwr.msc) for Citrix Desktop Service errors and warnings.
54+
55+
After you find the root cause, remove the assigned license from the Citrix console and re-add the license. This should trigger a reinstallation of the Citrix Virtual Delivery Agent.
56+
57+
If no other solution works, you can [reprovision](reprovision-cloud-pc.md) the Cloud PC to reattempt the Citrix HDX plus enablement. Reprovisioning will delete the Cloud PC and create a brand new one. All data on the original Cloud PC will be lost. Therefore, reprovisioning should be the last resort to resolve the issue.
58+
59+
## Troubleshoot connection issues
60+
61+
If you’re having connectivity issues with your Citrix HDX Plus Cloud PC, you may want to test the default RDP-based connectivity. This process is a handy troubleshooting technique to determine if the issue is with the Cloud PC or the HDX connectivity.
62+
63+
### Turn on the RDP protocol
64+
65+
When the Citrix HDX Plus protocol is turned on, the Windows 365 remoting protocol remains enabled but inactive. This inactivity means that users trying to connect with the Windows 365 supported Remote Desktop clients (including the HTML5 browser) are blocked by default. Users can only connect by using HDX. Users trying to connect with non-HDX clients will get a generic error message.
66+
67+
You can turn on the RDP protocol so users can sign in with RDP to test the Cloud PC connectivity. You can do either of the following to turn on the RDP protocol:
68+
69+
- [Make a user a local admin](assign-users-as-local-admin.md) on the Cloud PC.
70+
- [Add the user to the Direct Access Users group on the Cloud PC](/windows/client-management/mdm/policy-csp-localusersandgroups?WT.mc_id=Portal-fx).
71+
72+
After taking either of these steps, you might have to reboot the Cloud PC for the group membership updates to take effect. Afterwards, the user will be able to connect by using either RDP or Citrix HDX.
73+
74+
You can now test the connectivity by using RDP, and raise a support case with the relevant support team if problems persist.
75+
76+
<!-- ########################## -->
77+
## Next steps
78+
79+
[Learn about Citrix HDX Plus for Windows 365](set-up-citrix.md).

0 commit comments

Comments
 (0)