6.8 KiB
title, description, ms.author, ms.topic, ms.prod, ms.technology, author, ms.date, ms.reviewer, manager
| title | description | ms.author | ms.topic | ms.prod | ms.technology | author | ms.date | ms.reviewer | manager |
|---|---|---|---|---|---|---|---|---|---|
| Office CSP | The Office configuration service provider (CSP) enables a Microsoft Office client to be installed on a device. This CSP was added in Windows 10, version 1703. | vinpa | article | w10 | windows | vinaypamnani-msft | 08/15/2018 | aaroncz |
Office CSP
The table below shows the applicability of Windows:
| Edition | Windows 10 | Windows 11 |
|---|---|---|
| Home | No | No |
| Pro | Yes | Yes |
| Windows SE | No | Yes |
| Business | Yes | Yes |
| Enterprise | Yes | Yes |
| Education | Yes | Yes |
The Office configuration service provider (CSP) enables a Microsoft Office client to be installed on a device via the Office Deployment Tool (ODT). For more information, see Configuration options for the Office Deployment Tool and How to assign Office 365 apps to Windows 10 devices with Microsoft Intune.
This CSP was added in Windows 10, version 1703.
For more information, see Office DDF.
The following shows the Office configuration service provider in tree format.
./Vendor/MSFT
Office
----Installation
--------id
------------Install
------------Status
./Device/Vendor/MSFT
Office
----Installation
--------id
------------Install
------------Status
./Vendor/MSFT
./Device/Vendor/MSFT
Office
----Installation
--------id
------------Install
------------Status
./Device/Vendor/MSFT/Office/ or ./User/Vendor/MSFT/Office
The root node for the Office configuration service provider.
Installation
Specifies the options for the Microsoft Office installation.
The supported operations are Add, Delete, and Get.
Installation/id
Specifies a unique identifier that represents the ID of the Microsoft Office product to install.
The supported operations are Add, Delete, and Get.
Installation/id/Install
Installs Office by using the XML data specified in the configuration.xml file.
The supported operations are Get and Execute.
Installation/id/Status
The Microsoft Office installation status.
The only supported operation is Get.
Installation/id/FinalStatus
Added in Windows 10, version 1809. Indicates the status of the Final Office 365 installation.
The only supported operation is Get.
Behavior:
- When Office CSP is triggered to install, it will first check if the FinalStatus node exists or not. If the node exists, delete it.
- When Office installation reaches any terminal states (either success or failure), this node is created that contains the following values:
- When status = 0: 70 (succeeded)
- When status!= 0: 60 (failed)
Installation/CurrentStatus
Returns an XML of current Office 365 installation status on the device.
The only supported operation is Get.
Examples
Sample SyncML to install Microsoft 365 Apps for business Retail from current channel.
<SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody>
<Exec>
<CmdID>7</CmdID>
<Item>
<Target>
<LocURI>./Vendor/MSFT/Office/Installation/0AA79349-F334-4859-96E8-B4AB43E9FEA0/install</LocURI>
</Target>
<Meta>
<Format xmlns="syncml:metinf">chr</Format>
</Meta>
<Data><Configuration><Add OfficeClientEdition="32" Channel="Current"><Product ID="O365BusinessRetail"><Language ID="en-us" /></Product></Add><Display Level="None" AcceptEULA="TRUE" /></Configuration></Data>
</Item>
</Exec>
<Final/>
</SyncBody>
</SyncML>
To uninstall the Office 365 from the system:
<SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody>
<Exec>
<CmdID>7</CmdID>
<Item>
<Target>
<LocURI>./Vendor/MSFT/Office/Installation/E24B23D8-94A8-4997-9E6E-8FF25025845B/install</LocURI>
</Target>
<Meta>
<Format xmlns="syncml:metinf">chr</Format>
</Meta>
<Data><Configuration><Remove All="TRUE"/><Display Level="None" AcceptEULA="TRUE" /></Configuration></Data>
</Item>
</Exec>
<Final/>
</SyncBody>
</SyncML>
To get the current status of Office 365 on the device.
<SyncML xmlns="SYNCML:SYNCML1.2">
<SyncBody>
<Get>
<CmdID>7</CmdID>
<Item>
<Target>
<LocURI>./Vendor/MSFT/Office/Installation/CurrentStatus</LocURI>
</Target>
</Item>
</Get>
<Final/>
</SyncBody>
</SyncML>
Status code
| Status | Description | Comment |
|---|---|---|
| 0 | Installation succeeded | OK |
| 997 | Installation in progress | |
| 13 | ERROR_INVALID_DATA Cannot verify signature of the downloaded Office Deployment Tool (ODT) |
Failure |
| 1460 | ERROR_TIMEOUT Failed to download ODT |
Failure |
| 1602 | ERROR_INSTALL_USEREXIT User canceled the installation |
Failure |
| 1603 | ERROR_INSTALL_FAILURE Failed any pre-req check. |
Failure |
| 17000 | ERROR_PROCESSPOOL_INITIALIZATION Failed to start C2RClient |
Failure |
| 17001 | ERROR_QUEUE_SCENARIO Failed to queue installation scenario in C2RClient |
Failure |
| 17002 | ERROR_COMPLETING_SCENARIO Failed to complete the process. Possible reasons: |
Failure |
| 17003 | ERROR_ANOTHER_RUNNING_SCENARIO Another scenario is running |
Failure |
| 17004 | ERROR_COMPLETING_SCENARIO_NEED_CLEAN_UP Possible reasons:
|
Failure |
| 17005 | ERROR_SCENARIO_CANCELLED_AS_PLANNED | Failure |
| 17006 | ERROR_SCENARIO_CANCELLED Blocked update by running apps |
Failure |
| 17007 | ERROR_REMOVE_INSTALLATION_NEEDED The client is requesting client clean-up in a "Remove Installation" scenario |
Failure |
| 17100 | ERROR_HANDLING_COMMAND_LINE C2RClient command-line error |
Failure |
| 0x80004005 | E_FAIL ODT cannot be used to install Volume license |
Failure |
| 0x8000ffff | E_UNEXPECTED Tried to uninstall when there is no C2R Office on the machine. |
Failure |