Office 배포 도구 개요

The Office Deployment Tool (ODT) is a command-line tool that you can use to download and deploy Microsoft 365 Apps to your client computers. The ODT gives you more control over an Office installation: you can define which products and languages are installed, how those products should be updated, and whether or not to display the install experience to your users.

엔터프라이즈 관리자가 아니며 가정 또는 회사에 Office를 설치하려는 경우 Office 365로 Office 설치를 참조하세요.

Office 배포 도구 다운로드

Office 배포 도구를 Microsoft 다운로드 센터에서 다운로드합니다.

파일을 다운로드한 후에 Office 배포 도구 실행 파일(setup.exe) 및 샘플 구성 파일(configuration.xml)이 포함된 자동 압축 풀기 실행 파일을 실행합니다.

ODT를 사용하여 Office를 다운로드하거나 설치하기 전에 최신 버전이 있는지 확인하는 것이 좋습니다.

최신 버전의 ODT에 대한 변경 내용을 자세히 보려면 Office 배포 도구의 릴리스 기록을 참조하세요.

Office 배포 도구 시작

The ODT consists of two files: setup.exe and configuration.xml. To work with the tool, you edit the configuration file to define what options you want, and then run setup.exe from the command line. For example, you can edit the configuration file to install the 64-bit English edition of Office with the EULA automatically accepted. For the full set of options, see Configuration options for the Office Deployment Tool.

참고

Best practice: This article shows the XML elements and attributes in the configuration file for the Office Deployment Tool. You can continue to create the configuration file in a text editor, but we recommend using the Office Customization Tool instead. With the Office Customization Tool, you can easily create and modify configuration files in a web-based interface. For more information, see Overview of the Office Customization Tool.

ODT를 실행할 때 구성 파일의 위치를 제공하고 ODT를 실행해야 할 모드 를 정의합니다.

  • To download Microsoft 365 Apps products and languages, use download mode. Example: setup.exe /download downloadconfig.xml. When you download Office to a folder that already contains that version of Office, the ODT will conserve your network bandwidth by downloading only the missing files. For example, if you use the ODT to download Office in English and German to a folder that already contains Office in English, only the German language pack will be downloaded.

  • To install the downloaded Microsoft 365 Apps products and languages on a client computer, use configure mode. You also use configure mode to remove and update Office products and languages. Example: setup.exe /configure installconfig.xml

  • To apply new application preferences to client computers that already have Microsoft 365 Apps installed, use customize mode. This mode will apply only application preferences, without changing any other deployment settings. Example: setup.exe /customize preferencesconfig.xml

  • To create an App-V package from the downloaded Microsoft 365 Apps products and languages, use packager mode. Example: setup.exe /packager packageconfig.xml

도움말 모드를 사용하여 도구의 명령줄 도움말도 확인할 수 있습니다.

Microsoft 365 Apps용 설치 파일 다운로드

Office CDN(콘텐츠 배달 네트워크)에서 Microsoft 365 Apps용 설치 파일을 다운로드하려면 다음 단계를 수행합니다.

1단계: 구성 파일 만들기

When creating the configuration file, we recommend starting with an example file and updating it with the appropriate options for your environment. You can start by copying and pasting the example below into a text file, saving it with a name of your choosing, and then editing the XML elements and attributes to define the options you want.

이 예제에서 구성 파일은 32비트 영어 버전의 엔터프라이즈용 Microsoft 365 Apps 및 Visio 데스크톱 앱 구독 버전의 설치 파일을 네트워크의 \\server\share로 다운로드합니다.

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

구성 옵션에 대한 자세한 내용 및 추가 예제는 Office 배포 도구의 구성 옵션을 참조하세요.

2단계: 다운로드 모드로 ODT 실행 파일 실행

From a command prompt, run the ODT executable in download mode and with a reference to the configuration file you saved. In this example, the configuration file is named downloadconfig.xml:

setup.exe /download downloadconfig.xml

3단계: 파일이 다운로드되었는지 유효성 검사

After running the command, go to the download location you defined in the configuration file and look for an Office folder with the appropriate files in it. If you run into problems, make sure you have the newest version of the ODT. You can also troubleshoot issues by reviewing the log file in the %temp% folder.

로컬 원본에서 Microsoft 365 앱용 설치 파일 다운로드

You can use the Office Deployment Tool to download the installation files for Microsoft 365 Apps from a local source on your network. By doing so, you can store a central copy of multiple languages and products for Office and distribute just the languages and products that you need to other locations on your network.

To download from a local source, follow the steps for downloading Office with the ODT, but include in your configuration file the download path, which defines where the installation files are downloaded from. For example, this configuration file downloads a 32-bit English edition of Microsoft 365 Apps for enterprise from \\servera\share (the DownloadPath) to \\serverb\share (the SourcePath):

<Configuration> 
  <Add SourcePath="\\serverb\share" OfficeClientEdition="32" Version="16.0.6741.2056" DownloadPath="\\servera\share"> 
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />      
    </Product> 
  </Add> 
</Configuration>

DownloadPath를 사용하는 경우 버전 을 지정해야 합니다.

Microsoft 365 Apps 설치

After you download Microsoft 365 Apps installation files, follow these steps to install Office on a client computer. As part of that installation, you can choose which products to install.

1단계: 구성 파일 만들기

When creating the configuration file, we recommend starting with an example file and updating it with the appropriate options for your environment. You can start by copying and pasting the example below into a text file, saving it with a name of your choosing, and then editing the XML elements and attributes to define the options you want.

이 예제에서 구성 파일은 Publisher를 제외한 32비트 영어 버전의 엔터프라이즈용 Microsoft 365 Apps를 설치합니다.

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

The location of the Office installation files is \\server\share. The display level is set to None, which means the user will not see any user interface during the install. The AcceptEULA is set to TRUE, which means your users will not have to click to accept the EULA during the installation.

구성 옵션에 대한 자세한 내용은 Office 배포 도구의 구성 옵션을 참조하세요.

2단계: 구성 모드로 ODT 실행 파일 실행

From a command prompt, run the ODT executable in configure mode with a reference to the configuration file you saved. In the following example, the configuration file is named installconfig.xml:

setup.exe /configure installconfig.xml

You must have local administrator permissions on the client computer. You can run the executable from the client computer on which you want to install Office or you can put the ODT and the configuration file on a network share and run it from there. If you use a network share, make sure to pass the full network path for both the setup.exe and the configuration file to the command.

3단계: 설치에 성공했는지 확인

After running the command, you should see the Office installation start (unless you set display level to none). After installation is complete, the command prompt will display "Products configured successfully." If you run into problems, make sure you have the newest version of the ODT. You can also troubleshoot issues by reviewing the log files in the %temp% folder.

Microsoft 365 앱 업데이트

You can use the Office Deployment Tool to make updates to your client computers after installing Microsoft 365 Apps. There are two ways to make the updates:

  • Use the ODT to install Microsoft 365 Apps again, which will update Office to the newest version. Only the files that have changed in the new version will be updated.

  • Use the ODT to download the Office installation files and then point your client computers to that location to receive their updates. (By default, clients are updated directly from the Office Content Delivery Network (CDN).)

To change where your client computers receive their updates, run the ODT in configure mode and specify an update path in the configuration file. For example, to have Microsoft 365 Apps get updates automatically from a network share called \\server\updates, include the following line in your configuration.xml file:

<Updates Enabled="TRUE" UpdatePath="\\server\updates" />

This article does not cover all the issues related to managing updates for Office in your organization. For more information on that scenario, including using Group Policy, see Choose how to manage updates to Microsoft 365 Apps.

클라이언트 컴퓨터에서 Microsoft 365 앱 응용 프로그램 제외 또는 제거

When installing Microsoft 365 Apps, you can exclude specific applications. To do so, follow the steps for installing Office with the ODT, but include the ExcludeApp element in your configuration file. For example, this configuration file installs all the Microsoft 365 Apps for enterprise applications except Publisher:

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <ExcludeApp ID="Publisher" />
    </Product>
</Add>

If you've already installed Microsoft 365 Apps, you can also use the ExcludeApp element to remove an application that you've previously installed. For example, the configuration file above removes Publisher from the previous installation of Office.

You can also remove an entire language version of Microsoft 365 Apps. To do so, follow the steps for excluding products for installing Office with the ODT, but replace the configuration file with one that uses the Remove element. For example, this configuration file removes the Spanish language version of Microsoft 365 Apps for enterprise:

<Configuration> 
 <Remove>
    <Product ID="O365ProPlusRetail" > 
      <Language ID="es-es" />        
    </Product> 
 </Remove>
</Configuration> 

앱 제외 또는 제거 옵션에 대한 자세한 내용은 Office 배포 도구의 구성 옵션을 참조하세요.

Microsoft 365 앱 또는 기타 응용 프로그램 설치 시 OneDrive 제외

OneDrive is automatically installed when you install Microsoft 365 Apps or install individual applications, such as Word, Excel, PowerPoint, Publisher, Visio, or Skype. If you don't want OneDrive installed with those applications, use the ExcludeApp element to remove it, as shown in the example.

<Add SourcePath="\\Server\share" Version="15.1.2.3" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" >
      <Language ID="en-us" />
      <ExcludeApp ID="OneDrive" />
    </Product>
</Add>

여러 언어 또는 일치 언어 배포

언어 배포에 관한 자세한 내용은 Microsoft 365 Apps에 언어 배포 개요를 참조하세요.

Microsoft 365 앱에 응용 프로그램 기본 설정 적용

As part of your deployment, you can define application preferences for Microsoft 365 Apps, including VBA Macro notifications, default file locations, and default file formats. To do so, you deploy Office using the standard steps in Install Microsoft 365 Apps, but you include application preferences as part of your configuration file.

구성 파일을 만들려면 전체 사용자 인터페이스가 포함된 웹 응용 프로그램인 간편 실행용 Office 사용자 지정 도구를 사용하는 것이 좋습니다.

  1. 웹 브라우저에서 간편 실행용 Office 사용자 지정 도구를 열고 단계에 따라 표준 배포 설정과 함께 응용 프로그램 기본 설정을 정의하는 작업을 포함하여 구성 파일 만드는 작업을 진행합니다.
  2. 파일을 내보냅니다.
  3. Microsoft 365 Apps 설치의 단계에 따라 새로 만든 구성 파일을 사용하여 Office를 배포합니다.

이 예제에서 구성 파일은 32비트 영어 버전의 엔터프라이즈용 Microsoft 365 앱을 설치하고 Excel의 모든 VBA 매크로에 대한 보안 표시줄을 표시합니다.

<Configuration>
  <Add OfficeClientEdition="32" Channel="Current">
    <Product ID="O365ProPlusRetail">
      <Language ID="en-us" />
    </Product>
  </Add>
  <AppSettings>
    <User Key="software\microsoft\office\16.0\excel\security"
          Name="vbawarnings" 
          Value="3" 
          Type="REG_DWORD" 
          App="excel16" 
          Id="L_VBAWarningsPolicy" />
  </AppSettings>
</Configuration>

This file was created with the Office Customization Tool for Click-to-Run. For more information on the app preferences, we recommend browsing the options in the tool itself.

참고: Office가 설치된 경우 구성 파일에 정의된 앱 기본 설정이 장치의 모든 기존 사용자와 나중에 장치에 추가된 새 사용자에게 적용됩니다.

Microsoft 365 앱의 기존 설치에 응용 프로그램 기본 설정 적용

You can apply new application preferences to client computers that already have Microsoft 365 Apps installed without changing any other deployment setting. To do so, create a configuration file that contains application preferences and then run the ODT in customize mode. Customize mode ignores all other settings in the configuration file except application preferences.

  1. 응용 프로그램 기본 설정 정의의 단계를 사용하여 구성 파일을 만듭니다.
  2. From a command prompt, run the ODT executable in customize mode with a reference to the configuration file you created. In the following example, the configuration file is named installapppreferences.xml:

setup.exe /customize installapppreferences.xml

You must run the executable from the client computer on which you want to apply the app preferences and you must have local administrator permissions on that computer. When using customize mode, the app preferences defined in the configuration file are applied to all existing users of the device and any new users added to the device in the future. If you apply application preferences when Office apps are running, the preferences will be applied when Office is next restarted.

Microsoft 365 앱용 App-V 패키지 만들기

In addition to downloading and deploying Microsoft 365 Apps, you can use the Office Deployment Tool to create App-V packages. To do so, update the configuration file and then run the ODT in packager mode. You must create App-V packages on a computer that has a clean install of the operating system.

This article does not cover all the issues related to deploying App-V packages. For more information on that scenario, see Deploying Microsoft Office 2016 by Using App-V.

1단계: 구성 파일 만들기

When creating the configuration file, we recommend starting with an example file and updating it with the appropriate options for your environment. You can start by copying and pasting the example below into a text file, saving it with a name of your choosing, and then editing the XML elements and attributes to define the options you want.

이 예제에서 구성 파일은 Publisher를 제외한 32비트 영어 버전의 엔터프라이즈용 Microsoft 365 Apps에서 App-V 패키지를 만듭니다.

<Configuration> 
 <Add SourcePath="\\Server\share" OfficeClientEdition="32">
    <Product ID="O365ProPlusRetail" > 
      <Language ID="en-us" />        
      <ExcludeApp ID="Publisher" />
    </Product> 
 </Add> 
</Configuration> 

The location of the Office installation files is \\server\share. For your configuration file, substitute the example values with the appropriate option for your environment. For more information about the options, see Configuration options for the Office Deployment Tool,

2단계: 패키지 작성 도구 모드로 ODT 실행 파일 실행

From a command prompt, run the ODT executable in packager mode with a reference to the configuration file you saved and to the location where you want to save the App-V package. In the following example, the configuration file is named packageconfig.xml and the App-V package will be saved to \\server\share\appv\:

setup.exe /packager packageconfig.xml \\server\share\appv\

3단계: 패키지가 생성되었는지 확인

After running the command, the package location should have an App-V Packages folder and a WorkingDir folder. You can troubleshoot issues by reviewing the log file in the %temp% folder.