From 93ac15f72a5c843e5a07251f4caf9493a796c5ba Mon Sep 17 00:00:00 2001 From: Payge Winfield Date: Thu, 23 Jan 2020 15:22:46 -0800 Subject: [PATCH 1/6] Created 3 documents in and changed TOC --- devices/hololens/TOC.md | 6 +- .../hololens-commercial-infrastructure.md | 113 ++++++++++++++++++ .../hololens-licenses-requirements.md | 50 ++++++++ devices/hololens/images/AzureAD1.PNG | Bin 0 -> 28330 bytes devices/hololens/images/aad-kioskmode.PNG | Bin 0 -> 34758 bytes 5 files changed, 167 insertions(+), 2 deletions(-) create mode 100644 devices/hololens/hololens-commercial-infrastructure.md create mode 100644 devices/hololens/hololens-licenses-requirements.md create mode 100644 devices/hololens/images/AzureAD1.PNG create mode 100644 devices/hololens/images/aad-kioskmode.PNG diff --git a/devices/hololens/TOC.md b/devices/hololens/TOC.md index d9ff00d3a8..54e3d65b15 100644 --- a/devices/hololens/TOC.md +++ b/devices/hololens/TOC.md @@ -16,9 +16,11 @@ ## [Install localized version of HoloLens (1st gen)](hololens1-install-localized.md) ## [Getting around HoloLens (1st gen)](hololens1-basic-usage.md) -# HoloLens in commercial environments -## [Commercial feature overview](hololens-commercial-features.md) +# Deploying HoloLens and Mixed Reality Apps in Commercial Environments ## [Deployment planning](hololens-requirements.md) +## [Commercial feature overview](hololens-commercial-features.md) +## [Lincense Requriements](hololens-licenses-requirements.md) +## [Commercial Infrastructure Guidance](hololens-commercial-infrastructure) ## [Unlock Windows Holographic for Business features](hololens1-upgrade-enterprise.md) ## [Configure HoloLens using a provisioning package](hololens-provisioning.md) ## [Enroll HoloLens in MDM](hololens-enroll-mdm.md) diff --git a/devices/hololens/hololens-commercial-infrastructure.md b/devices/hololens/hololens-commercial-infrastructure.md new file mode 100644 index 0000000000..bf37f7bea4 --- /dev/null +++ b/devices/hololens/hololens-commercial-infrastructure.md @@ -0,0 +1,113 @@ +--- +title: Infrastructure Guidelines for HoloLens +description: +ms.prod: hololens +ms.sitesec: library +author: Payge Winfield +ms.author: +audience: ITPro +ms.topic: article +ms.localizationpriority: high +ms.date: 1/23/2020 +ms.reviewer: +manager: +appliesto: +- HoloLens (1st gen) +- HoloLens 2 +--- + +# Configure Your Network + +This portion of the document will require the following people: +1. Network Admin with permissions to make changes to the proxy/firewall +2. Azure Active Directory Admin +3. Mobile Device Manager Admin +4. Teams admin for Remote Assist only + +## Infrastructure Requirements + +### HoloLens Specific Network Requirements +Make sure that these ports and URLs are allowed on your network firewall. This will enable HoloLens to function properly. The latest list can be found [here](hololens-offline.md). + +### Remote Assist Specific Network Requirements + +1. The recommended bandwidth for optimal performance of Remote Assist is 1.5Mbps. Detailed network requirements and additional information can be found [here](https://docs.microsoft.com/en-us/MicrosoftTeams/prepare-network). +**Please note, if you don’t network have network speeds of at least 1.5Mbps, Remote Assist will still work. However, quality may suffer.** +1. Make sure that these ports and URLs are allowed on your network firewall. This will enable Microsoft Teams to function. The latest list can be found [here](https://docs.microsoft.com/en-us/office365/enterprise/urls-and-ip-address-ranges#skype-for-business-online-and-microsoft-teams). + +### Guides Specific Network Requirements +Guides only require network access to download and use the app. + +## Azure Active Directory Guidance +This step is only necessary if your company plans on managing the HoloLens and mixed reality apps. + +### 1. Ensure that you have an Azure AD License. +Please [HoloLens Licenses Requirements](hololens-licenses-requirements)for additional information. + +### 2. Ensure that your company’s users are in Azure Active Directory (Azure AD). +Instructions for adding users can be found [here](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/add-users-azure-active-directory). + +### 3. We suggest that users who will be need similar licenses are added to a group. +1. [Create a Group](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-groups-create-azure-portal) + +2. [Add users to groups](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-groups-members-azure-portal) + +### 4. Ensure that your company’s users (or group of users) are assigned the necessary licenses. +Directions for assigning licenses can be found [here](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/license-users-groups). + +### 5. **IMPORTANT:** Only do this step if users are expected to enroll their HoloLens/Mobile device onto the network. +These steps ensure that your company’s users (or a group of users) can add devices. +1. Option 1: Give all users permission to join devices to Azure AD. +**Sign in to the Azure portal as an administrator** > **Azure Active Directory** > **Devices** > **Device Settings** > +**Set Users may join devices to Azure AD to *All*** + +1. Option 2: Give selected users/groups permission to join devices to Azure AD +**Sign in to the Azure portal as an administrator** > **Azure Active Directory** > **Devices** > **Device Settings** > +**Set Users may join devices to Azure AD to *Selected*** +![Image that shows Configuration of Azure AD Joined Devices](images/AzureAD1.png) + +1. Option 3: You can block all users from joining their devices to the domain. This means that all devices will need to be manually enrolled by your IT department. + +## Mobile Device Manager Admin Steps + +### Scenario 1: Kiosk Mode +As a note, auto-launching an app does not currently work for HoloLens. + +How to Set Up Kiosk Mode Using Microsoft Intune. +#### 1. Sync Microsoft Store to Intune ([Here](https://docs.microsoft.com/en-us/intune/apps/windows-store-for-business)) + +#### 2. Check your app settings + +1. Log into your Microsoft Store Business account +1. **Manage** > **Products and Services** > **Apps and Software** > **Select the app you want to sync** > **Private Store Availability** > **Select “Everyone” or “Specific Groups”** +1. If you do not see your apps in **Intune** > **Client Apps** > **Apps** , you may have to [sync your apps](https://docs.microsoft.com/en-us/intune/apps/windows-store-for-business#synchronize-apps) again. + +#### 3. Configuring Kiosk Mode using MDM + +Information on configuring Kiosk Mode in Intune can be found [here](https://docs.microsoft.com/en-us/hololens/hololens-kiosk#set-up-kiosk-mode-using-microsoft-intune-or-mdm-windows-10-version-1803) + + >[!NOTE] + >You can configure different users to have different Kiosk Mode experiences by using “Azure AD” as the “User logon type”. However, this option is only available in Multi-App kiosk mode. Multi-App kiosk mode will work with only one app as well as multiple apps. + +![Image that shows Configuration of Kiosk Mode in Intune](images/aad-kioskmode.png) + +If you are configuring Kiosk Mode on an MDM other than Intune, please check your MDM provider's documentation. + +## Additional Intune Quick Links + +1. [Create Profiles:](https://docs.microsoft.com/en-us/intune/configuration/device-profile-create) Profiles allow you to add and configure settings that will be pushed to the devices in your organization. + +1. [CSPs (Confiruration Service Providers)](https://docs.microsoft.com/en-us/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices) allows you to create and deploy management settings for the devices on your network. Some CSPs are supported by HoloLens devices. (See the list of CSPs for HoloLens [here](https://docs.microsoft.com/en-us/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices). + +1. [Create Compliance Policy](https://docs.microsoft.com/en-us/intune/protect/create-compliance-policy) + +1. ☐ Conditional Access allows/denies mobile devices and mobile applications from accessing company resources. Two documents you may find helpful are [Plan your CA Deployment](https://docs.microsoft.com/en-us/azure/active-directory/conditional-access/plan-conditional-access) and [Best Practices](https://docs.microsoft.com/en-us/azure/active-directory/conditional-access/best-practices). + +## Certificates and Authentication +### MDM Certificate Distribution +If your company requires certificates, Intune supports PKCS, PFX, and SCEP. It is important to understand which certificate is right for your company. Please visit [here](https://docs.microsoft.com/en-us/intune/protect/certificates-configure) to determine which cert is best for you. If you plan to use certs for HoloLens Authentication, PFX or SCEP may be right for you. + +Steps for SCEP can be found [here](https://docs.microsoft.com/en-us/intune/protect/certificates-profile-scep). + +### Device Certificates +Certificates can also be added to the HoloLens through package provisioning. Please see [HoloLens Provisioning](hololens-provisioning) for additional information. diff --git a/devices/hololens/hololens-licenses-requirements.md b/devices/hololens/hololens-licenses-requirements.md new file mode 100644 index 0000000000..6254bd397b --- /dev/null +++ b/devices/hololens/hololens-licenses-requirements.md @@ -0,0 +1,50 @@ +--- +title: Licenses for Mixed Reality Deployment +description: +ms.prod: hololens +ms.sitesec: library +author: Payge Winfield +ms.author: +audience: ITPro +ms.topic: article +ms.localizationpriority: high +ms.date: 1/23/2020 +ms.reviewer: +manager: +appliesto: +- HoloLens (1st gen) +- HoloLens 2 +--- + +# Licenses Required for Mixed Reality Deployment + +If you plan on using a Mobile Device Management system (MDM) to manage your HoloLens, please review the MDM License Guidance section. + +## Mobile Device Management (MDM) Licenses Guidance + +If you plan on using an MDM other than Intune, an [Azure Active Directory Licenses](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) is required. + +If you plan on suing Intune as your MDM, you can acquire an [Enterprise Mobility + Security (EMS) suite (E3 or E5) licenses](https://www.microsoft.com/en-us/microsoft-365/enterprise-mobility-security/compare-plans-and-pricing). **Please note that Azure AD is included in both suites.** + +## Identify the licenses needed for your scenario and products + +### Remote Assist License Requirements +Make sure you have the required licensing and device. Updated licensing and product requirements can be found [here](https://docs.microsoft.com/en-us/dynamics365/mixed-reality/remote-assist/requirements). + +1. [Remote Assist License](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) +1. [Teams Freemium/Teams](https://products.office.com/en-us/microsoft-teams/free) +1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) + +### Guides License Requirements +Updated licensing and device requirements can be found [here](https://docs.microsoft.com/en-us/dynamics365/mixed-reality/guides/requirements). + +1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) +1. [Power BI](https://powerbi.microsoft.com/en-us/desktop/) +1. [Guides](https://docs.microsoft.com/en-us/dynamics365/mixed-reality/guides/setup) + +### Scenario 1: Kiosk Mode +If you are not planning to use an MDM to manage your device and you are planning to use a local account or an MSA as the login identity, you will not need any additional licenses. Kiosk mode can be accomplished using a provisioning packages. + +1. If you are **not** planning to use an MDM to manage your device and you are planning to use a local account or an MSA as the login identity, you will not need any additional licenses. Kiosk mode can be accomplished using a provisioning packages. +1. If you are planning to use an MDM other than Intune, your MDM provider will have steps on configuring Kiosk mode. +1. If you are planning to use **Intune** as your MDM, implementation directions can be found in [Configuring your Network for HoloLens](). diff --git a/devices/hololens/images/AzureAD1.PNG b/devices/hololens/images/AzureAD1.PNG new file mode 100644 index 0000000000000000000000000000000000000000..e0215265f615530f339edfb10fafc23afed5a720 GIT binary patch literal 28330 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

%mJm#WgcN5OoYqb5oOv&$#?>6Q9iu)rR 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 TGEsr^GAu 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 Date: Thu, 23 Jan 2020 15:51:46 -0800 Subject: [PATCH 2/6] removed en-us and fixed typo --- devices/hololens/TOC.md | 2 +- .../hololens-commercial-infrastructure.md | 30 +++++++++---------- .../hololens-licenses-requirements.md | 20 ++++++------- 3 files changed, 26 insertions(+), 26 deletions(-) diff --git a/devices/hololens/TOC.md b/devices/hololens/TOC.md index 54e3d65b15..d1c0ab596f 100644 --- a/devices/hololens/TOC.md +++ b/devices/hololens/TOC.md @@ -20,7 +20,7 @@ ## [Deployment planning](hololens-requirements.md) ## [Commercial feature overview](hololens-commercial-features.md) ## [Lincense Requriements](hololens-licenses-requirements.md) -## [Commercial Infrastructure Guidance](hololens-commercial-infrastructure) +## [Commercial Infrastructure Guidance](hololens-commercial-infrastructure.md) ## [Unlock Windows Holographic for Business features](hololens1-upgrade-enterprise.md) ## [Configure HoloLens using a provisioning package](hololens-provisioning.md) ## [Enroll HoloLens in MDM](hololens-enroll-mdm.md) diff --git a/devices/hololens/hololens-commercial-infrastructure.md b/devices/hololens/hololens-commercial-infrastructure.md index bf37f7bea4..e6376ed2ee 100644 --- a/devices/hololens/hololens-commercial-infrastructure.md +++ b/devices/hololens/hololens-commercial-infrastructure.md @@ -31,9 +31,9 @@ Make sure that these ports and URLs are allowed on your network firewall. This w ### Remote Assist Specific Network Requirements -1. The recommended bandwidth for optimal performance of Remote Assist is 1.5Mbps. Detailed network requirements and additional information can be found [here](https://docs.microsoft.com/en-us/MicrosoftTeams/prepare-network). +1. The recommended bandwidth for optimal performance of Remote Assist is 1.5Mbps. Detailed network requirements and additional information can be found [here](https://docs.microsoft.com/MicrosoftTeams/prepare-network). **Please note, if you don’t network have network speeds of at least 1.5Mbps, Remote Assist will still work. However, quality may suffer.** -1. Make sure that these ports and URLs are allowed on your network firewall. This will enable Microsoft Teams to function. The latest list can be found [here](https://docs.microsoft.com/en-us/office365/enterprise/urls-and-ip-address-ranges#skype-for-business-online-and-microsoft-teams). +1. Make sure that these ports and URLs are allowed on your network firewall. This will enable Microsoft Teams to function. The latest list can be found [here](https://docs.microsoft.com/office365/enterprise/urls-and-ip-address-ranges#skype-for-business-online-and-microsoft-teams). ### Guides Specific Network Requirements Guides only require network access to download and use the app. @@ -45,15 +45,15 @@ This step is only necessary if your company plans on managing the HoloLens and m Please [HoloLens Licenses Requirements](hololens-licenses-requirements)for additional information. ### 2. Ensure that your company’s users are in Azure Active Directory (Azure AD). -Instructions for adding users can be found [here](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/add-users-azure-active-directory). +Instructions for adding users can be found [here](https://docs.microsoft.com/azure/active-directory/fundamentals/add-users-azure-active-directory). ### 3. We suggest that users who will be need similar licenses are added to a group. -1. [Create a Group](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-groups-create-azure-portal) +1. [Create a Group](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-groups-create-azure-portal) -2. [Add users to groups](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-groups-members-azure-portal) +2. [Add users to groups](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-groups-members-azure-portal) ### 4. Ensure that your company’s users (or group of users) are assigned the necessary licenses. -Directions for assigning licenses can be found [here](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/license-users-groups). +Directions for assigning licenses can be found [here](https://docs.microsoft.com/azure/active-directory/fundamentals/license-users-groups). ### 5. **IMPORTANT:** Only do this step if users are expected to enroll their HoloLens/Mobile device onto the network. These steps ensure that your company’s users (or a group of users) can add devices. @@ -74,17 +74,17 @@ These steps ensure that your company’s users (or a group of users) can add dev As a note, auto-launching an app does not currently work for HoloLens. How to Set Up Kiosk Mode Using Microsoft Intune. -#### 1. Sync Microsoft Store to Intune ([Here](https://docs.microsoft.com/en-us/intune/apps/windows-store-for-business)) +#### 1. Sync Microsoft Store to Intune ([Here](https://docs.microsoft.com/intune/apps/windows-store-for-business)) #### 2. Check your app settings 1. Log into your Microsoft Store Business account 1. **Manage** > **Products and Services** > **Apps and Software** > **Select the app you want to sync** > **Private Store Availability** > **Select “Everyone” or “Specific Groups”** -1. If you do not see your apps in **Intune** > **Client Apps** > **Apps** , you may have to [sync your apps](https://docs.microsoft.com/en-us/intune/apps/windows-store-for-business#synchronize-apps) again. +1. If you do not see your apps in **Intune** > **Client Apps** > **Apps** , you may have to [sync your apps](https://docs.microsoft.com/intune/apps/windows-store-for-business#synchronize-apps) again. #### 3. Configuring Kiosk Mode using MDM -Information on configuring Kiosk Mode in Intune can be found [here](https://docs.microsoft.com/en-us/hololens/hololens-kiosk#set-up-kiosk-mode-using-microsoft-intune-or-mdm-windows-10-version-1803) +Information on configuring Kiosk Mode in Intune can be found [here](https://docs.microsoft.com/hololens/hololens-kiosk#set-up-kiosk-mode-using-microsoft-intune-or-mdm-windows-10-version-1803) >[!NOTE] >You can configure different users to have different Kiosk Mode experiences by using “Azure AD” as the “User logon type”. However, this option is only available in Multi-App kiosk mode. Multi-App kiosk mode will work with only one app as well as multiple apps. @@ -95,19 +95,19 @@ If you are configuring Kiosk Mode on an MDM other than Intune, please check your ## Additional Intune Quick Links -1. [Create Profiles:](https://docs.microsoft.com/en-us/intune/configuration/device-profile-create) Profiles allow you to add and configure settings that will be pushed to the devices in your organization. +1. [Create Profiles:](https://docs.microsoft.com/intune/configuration/device-profile-create) Profiles allow you to add and configure settings that will be pushed to the devices in your organization. -1. [CSPs (Confiruration Service Providers)](https://docs.microsoft.com/en-us/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices) allows you to create and deploy management settings for the devices on your network. Some CSPs are supported by HoloLens devices. (See the list of CSPs for HoloLens [here](https://docs.microsoft.com/en-us/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices). +1. [CSPs (Configuration Service Providers)](https://docs.microsoft.com/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices) allows you to create and deploy management settings for the devices on your network. Some CSPs are supported by HoloLens devices. (See the list of CSPs for HoloLens [here](https://docs.microsoft.com/windows/client-management/mdm/configuration-service-provider-reference#csps-supported-in-hololens-devices). -1. [Create Compliance Policy](https://docs.microsoft.com/en-us/intune/protect/create-compliance-policy) +1. [Create Compliance Policy](https://docs.microsoft.com/intune/protect/create-compliance-policy) -1. ☐ Conditional Access allows/denies mobile devices and mobile applications from accessing company resources. Two documents you may find helpful are [Plan your CA Deployment](https://docs.microsoft.com/en-us/azure/active-directory/conditional-access/plan-conditional-access) and [Best Practices](https://docs.microsoft.com/en-us/azure/active-directory/conditional-access/best-practices). +1. ☐ Conditional Access allows/denies mobile devices and mobile applications from accessing company resources. Two documents you may find helpful are [Plan your CA Deployment](https://docs.microsoft.com/azure/active-directory/conditional-access/plan-conditional-access) and [Best Practices](https://docs.microsoft.com/azure/active-directory/conditional-access/best-practices). ## Certificates and Authentication ### MDM Certificate Distribution -If your company requires certificates, Intune supports PKCS, PFX, and SCEP. It is important to understand which certificate is right for your company. Please visit [here](https://docs.microsoft.com/en-us/intune/protect/certificates-configure) to determine which cert is best for you. If you plan to use certs for HoloLens Authentication, PFX or SCEP may be right for you. +If your company requires certificates, Intune supports PKCS, PFX, and SCEP. It is important to understand which certificate is right for your company. Please visit [here](https://docs.microsoft.com/intune/protect/certificates-configure) to determine which cert is best for you. If you plan to use certs for HoloLens Authentication, PFX or SCEP may be right for you. -Steps for SCEP can be found [here](https://docs.microsoft.com/en-us/intune/protect/certificates-profile-scep). +Steps for SCEP can be found [here](https://docs.microsoft.com/intune/protect/certificates-profile-scep). ### Device Certificates Certificates can also be added to the HoloLens through package provisioning. Please see [HoloLens Provisioning](hololens-provisioning) for additional information. diff --git a/devices/hololens/hololens-licenses-requirements.md b/devices/hololens/hololens-licenses-requirements.md index 6254bd397b..15cc24419f 100644 --- a/devices/hololens/hololens-licenses-requirements.md +++ b/devices/hololens/hololens-licenses-requirements.md @@ -22,25 +22,25 @@ If you plan on using a Mobile Device Management system (MDM) to manage your Holo ## Mobile Device Management (MDM) Licenses Guidance -If you plan on using an MDM other than Intune, an [Azure Active Directory Licenses](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) is required. +If you plan on using an MDM other than Intune, an [Azure Active Directory Licenses](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) is required. -If you plan on suing Intune as your MDM, you can acquire an [Enterprise Mobility + Security (EMS) suite (E3 or E5) licenses](https://www.microsoft.com/en-us/microsoft-365/enterprise-mobility-security/compare-plans-and-pricing). **Please note that Azure AD is included in both suites.** +If you plan on suing Intune as your MDM, you can acquire an [Enterprise Mobility + Security (EMS) suite (E3 or E5) licenses](https://www.microsoft.com/microsoft-365/enterprise-mobility-security/compare-plans-and-pricing). **Please note that Azure AD is included in both suites.** ## Identify the licenses needed for your scenario and products ### Remote Assist License Requirements -Make sure you have the required licensing and device. Updated licensing and product requirements can be found [here](https://docs.microsoft.com/en-us/dynamics365/mixed-reality/remote-assist/requirements). +Make sure you have the required licensing and device. Updated licensing and product requirements can be found [here](https://docs.microsoft.com/dynamics365/mixed-reality/remote-assist/requirements). -1. [Remote Assist License](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) -1. [Teams Freemium/Teams](https://products.office.com/en-us/microsoft-teams/free) -1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) +1. [Remote Assist License](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) +1. [Teams Freemium/Teams](https://products.office.com/microsoft-teams/free) +1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) ### Guides License Requirements -Updated licensing and device requirements can be found [here](https://docs.microsoft.com/en-us/dynamics365/mixed-reality/guides/requirements). +Updated licensing and device requirements can be found [here](https://docs.microsoft.com/dynamics365/mixed-reality/guides/requirements). -1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/en-us/azure/active-directory/fundamentals/active-directory-whatis) -1. [Power BI](https://powerbi.microsoft.com/en-us/desktop/) -1. [Guides](https://docs.microsoft.com/en-us/dynamics365/mixed-reality/guides/setup) +1. [Azure Active Directory (Azure AD) License](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) +1. [Power BI](https://powerbi.microsoft.com/desktop/) +1. [Guides](https://docs.microsoft.com/dynamics365/mixed-reality/guides/setup) ### Scenario 1: Kiosk Mode If you are not planning to use an MDM to manage your device and you are planning to use a local account or an MSA as the login identity, you will not need any additional licenses. Kiosk mode can be accomplished using a provisioning packages. From 4ee9315b85cd44ff9c69e065b18fc093ee30784b Mon Sep 17 00:00:00 2001 From: Payge Winfield Date: Mon, 27 Jan 2020 09:09:09 -0800 Subject: [PATCH 3/6] Typo fixes --- devices/hololens/hololens-commercial-infrastructure.md | 2 +- devices/hololens/hololens-licenses-requirements.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/devices/hololens/hololens-commercial-infrastructure.md b/devices/hololens/hololens-commercial-infrastructure.md index e6376ed2ee..7105736b73 100644 --- a/devices/hololens/hololens-commercial-infrastructure.md +++ b/devices/hololens/hololens-commercial-infrastructure.md @@ -101,7 +101,7 @@ If you are configuring Kiosk Mode on an MDM other than Intune, please check your 1. [Create Compliance Policy](https://docs.microsoft.com/intune/protect/create-compliance-policy) -1. ☐ Conditional Access allows/denies mobile devices and mobile applications from accessing company resources. Two documents you may find helpful are [Plan your CA Deployment](https://docs.microsoft.com/azure/active-directory/conditional-access/plan-conditional-access) and [Best Practices](https://docs.microsoft.com/azure/active-directory/conditional-access/best-practices). +1. Conditional Access allows/denies mobile devices and mobile applications from accessing company resources. Two documents you may find helpful are [Plan your CA Deployment](https://docs.microsoft.com/azure/active-directory/conditional-access/plan-conditional-access) and [Best Practices](https://docs.microsoft.com/azure/active-directory/conditional-access/best-practices). ## Certificates and Authentication ### MDM Certificate Distribution diff --git a/devices/hololens/hololens-licenses-requirements.md b/devices/hololens/hololens-licenses-requirements.md index 15cc24419f..5f9912ee60 100644 --- a/devices/hololens/hololens-licenses-requirements.md +++ b/devices/hololens/hololens-licenses-requirements.md @@ -24,7 +24,7 @@ If you plan on using a Mobile Device Management system (MDM) to manage your Holo If you plan on using an MDM other than Intune, an [Azure Active Directory Licenses](https://docs.microsoft.com/azure/active-directory/fundamentals/active-directory-whatis) is required. -If you plan on suing Intune as your MDM, you can acquire an [Enterprise Mobility + Security (EMS) suite (E3 or E5) licenses](https://www.microsoft.com/microsoft-365/enterprise-mobility-security/compare-plans-and-pricing). **Please note that Azure AD is included in both suites.** +If you plan on using Intune as your MDM, you can acquire an [Enterprise Mobility + Security (EMS) suite (E3 or E5) licenses](https://www.microsoft.com/microsoft-365/enterprise-mobility-security/compare-plans-and-pricing). **Please note that Azure AD is included in both suites.** ## Identify the licenses needed for your scenario and products From 3bc9785db4ee010963b75acd7e4d519aa9ba8971 Mon Sep 17 00:00:00 2001 From: Payge Winfield Date: Mon, 27 Jan 2020 09:13:07 -0800 Subject: [PATCH 4/6] Fixed Authoring and Links --- devices/hololens/hololens-commercial-infrastructure.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/devices/hololens/hololens-commercial-infrastructure.md b/devices/hololens/hololens-commercial-infrastructure.md index 7105736b73..4170c2e397 100644 --- a/devices/hololens/hololens-commercial-infrastructure.md +++ b/devices/hololens/hololens-commercial-infrastructure.md @@ -3,8 +3,8 @@ title: Infrastructure Guidelines for HoloLens description: ms.prod: hololens ms.sitesec: library -author: Payge Winfield -ms.author: +author: pawinfie +ms.author: pawinfie audience: ITPro ms.topic: article ms.localizationpriority: high @@ -42,7 +42,7 @@ Guides only require network access to download and use the app. This step is only necessary if your company plans on managing the HoloLens and mixed reality apps. ### 1. Ensure that you have an Azure AD License. -Please [HoloLens Licenses Requirements](hololens-licenses-requirements)for additional information. +Please [HoloLens Licenses Requirements](hololens-licenses-requirements.md)for additional information. ### 2. Ensure that your company’s users are in Azure Active Directory (Azure AD). Instructions for adding users can be found [here](https://docs.microsoft.com/azure/active-directory/fundamentals/add-users-azure-active-directory). @@ -110,4 +110,4 @@ If your company requires certificates, Intune supports PKCS, PFX, and SCEP. It i Steps for SCEP can be found [here](https://docs.microsoft.com/intune/protect/certificates-profile-scep). ### Device Certificates -Certificates can also be added to the HoloLens through package provisioning. Please see [HoloLens Provisioning](hololens-provisioning) for additional information. +Certificates can also be added to the HoloLens through package provisioning. Please see [HoloLens Provisioning](hololens-provisioning.md) for additional information. From d1857a1572974344f88e38df7a2bb9ae57f5f347 Mon Sep 17 00:00:00 2001 From: Payge Winfield Date: Mon, 27 Jan 2020 09:30:25 -0800 Subject: [PATCH 5/6] Changed author information --- devices/hololens/hololens-commercial-infrastructure.md | 2 +- devices/hololens/hololens-licenses-requirements.md | 6 +++--- 2 files changed, 4 insertions(+), 4 deletions(-) diff --git a/devices/hololens/hololens-commercial-infrastructure.md b/devices/hololens/hololens-commercial-infrastructure.md index 4170c2e397..bb42c8d351 100644 --- a/devices/hololens/hololens-commercial-infrastructure.md +++ b/devices/hololens/hololens-commercial-infrastructure.md @@ -10,7 +10,7 @@ ms.topic: article ms.localizationpriority: high ms.date: 1/23/2020 ms.reviewer: -manager: +manager: bradke appliesto: - HoloLens (1st gen) - HoloLens 2 diff --git a/devices/hololens/hololens-licenses-requirements.md b/devices/hololens/hololens-licenses-requirements.md index 5f9912ee60..6d33228879 100644 --- a/devices/hololens/hololens-licenses-requirements.md +++ b/devices/hololens/hololens-licenses-requirements.md @@ -3,14 +3,14 @@ title: Licenses for Mixed Reality Deployment description: ms.prod: hololens ms.sitesec: library -author: Payge Winfield -ms.author: +author: pawinfie +ms.author: pawinfie audience: ITPro ms.topic: article ms.localizationpriority: high ms.date: 1/23/2020 ms.reviewer: -manager: +manager: bradke appliesto: - HoloLens (1st gen) - HoloLens 2 From b1d47dada5bdb8a6c9f62902686e68a7b181292b Mon Sep 17 00:00:00 2001 From: Payge Winfield Date: Tue, 28 Jan 2020 12:44:21 -0800 Subject: [PATCH 6/6] changed image file name --- .../hololens/hololens-commercial-infrastructure.md | 4 ++-- .../images/{AzureAD1.PNG => azure-ad-image.PNG} | Bin 2 files changed, 2 insertions(+), 2 deletions(-) rename devices/hololens/images/{AzureAD1.PNG => azure-ad-image.PNG} (100%) diff --git a/devices/hololens/hololens-commercial-infrastructure.md b/devices/hololens/hololens-commercial-infrastructure.md index bb42c8d351..ad23e185ee 100644 --- a/devices/hololens/hololens-commercial-infrastructure.md +++ b/devices/hololens/hololens-commercial-infrastructure.md @@ -36,7 +36,7 @@ Make sure that these ports and URLs are allowed on your network firewall. This w 1. Make sure that these ports and URLs are allowed on your network firewall. This will enable Microsoft Teams to function. The latest list can be found [here](https://docs.microsoft.com/office365/enterprise/urls-and-ip-address-ranges#skype-for-business-online-and-microsoft-teams). ### Guides Specific Network Requirements -Guides only require network access to download and use the app. +Guides only require network access to download and use the app. ## Azure Active Directory Guidance This step is only necessary if your company plans on managing the HoloLens and mixed reality apps. @@ -64,7 +64,7 @@ These steps ensure that your company’s users (or a group of users) can add dev 1. Option 2: Give selected users/groups permission to join devices to Azure AD **Sign in to the Azure portal as an administrator** > **Azure Active Directory** > **Devices** > **Device Settings** > **Set Users may join devices to Azure AD to *Selected*** -![Image that shows Configuration of Azure AD Joined Devices](images/AzureAD1.png) +![Image that shows Configuration of Azure AD Joined Devices](images/azure-ad-image.png) 1. Option 3: You can block all users from joining their devices to the domain. This means that all devices will need to be manually enrolled by your IT department. diff --git a/devices/hololens/images/AzureAD1.PNG b/devices/hololens/images/azure-ad-image.PNG similarity index 100% rename from devices/hololens/images/AzureAD1.PNG rename to devices/hololens/images/azure-ad-image.PNG