Exportovat (0) Tisk
Rozbalit vše
EN
Tento obsah není k dispozici ve vašem jazyce, ale můžete využít tuto verzi v anglickém jazyce.

Office Deployment Tool for Click-to-Run

Published: October 11, 2012

Provides information about how to customize and deploy Click-to-Run for Office 365 installations.

Applies to:  Office 365 ProPlus 

Audience: IT Professionals

If you have signed up for Office 365 and provisioned user accounts for the users in your organization, you can enable users to install Office 365 ProPlus (and Project Pro, Visio Pro, SharePoint Designer, or Lync products) directly from the Office 365 portal. This is the default option. In managed enterprise environments, end-users may not have permission to install software from the Office 365 portal. Administrators can use the Office Deployment Tool to manage Click-to-Run installations.

To customize a Click-to-Run for Office 365 installation, administrators run the Office Deployment Tool and provide a custom Configuration.xml configuration file. The Office Deployment Tool performs the tasks that are specified by using the optional properties in the configuration file.

For the Office 2013 release, administrators can run the Office Deployment Tool to perform the following tasks:

  • Generating a Click-to-Run for Office 365 installation source   To do this, administrators prepare a configuration file and run the tool in download mode.

  • Configuring Click-to-Run for Office 365 clients   To do this, administrators prepare a configuration file and run the tool in configure mode.

  • Creating an App-V package   To do this, administrators prepare a configuration file and run the tool in packager mode.

Important Important:

This article is part of the Content roadmap for deploying Office 365 ProPlus for IT Professionals. Use the roadmap as a starting point for articles that help you deploy Office 365 ProPlus in your organization.

Are you looking for help with installing Office with Office 365? You may be looking for Get started with Office 365 and Install Office with Office 365, which will help you learn how to set up and use Office 365 on your computer, phone, and tablet.

In this article:

note Note:

For the latest information about known issues for Click-to-Run, see Office known issues on the office.com site.

Overview

You can download the Office Deployment Tool from the Microsoft Download Center site. Administrators download and run the self-extracting executable file, which contains the Office Deployment Tool .exe file, dynamic link library resources (dlls), and a sample configuration file, configuration.xml.

To run the Office Deployment Tool, administrators must provide:

  • A command line property to specify the mode in which to run the tool

  • A custom Configuration.xml file to specify installation instructions such as the following:

    • Product and languages to install or remove

    • Source path

    • Level of user interface to display

    • Logging options

    • Product updates behavior

Office Deployment Tool command-line properties

You can use the Office Deployment Tool commands to do the following:

  • Specify the mode in which to run the Office Deployment Tool.

    • Use download mode to download Click-to-Run installation source for Office 365 products and languages to an on premise location.

    • Use configure mode to configure, and install Click-to-Run for Office 365 products and languages.

    • Use packager mode to create an App-V package from a Click-to-Run installation source.

  • Indicate the location of the custom Configuration.xml file.

  • Display Help for the tool.

The Office 2013 release supports the following Office Deployment Tool command-line properties:

  • /download

  • /configure

  • /packager

  • /help

note Note:

/packager and /configure. To run these modes you must have elevated privileges or an administrator command prompt.

/download mode

Downloads Click-to-Run for Office 365 product source files.

/download uses the following syntax:

>setup.exe /download <path of Configuration.xml file>

Example:

\\server\share\setup.exe /download \\server\share\CustomC2RConfig.xml

where:

  • setup.exe is the Office Deployment Tool executable

  • \\server\share is the network location of the Setup.exe file and the custom Click-to-Run Configuration.xml file, CustomC2RConfig.xml

  • /download downloads product source files, depending on the options that you define in the Configuration.xml file

For information about the Configuration.xml syntax, see Reference for Click-to-Run configuration.xml file.

Configuration.xml file for use with /download command

The following table lists Configuration.xml file elements that are used to download the Click-to-Run for Office 365 source by using the /download command. For more information about Configuration.xml, see Reference for Click-to-Run configuration.xml file.

Configuration.xml elements used for download mode

Command How download mode uses Configuration.xml file information

/download

Required information:

  • Product(s)

  • OfficeClientEdition (attribute of Add element). Specifies the edition of Click-to-Run for Office 2013 product to use: 32- or 64-bit.

  • Language(s)

Optional information:

  • SourcePath. Indicates the location to save the Click-to-Run source when you run the Office Deployment Tool in download mode. If you do not specify SourcePath, Setup will attempt to create an \Office\Data\... folder structure in the working directory from which you are running setup.exe.

The following example of a Configuration.xml file is used with the /download command to download Office 365 ProPlus Click-to-Run English sources to the following location: \\server\share. Administrators can use any text editor, such as Notepad, to edit the Configuration.xml file that is included with the Office Deployment Tool download.

<Configuration> 
  <Add SourcePath="\\server\share" OfficeClientEdition="32"> 
   <Product ID="O365ProPlusRetail" > 
     <Language ID="en-us" />      
   </Product> 
  </Add> 
</Configuration>
noteNote:

It is possible to use the same Configuration.xml file to run the Office Deployment Tool in both download and configure modes. The required information from the Configuration.xml file that is used depends on the action that is being performed, such as download or installation.

/configure mode

Configures, installs, or removes Click-to-Run for Office 365 products and languages, and applies any options that you specify in the custom Click-to-Run Configuration.xml file.

/configure uses the following syntax:

>setup.exe /configure <path of Click-to-Run Configuration.xml file>

Example:

\\server\share\Setup.exe /configure \\server\share\MycustomC2RConfig.xml

where:

  • setup.exe is the Office Deployment Tool executable

  • \\server\share is the network location of the Setup.exe file and the custom Click-to-Run Configuration.xml file, MycustomC2RConfig.xml in this example

  • /configure configures, installs, or removes products that are based on the options that you define in the custom Configuration.xml file

Configuration.xml file for use with /configure command

The following table lists Click-to-Run Configuration.xml file elements that administrators use to install, remove, or update products by using the /configure command. For more information about Configuration.xml, see Reference for Click-to-Run configuration.xml file.

Configuration.xml elements used for configure mode

command How configure mode uses Click-to-Run Configuration.xml file information

/configure

For installing products

Required:

  • Product

  • OfficeClientEdition (attribute of Add element). Specifies the edition of Click-to-Run for Office 2013 product to use: 32- or 64-bit.

  • Language

Optional:

  • SourcePath. Indicates the installation source path from which to install Office. If you do not specify SourcePath, Setup will attempt to find an \Office\Data\... folder structure in the working directory from which you are running setup.exe. Then it will fall back to install directly from the external Content Delivery Network Internet source.

  • Version. Specifies a build to use for the package. The default is to use the most recently advertised build (as defined in v32.CAB or v64.CAB at the Click-to-Run Office source).

  • Update controls

  • Logging

  • Display level

For removing products

Required:

  • Remove All or Remove Specified products

Optional:

  • Product(s)

  • Product(s) plus Language(s)

  • Logging

  • Display level

For Office Setting changes (updates only)

Required:

  • Update controls

Optional:

  • Logging

The following example shows a Click-to-Run Configuration.xml file that is used with the /configure command to install Office 365 ProPlus Click-to-Run English source from the following location: \\server\share. Display level is set to None and the end-user licensing agreement is accepted.

<Configuration> 
 <Add SourcePath="\\Server\share" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />        
    </Product> 
 </Add> 
 <Display Level="None" AcceptEULA="TRUE" />
</Configuration> 

/packager mode

You can use the Office Deployment Tool to create App-V packages from Office 2013 Click-to-Run installation sources. To create an App-V package for Office 2013, run the Office Deployment Tool in packager mode. This will convert the Office 2013 Click-to-Run package into an App-V package.

/packager uses the following syntax:

>setup.exe /packager <Configuration.xml file path> <output path>

For example:

\\server\share\setup.exe /packager \\server\share\Configuration.xml <output path>

where:

  • setup.exe is the Office Deployment Tool executable.

  • \\server\share is the network location of the Setup.exe file and the custom Click-to-Run Configuration.xml file.

  • /packager converts the Click-to-Run package into an App-V package.

  • <output path> specifies the location in which to place the App-V package that is created (output). For example, \\server\share\Office15AppV.

Configuration.xml file for packager mode

The following table lists the elements that must be included in the Configuration.xml file for packager mode

Configuration.xml elements used for packager mode

Command How packager mode uses Click-to-Run Configuration.xml file information

/packager

Required:

  • Add. Specifies the products and languages to include in the package.

  • OfficeClientEdition (attribute of Add element). Specifies the edition of Click-to-Run for Office 2013 product to use: 32- or 64-bit. The task fails if OfficeClientEdition is not set to a valid value.

  • Product. Specifies the Click-to-Run product to include in the package. You can include more than one product. For example, you can specify O365ProPlusRetail, VisioProRetail, and ProjectProRetail.

  • Language. Specifies the language to be installed.

Optional:

  • SourcePath (attribute of Add element). Specifies the path of the Click-to-Run Office source from which the App-V package will be made when running the Office Deployment Tool in packager mode. If SourcePath is not set, Click-to-Run Setup will attempt to find an \Office\Data\... folder structure in the working directory from which you are running setup.exe. Then it will fall back to install directly from the external Content Delivery Network Internet source.

  • Version (attribute of Add element). Specifies a build to use for the package. Defaults to latest advertised build (as defined in v32.CAB or the v64.CAB at the Click-to-Run Office source).

The following example of a custom configuration file shows the required elements and attributes to use for creating an App-V package.

<Configuration>
  <Add SourcePath="C:\OfficeSource\" OfficeClientEdition="32" >
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
</Configuration>

The previous example specifies the 32-bit edition of Office Professional Plus 2013, English (US), and the location of the Click-to-Run source. You can customize the configuration file by using a text editor such as Notepad. Make sure that you include the required elements and attributes that are listed in the Configuration.xml elements used for packager mode table.

/help

Provides Help for the Office Deployment Tool commands.

Byl tento obsah pro vás užitečný?
(Zbývající počet znaků: 1500)
Děkujeme za váš názor.
Zobrazit:
© 2014 Microsoft