ドキュメント

Unity Engine

User Manual

Script Reference

Unity Engine

Manage your license through the command line

Use the command line to activate or return your license.
読み終わるまでの所要時間 6 分最終更新 13日前
To use Unity, you need an activated license.
The primary license activation method for Unity Pro and Unity Personal is the Unity Hub. For information about activating a Unity Industry license, refer to the Unity Support article, How to activate or return a Unity Industry license.
The following information covers an alternate method to Unity Hub for activating and returning a license for Unity Pro, by using the command line. You might consider this method in situations such as:
  • You have internet access, but you use Unity in headless mode (without a GUI) for automated tasks, such as builds and tests.
  • You have internet access, but you’re unable or unwilling to install the Unity Hub.
注
The following procedures don’t apply to Unity Personal. To activate a license for Unity Personal, log in to the Unity Hub. To return a Personal license, log out of the Unity Hub.
If you don’t know your Unity license information, speak to the Owner of your license. Owners can assign a seat to you via the Organization, or you can contact Unity Customer Service.

Activate a license from the command line

Before activating your Unity license by using the command line, make sure that the license file folder exists. Refer to Unity license file location in License troubleshooting. Also make sure that you have write permission to this folder.

macOS

Enter the following command into the Terminal to launch Unity and activate your license:
<unity-command-location> -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username 'name@example.com' -password 'XXXXXXXXXXXXX'
Notes:
  • Replace 
    <unity-command-location>
    with the full path to your Unity Editor application, concatenated with 
    /Contents/MacOS/Unity
    . Tip: Use Unity Hub's Installs window to determine the installation path of your Unity Editor application. For example, if you installed a 
    2022.2.0b4
    Editor to the default location, 
    <unity-command-location>
    is:
    /Applications/Unity/Hub/Editor/2022.2.0b4/Unity.app/Contents/MacOS/Unity
  • If you want to activate a named user license without activating its serial key, use the same command, but omit your serial key after specifying the 
    -serial
    keyword:
    ... -serial -username 'name@example.com' -password 'XXXXXXXXXXXXX'

macOS example 1

The following example activates a named user license without activating its serial key:
/Applications/Unity/Hub/Editor/2022.2.0b4/Unity.app/Contents/MacOS/Unity -quit -batchmode -serial -username 'name@example.com' -password 'XXXXXXXXXXXXX'

macOS example 2

The following example activates a serial key. If your plan supports named user licensing, it activates that license and also activates its serial key.
/Applications/Unity/Hub/Editor/2022.2.0b4/Unity.app/Contents/MacOS/Unity -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Windows

Enter the following command into the Command Prompt to launch Unity and activate your license:
"<editor-installation-location>" -quit -batchmode -serial E3-XXXX-XXXX-XXXX-XXXX-XXXX -username name@example.com -password XXXXXXXXXXXXX
Notes:
  • Replace 
    <editor-installation-location>
    with the full path to your Unity Editor application. Tip: Use Unity Hub's Installs window to determine the installation path of your Unity Editor application. For example, if you installed a 
    2022.2.0b4
    Editor to the default location, 
    <editor-installation-location>
    is:
    C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe
  • If you want to activate a named user license without activating its serial key, use the same command, but omit your serial key after specifying the 
    -serial
    keyword:
    ... -serial -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Windows example 1

The following example activates a named user license without activating its serial key:
"C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe" -quit -batchmode -serial -username name@example.com -password XXXXXXXXXXXXX

Windows example 2

The following example activates a serial key. If your plan supports named user licensing, it activates that license and also activates its serial key.
"C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe" -quit -batchmode -serial E3-XXXX-XXXX-XXXX-XXXX-XXXX -username name@example.com -password XXXXXXXXXXXXX

Linux

Enter the following command into the Terminal to launch Unity and activate your license:
<unity-command-location> -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username 'name@example.com' -password 'XXXXXXXXXXXXX'
Notes:
  • Replace 
    <unity-command-location>
    with the full path to your Unity Editor application. Tip: Use Unity Hub's Installs window to determine the installation path of your Unity Editor application. For example, if you used Unity Hub to install the Unity Editor to your home directory, 
    <unity-command-location>
    is:
    /home/<username>/Unity/Hub/Editor/<version>/Unity
  • If you want to activate a named user license without activating its serial key, use the same command, but omit your serial key after specifying the 
    -serial
    keyword:
    ... -serial -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Linux Example 1

The following example activates a named user license without a serial key:
/home/username/Unity/Hub/Editor/2022.2.0b4/Unity -quit -batchmode -serial -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Linux Example 2

The following example activates a serial key. If your plan supports named user licensing, it activates that license and also activates its serial key:
/home/username/Unity/Hub/Editor/2022.2.0b4/Unity -quit -batchmode -serial SB-XXXX-XXXX-XXXX-XXXX-XXXX -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Next steps and troubleshooting

Wait several seconds after running this command to give Unity enough time to communicate with the license server. If activation fails, you can open the Editor.log for information. For any activation errors, check Activation issues to find a solution for your issue.

Returning the license through the command line

macOS

Enter the following command into the Terminal to return the license:
<unity-command-location> -quit -batchmode -returnlicense -username 'name@example.com' -password 'XXXXXXXXXXXXX'
Replace 
<unity-command-location>
with the full path to your Unity Editor application, concatenated with 
/Contents/MacOS/Unity
. For example, if you installed a 
2022.2.0b4
Editor to the default location, 
<unity-command-location>
is:
/Applications/Unity/Hub/Editor/2022.2.0b4/Unity.app/Contents/MacOS/Unity

macOS example

/Applications/Unity/Hub/Editor/2022.2.0b4/Unity.app/Contents/MacOS/Unity -quit -batchmode -returnlicense -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Windows

Enter the following into the Command Prompt to return the license
"<editor-installation-location>" -quit -batchmode -returnlicense -username name@example.com -password XXXXXXXXXXXXX
Replace 
<editor-installation-location>
with the full path to your Unity Editor application. For example, if you installed a 
2022.2.0b4
Editor to the default location, 
<editor-installation-location>
is:
C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe

Windows example

"C:\Program Files\Unity\Hub\Editor\2022.2.0b4\Editor\Unity.exe" -quit -batchmode -returnlicense -username name@example.com -password XXXXXXXXXXXXX

Linux

Enter the following command into the Terminal to return the license:
<unity-command-location> -quit -batchmode -returnlicense -username 'name@example.com' -password 'XXXXXXXXXXXXX'
Replace 
<unity-command-location>
with the full path to your Unity Editor application. For example, if you used Unity Hub to install the Unity Editor to your home directory, 
<unity-command-location>
is:
/home/<username>/Unity/Hub/Editor/<version>/Unity

Linux Example

The following example returns a Unity license:
/home/username/Unity/Hub/Editor/2022.2.0b4/Unity -quit -batchmode -returnlicense -username 'name@example.com' -password 'XXXXXXXXXXXXX'

Next steps and troubleshooting

Wait a few seconds after running this command to give Unity enough time to communicate with the license server. To verify your license return, in Unity Hub select Licenses from the side menu. If you experience issues, refer to Troubleshooting.

Additional resources