diff --git a/README.md b/README.md index bb0cd9ec13..4dc91651ab 100644 --- a/README.md +++ b/README.md @@ -1,2 +1,4 @@ # win-cpub-itpro-docs This repo hosts the WDG ITPro content that is published to TechNet. + +This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information, see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments. \ No newline at end of file diff --git a/devices/surface/TOC.md b/devices/surface/TOC.md index 77680e7199..69a46fdc96 100644 --- a/devices/surface/TOC.md +++ b/devices/surface/TOC.md @@ -1,6 +1,7 @@ # [Surface](index.md) ## [Advanced UEFI security features for Surface Pro 3](advanced-uefi-security-features-for-surface-pro-3.md) ## [Customize the OOBE for Surface deployments](customize-the-oobe-for-surface-deployments.md) +## [Deploy Surface app with Windows Store for Business](deploy-surface-app-with-windows-store-for-business.md) ## [Download the latest firmware and drivers for Surface devices](deploy-the-latest-firmware-and-drivers-for-surface-devices.md) ## [Enable PEAP, EAP-FAST, and Cisco LEAP on Surface devices](enable-peap-eap-fast-and-cisco-leap-on-surface-devices.md) ## [Ethernet adapters and Surface deployment](ethernet-adapters-and-surface-device-deployment.md) diff --git a/devices/surface/deploy-surface-app-with-windows-store-for-business.md b/devices/surface/deploy-surface-app-with-windows-store-for-business.md new file mode 100644 index 0000000000..01fc609a8f --- /dev/null +++ b/devices/surface/deploy-surface-app-with-windows-store-for-business.md @@ -0,0 +1,145 @@ +--- +title: Deploy Surface app with Windows Store for Business (Surface) +description: Find out how to add and download Surface app with Windows Store for Business, as well as install Surface app with PowerShell and MDT. +keywords: surface app, app, deployment, customize +ms.prod: w10 +ms.mktglfcycl: deploy +ms.pagetype: surface, store +ms.sitesec: library +author: miladCA +--- + +#Deploy Surface app with Windows Store for Business + +The Surface app is a lightweight Windows Store app that provides control of many Surface-specific settings and options, including: + +* Enable or disable the Windows button on the Surface device + +* Adjust the sensitivity of a Surface Pen + +* Customize Surface Pen button actions + +* Enable or disable Surface audio enhancements + +* Quick access to support documentation and information for your device + +If your organization is preparing images that will be deployed to your Surface devices, you may want to include the Surface app (formerly called the Surface Hub) in your imaging and deployment process instead of requiring users of each individual device to download and install the app from the Windows Store or your Windows Store for Business. + +####Surface app overview + +The Surface app is available as a free download from the [Windows Store](https://www.microsoft.com/en-us/store/apps/Surface/9WZDNCRFJB8P). Users can download and install it from the Windows Store, but if your organization uses Windows Store for Business instead, you will need to add it to your store’s inventory and possibly include the app as part of your Windows deployment process. These processes are discussed throughout this article. For more information about Windows Store for Business, see [Windows Store for Business](https://technet.microsoft.com/en-us/windows/store-for-business) in the Windows TechCenter. + +##Add Surface app to a Windows Store for Business account + +Before users can install or deploy an app from a company’s Windows Store for Business account, the desired app(s) must first be made available and licensed to the users of a business. + +1. If you have not already done so, create a [Windows Store for Business account](https://www.microsoft.com/en-us/business-store). + +2. Log on to the portal. + +3. Enable offline licensing: click **Settings->Account Information**, and then select the **Show offline licensed apps to people shopping in the store** checkbox, as shown in Figure 1. For more information about Windows Store for Business app licensing models, see [Apps in Windows Store for Business](https://technet.microsoft.com/itpro/windows/manage/apps-in-windows-store-for-business#licensing_model).

+ ![Show offline licenses apps checkbox](images/deploysurfapp-figure1-enablingapps.png "Show offline licenses apps checkbox")
+ *Figure 1. Enable apps for offline use* + +4. Add Surface app to your Windows Store for Business account by following this procedure: + * Click the **Shop** menu. + * In the search box, type **Surface app**, and then click the search icon. + * After the Surface app is presented in the search results, click the app’s icon. + * You are presented with a choice (select **Online** or **Offline**), as shown in Figure 2.

+ + ![Select the Offline licensing mode and add the app to your inventory](images/deploysurfapp-fig2-selectingofflinelicense.png "Select the Offline licensing mode and add the app to your inventory") + + *Figure 2. Select the Offline licensing mode and add the app to your inventory* + + * Click **Offline** to select the Offline licensing mode. + * Click **Get the app** to add the app to your Windows Store for Business inventory. As shown in Figure 3, you’ll see a dialog box that prompts you to acknowledge that offline apps can be deployed using a management tool or downloaded from the company’s inventory page in their private store. + + ![Offline-licensed app acknowledgement window](images/deploysurfapp-fig3-acknowledge.png "Offline-licensed app acknowledgement window") + + *Figure 3. Offline-licensed app acknowledgement* + * Click **OK**. + +##Download Surface app from a Windows Store for Business account +After you add an app to the Windows Store for Business account in Offline mode, you can download and add the app as an AppxBundle to a deployment share. +1. Log on to the Windows Store for Business account at https://businessstore.microsoft.com. +2. Click the **Manage->Inventory** menu. A list of all apps in your company’s private store is displayed, including the Surface app you added in the [Add Surface app to a Windows Store for Business account](#add-surface-app-to-a-windows-store-for-business-account) section of this article. +3. Under **Actions**, click the ellipsis (**…**), and then click **Download for offline use** for the Surface app. +4. Select the desired **Platform** and **Architecture** options from the available selections for the selected app, as shown in Figure 4. + + ![Example of the AppxBundle package](images\deploysurfapp-fig4-downloadappxbundle.png "Example of the AppxBundle package") + + *Figure 4. Download the AppxBundle package for an app* +5. Click **Download**. The AppxBundle package will be downloaded. Make sure you note the path of the downloaded file because you’ll need that later in this article. +6. Click either the **Encoded license** or **Unencoded license** option. Use the Encoded license option with management tools like System Center Configuration Manager or when you use Windows Imaging and Configuration Designer (Windows ICD). Select the Unencoded license option when you use Deployment Image Servicing and Management (DISM) or deployment solutions based on imaging, including the Microsoft Deployment Toolkit (MDT). +7. Click **Generate** to generate and download the license for the app. Make sure you note the path of the license file because you’ll need that later in this article. + +>**Note:**  When you download an app for offline use, such as the Surface app, you may notice a section at the bottom of the page labeled **Required frameworks**. Your target computers must have the frameworks installed for the app to run, so you may need to repeat the download process for each of the required frameworks for your architecture (either x86 or x64) and also include them as part of your Windows deployment discussed later in this article. + +Figure 5 shows the required frameworks for the Surface app. + +![Required frameworks for the Surface app](images\deploysurfapp-fig5-requiredframework.png "Required frameworks for the Surface app") + +*Figure 5. Required frameworks for the Surface app* + +To download the required frameworks for the Surface app, follow these steps: +1. Click the **Download** button under **Microsoft.VCLibs.140.00_14.0.23816.0_x64__8wekyb3d8bbwe**. This downloads the Microsoft.VCLibs.140.00_14.0.23816.0_x64__8wekyb3d8bbwe.Appx file to your specified folder. +2. Click the **Download** button under **Microsoft.NET.Native.Runtime.1.1_1.1.23406.0_x64__8wekyb3d8bbwe**. This downloads the Microsoft.NET.Native.Runtime.1.1_1.1.23406.0_x64__8wekyb3d8bbwe.Appx file to your specified folder. + +>**Note:**  Only the 64-bit (x64) version of each framework is required for Surface devices. Surface devices are native 64-bit UEFI devices and are not compatible with 32-bit (x86) versions of Windows that would require 32-bit frameworks. + +##Install Surface app on your computer with PowerShell +The following procedure provisions the Surface app onto your computer and makes it available for any user accounts created on the computer afterwards. +1. Using the procedure described in the [How to download Surface app from a Windows Store for Business account](#how-to-download-surface-app-from-a-windows-store-for-business-account) section of this article, download the Surface app AppxBundle and license file. +2. Begin an elevated PowerShell session. +>**Note:**  If you don’t run PowerShell as an Administrator, the session won’t have the required permissions to install the app. +3. In the elevated PowerShell session, copy and paste the following command: + ``` + Add-AppxProvisionedPackage –Online –PackagePath \ Microsoft.SurfaceHub_10.0.342.0_neutral_~_8wekyb3d8bbwe.AppxBundle –LicensePath \ Microsoft.SurfaceHub_8wekyb3d8bbwe_a53ef8ab-9dbd-dec1-46c5-7b664d4dd003.xml + ``` + + Where `` is the folder where you downloaded the AppxBundle and license file from the Windows Store for Business account. + + For example, if you downloaded the files to c:\Temp, the command you run is: + ```` + Add-AppxProvisionedPackage –Online –PackagePath c:\Temp\ Microsoft.SurfaceHub_10.0.342.0_neutral_~_8wekyb3d8bbwe.AppxBundle –LicensePath c:\Temp\ Microsoft.SurfaceHub_8wekyb3d8bbwe_a53ef8ab-9dbd-dec1-46c5-7b664d4dd003.xml + ``` + +4. The Surface app will now be available on your current Windows computer. +Before the Surface app is functional on the computer where it has been provisioned, you must also provision the frameworks described earlier in this article. To provision these frameworks, use the following procedure in the elevated PowerShell session you used to provision the Surface app. +5. In the elevated PowerShell session, copy and paste the following command: +``` + Add-AppxProvisionedPackage –Online –SkipLicense –PackagePath \Microsoft.VCLibs.140.00_14.0.23816.0_x64__8wekyb3d8bbwe.Appx +``` +6. In the elevated PowerShell session, copy and paste the following command: + ``` + Add-AppxProvisionedPackage –Online –SkipLicense –PackagePath \Microsoft.NET.Native.Runtime.1.1_1.1.23406.0_x64__8wekyb3d8bbwe.Appx + ``` + +##Install Surface app with MDT +The following procedure uses MDT to automate installation of the Surface app at the time of deployment. The application is provisioned automatically by MDT during deployment and thus you can use this process with existing images. This is the recommended process to deploy the Surface app as part of a Windows deployment to Surface devices because it does not reduce the cross platform compatibility of the Windows image. +1. Using the procedure described [earlier in this article](#how-to-download-surface-app-from-a-windows-store-for-business-account), download the Surface app AppxBundle and license file. +2. Using the New Application Wizard in the MDT Deployment Workbench, import the downloaded files as a new **Application with source files**. +3. On the **Command Details** page of the New Application Wizard, specify the default **Working Directory** and for the **Command** specify the file name of the AppxBundle, as follows: + + * Command: + ``` + Microsoft.SurfaceHub_10.0.342.0_neutral_~_8wekyb3d8bbwe.AppxBundle + ``` + * Working Directory: %DEPLOYROOT%\Applications\SurfaceApp + +For the Surface app to function on the target computer, it will also require the frameworks described earlier in this article. Use the following procedure to import the frameworks required for the Surface app into MDT and to configure them as dependencies. +1. Using the procedure described earlier in this article, download the framework files. Store each framework in a separate folder. +2. Using the New Application Wizard in the MDT Deployment Workbench, import the downloaded files as a new **Application with source files**. +3. On the **Command Details** page, type the file name of each application you downloaded in the **Command** field and the default Working Directory. + +To configure the frameworks as dependencies of the Surface app, use this process: +1. Open the properties of the Surface app in the MDT Deployment Workbench. +2. Click the **Dependencies** tab, and then click **Add**. +3. Select the check box for each framework using the name you provided in the New Application Wizard. + +After import, the Surface app will be available for selection in the **Applications** step of the Windows Deployment Wizard. You can also install the application automatically by specifying the application in the deployment task sequence by following this process: +1. Open your deployment task sequence in the MDT Deployment Workbench. +2. Add a new **Install Application** task in the **State Restore** section of deployment. +3. Select **Install a single application** and specify the **Surface App** as the **Application to be installed**. + +For more information about including apps into your Windows deployments, see [Deploy Windows 10 with the Microsoft Deployment Toolkit](https://technet.microsoft.com/en-us/itpro/windows/deploy/deploy-windows-10-with-the-microsoft-deployment-toolkit). diff --git a/devices/surface/images/deploysurfapp-fig2-selectingofflinelicense.png b/devices/surface/images/deploysurfapp-fig2-selectingofflinelicense.png new file mode 100644 index 0000000000..eb7a2ef787 Binary files /dev/null and b/devices/surface/images/deploysurfapp-fig2-selectingofflinelicense.png differ diff --git a/devices/surface/images/deploysurfapp-fig3-acknowledge.png b/devices/surface/images/deploysurfapp-fig3-acknowledge.png new file mode 100644 index 0000000000..dd59593baf Binary files /dev/null and b/devices/surface/images/deploysurfapp-fig3-acknowledge.png differ diff --git a/devices/surface/images/deploysurfapp-fig4-downloadappxbundle.png b/devices/surface/images/deploysurfapp-fig4-downloadappxbundle.png new file mode 100644 index 0000000000..59b96e327b Binary files /dev/null and b/devices/surface/images/deploysurfapp-fig4-downloadappxbundle.png differ diff --git a/devices/surface/images/deploysurfapp-fig5-requiredframework.png b/devices/surface/images/deploysurfapp-fig5-requiredframework.png new file mode 100644 index 0000000000..24d6e7edd8 Binary files /dev/null and b/devices/surface/images/deploysurfapp-fig5-requiredframework.png differ diff --git a/devices/surface/images/deploysurfapp-figure1-enablingapps.png b/devices/surface/images/deploysurfapp-figure1-enablingapps.png new file mode 100644 index 0000000000..78bfef9e8b Binary files /dev/null and b/devices/surface/images/deploysurfapp-figure1-enablingapps.png differ diff --git a/devices/surface/index.md b/devices/surface/index.md index 447cdeea27..19658afe3a 100644 --- a/devices/surface/index.md +++ b/devices/surface/index.md @@ -43,42 +43,46 @@ For more information on planning for, deploying, and managing Surface devices in

Walk through the process of customizing the Surface out-of-box experience for end users in your organization.

+

[Deploy Surface app with Windows Store for Business](deploy-surface-app-with-windows-store-for-business.md)

+

Find out how to add and download Surface app with Windows Store for Business, as well as install Surface app with PowerShell and MDT.

+ +

[Download the latest firmware and drivers for Surface devices](deploy-the-latest-firmware-and-drivers-for-surface-devices.md)

Get a list of the available downloads for Surface devices and links to download the drivers and firmware for your device.

- +

[Enable PEAP, EAP-FAST, and Cisco LEAP on Surface devices](enable-peap-eap-fast-and-cisco-leap-on-surface-devices.md)

Find out how to enable support for PEAP, EAP-FAST, or Cisco LEAP protocols on your Surface device.

- +

[Ethernet adapters and Surface deployment](ethernet-adapters-and-surface-device-deployment.md)

Get guidance and answers to help you perform a network deployment to Surface devices.

- +

[Manage Surface Dock firmware updates](manage-surface-dock-firmware-updates.md)

Read about the different methods you can use to manage the process of Surface Dock firmware updates.

- +

[Manage Surface driver and firmware updates](manage-surface-pro-3-firmware-updates.md)

Explore the available options to manage firmware and driver updates for Surface devices.

- +

[Manage Surface UEFI settings](manage-surface-uefi-settings.md)

Use Surface UEFI settings to enable or disable devices, configure security settings, and adjust Surface device boot settings.

- +

[Surface Data Eraser](microsoft-surface-data-eraser.md)

Find out how the Microsoft Surface Data Eraser tool can help you securely wipe data from your Surface devices.

- +

[Surface Deployment Accelerator](microsoft-surface-deployment-accelerator.md)

See how Microsoft Surface Deployment Accelerator provides a quick and simple deployment mechanism for organizations to reimage Surface devices.

- +

[Surface Diagnostic Toolkit](surface-diagnostic-toolkit.md)

Find out how you can use the Microsoft Surface Diagnostic Toolkit to test the hardware of your Surface device.

- +

[Surface Dock Updater](surface-dock-updater.md)

Get a detailed walkthrough of Microsoft Surface Dock Updater.