Deploy Surface app with Microsoft Store for Business and Education
Applies to:
- Surface Laptop (all generations)
- Surface Pro 3 and later
- Surface Laptop Go (all generations)
- Surface Go (all generations).0
- Surface Book (all generations)
- Surface Studio (all generations)
- Surface Laptop Studio (all generations)
- Surface Pro with LTE Advanced (Model 1807)
- Surface Pro (Model 1796)
- Surface 3 LTE
- Surface 3
The Surface app is a lightweight Microsoft Store app that provides control of many Surface-specific settings and options with quick access to device information including serial number, Surface model name, UEFI version, and related drivers.
Surface app comes preinstalled on Surface devices. But if your organization is preparing images for deployment to your Surface devices, you may want to include the Surface app in your imaging and deployment process.
Note
This article does not apply to Surface Pro X or Surface Pro 9 with 5G. For more information, see Deploy, manage, and service ARM-based Surface devices.
Surface app overview
The Surface app is available as a free download from the Microsoft Store. Users can download and install it from the Microsoft Store, but if your organization uses Microsoft Store for Business instead, you may 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 Microsoft Store for Business, see:
Add Surface app to a Microsoft Store for Business account
Before users can install or deploy an app from a company’s Microsoft Store for Business account, the desired app(s) must first be made available and licensed to the users of a business.
If you have not already done so, create a Microsoft Store for Business account.
Sign in to the portal.
Enable offline licensing: click Manage > Settings and then select the Show offline licensed apps to people shopping in the store checkbox, as shown in Figure 1. For more information about Microsoft Store for Business app licensing models, see Apps in Microsoft Store for Business and Education.
Figure 1. Enable apps for offline useAdd Surface app to your Microsoft Store for Business account:
Search the store for Surface app
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.
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 Microsoft 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.
Figure 3. Offline-licensed app acknowledgement
Click OK.
Download Surface app from a Microsoft Store for Business account
After you add an app to the Microsoft Store for Business account in Offline mode, you can download and add the app as an AppxBundle to a deployment share.
Log on to the Microsoft Store for Business account at https://businessstore.microsoft.com
Click Manage->Apps & software. A list of all of your company’s apps is displayed, including the Surface app you added in the Add Surface app to a Microsoft Store for Business account section of this article.
Under Actions, click the ellipsis (…), and then click Download for offline use for the Surface app.
Select the desired Platform and Architecture options from the available selections for the selected app, as shown in Figure 4.
Figure 4. Download the AppxBundle package for an appClick 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.
Click either the Encoded license or Unencoded license option. Use the Encoded license option with management tools like Microsoft Endpoint Configuration Manager or when you use Windows Configuration Designer to create a provisioning package. 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).
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.
Figure 5. Required frameworks for the Surface app
Note
The version numbers of the Surface app and required frameworks will change as the apps are updated. Check for the latest version of Surface app and each framework in Microsoft Store for Business. Always use the Surface app and recommended framework versions as provided by Microsoft Store for Business. Using outdated frameworks or the incorrect versions may result in errors or application crashes.
To download the required frameworks for the Surface app, follow these steps:
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.
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.
Using the procedure described in the How to download Surface app from a Microsoft Store for Business account section of this article, download the Surface app AppxBundle and license file.
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.
In the elevated PowerShell session, copy and paste the following command:
Add-AppxProvisionedPackage –Online –PackagePath <DownloadPath>\ Microsoft.SurfaceHub_10.0.342.0_neutral_~_8wekyb3d8bbwe.AppxBundle –LicensePath <DownloadPath>\ Microsoft.SurfaceHub_8wekyb3d8bbwe_a53ef8ab-9dbd-dec1-46c5-7b664d4dd003.xml
Where
<DownloadPath>
is the folder where you downloaded the AppxBundle and license file from the Microsoft 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
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.
In the elevated PowerShell session, copy and paste the following command:
Add-AppxProvisionedPackage –Online –SkipLicense –PackagePath <DownloadPath>\Microsoft.VCLibs.140.00_14.0.23816.0_x64__8wekyb3d8bbwe.Appx
In the elevated PowerShell session, copy and paste the following command:
Add-AppxProvisionedPackage –Online –SkipLicense –PackagePath <DownloadPath>\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.
Using the procedure described earlier in this article, download the Surface app AppxBundle and license file.
Using the New Application Wizard in the MDT Deployment Workbench, import the downloaded files as a new Application with source files.
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.
Using the procedure described earlier in this article, download the framework files. Store each framework in a separate folder.
Using the New Application Wizard in the MDT Deployment Workbench, import the downloaded files as a new Application with source files.
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:
Open the properties of the Surface app in the MDT Deployment Workbench.
Click the Dependencies tab, and then click Add.
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:
Open your deployment task sequence in the MDT Deployment Workbench.
Add a new Install Application task in the State Restore section of deployment.
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 Prepare for deployment with MDT.
Learn more
Visszajelzés
https://aka.ms/ContentUserFeedback.
Hamarosan elérhető: 2024-ben fokozatosan kivezetjük a GitHub-problémákat a tartalom visszajelzési mechanizmusaként, és lecseréljük egy új visszajelzési rendszerre. További információ:Visszajelzés küldése és megtekintése a következőhöz: