UiPath Documentation
uipath-cli
latest
false
UiPath CLI ユーザー ガイド
重要 :
このコンテンツは機械翻訳によって処理されています。 新しいコンテンツの翻訳は、およそ 1 ~ 2 週間で公開されます。

uip tm project

「uip tm project」の構文とオプション - Test Manager プロジェクト、テナントの既定のプロジェクト、プロジェクト設定、プロジェクト全体の .tmh としてのエクスポートおよびインポートを管理しますパッケージ。

uip tm project は、現在のテナントで Test Manager プロジェクトを管理します。Test Manager プロジェクトは、要件、テスト ケース、テスト セット、実行の最上位のコンテナーです。プロジェクト スコープの uip tm コマンドでは、プロジェクトを選択する --project-key または --project-id が必要です。両方を渡すと、 --project-id が使用されます。

同じグループが、テナントの既定のプロジェクトを読み取って設定し、プロジェクト設定を読み取って更新し、プロジェクト全体を .tmh パッケージにコピーするか、 export パッケージからコピーします import。Test Manager は、検査とダウンロードを uip tm migration するバックグラウンド移行ジョブとして、エクスポートおよびインポートを実行します。

概要​

uip tm project list [--filter <text>] [--limit <number>] [--offset <number>]
uip tm project get-default
uip tm project create --name <name> --project-key <key> [--description <text>]
uip tm project update --project-key <key> [--name <name>] [--description <text>] [--set-default]
uip tm project delete --project-key <key> -y
uip tm project set-default-folder (--project-key <key> | --project-id <id>) --folder-key <uuid>
uip tm project clear-default-folder (--project-key <key> | --project-id <id>)
uip tm project owners list --project-key <key...>
uip tm project settings get (--project-key <key> | --project-id <id>)
uip tm project settings update (--project-key <key> | --project-id <id>) [--time-zone <iana-name>] [--execution-name-format <template>]
uip tm project export (--project-key <key> | --project-id <id>) [--include <content...>] [--exclude <content...>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm project import (--project-key <key> | --project-id <id> | --create-project [--new-project-name <name>] [--new-project-key <key>]) --file <path> [--include <content...>] [--exclude <content...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm project list [--filter <text>] [--limit <number>] [--offset <number>]
uip tm project get-default
uip tm project create --name <name> --project-key <key> [--description <text>]
uip tm project update --project-key <key> [--name <name>] [--description <text>] [--set-default]
uip tm project delete --project-key <key> -y
uip tm project set-default-folder (--project-key <key> | --project-id <id>) --folder-key <uuid>
uip tm project clear-default-folder (--project-key <key> | --project-id <id>)
uip tm project owners list --project-key <key...>
uip tm project settings get (--project-key <key> | --project-id <id>)
uip tm project settings update (--project-key <key> | --project-id <id>) [--time-zone <iana-name>] [--execution-name-format <template>]
uip tm project export (--project-key <key> | --project-id <id>) [--include <content...>] [--exclude <content...>] [--wait --output-file <path> [--overwrite] [--timeout <seconds>] [--poll-interval <seconds>]]
uip tm project import (--project-key <key> | --project-id <id> | --create-project [--new-project-name <name>] [--new-project-key <key>]) --file <path> [--include <content...>] [--exclude <content...>] [--wait [--timeout <seconds>] [--poll-interval <seconds>]]

すべての動詞は、 グローバル オプション と標準の 終了コードを尊重します。すべての動詞は、冗長度の --log-level <level> を受け入れます (debug、 、 info、 warn、 error、 既定値は Information)。

uip tm project list​

現在のテナントにある Test Manager プロジェクトの一覧を表示します。テナントの既定のプロジェクトではIsDefaultがtrueされています。

引数​

設定はありません。

オプション​

フラグ説明
--filter <text>プロジェクトを名前でフィルター処理します。
--limit <number>ページあたりに返されるプロジェクトの最大数既定値は 50です。
--offset <number>スキップする結果の数です。既定値は 0です。
uip tm project list --limit 20 --offset 0
uip tm project list --limit 20 --offset 0

データシェイプ​

{
  "Code": "ProjectsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "ProjectKey": "DEMO",
      "Name": "Demo Project",
      "Description": "Smoke tests",
      "Active": true,
      "AuthorizationEnabled": false,
      "SapConfigured": false,
      "Created": "2025-01-01T00:00:00Z",
      "CreatedBy": "alice@example.com",
      "Updated": "2025-06-01T00:00:00Z",
      "UpdatedBy": "bob@example.com",
      "IsDefault": true
    }
  ]
}
{
  "Code": "ProjectsList",
  "Data": [
    {
      "Id": "a1b2c3d4-0000-0000-0000-000000000001",
      "ProjectKey": "DEMO",
      "Name": "Demo Project",
      "Description": "Smoke tests",
      "Active": true,
      "AuthorizationEnabled": false,
      "SapConfigured": false,
      "Created": "2025-01-01T00:00:00Z",
      "CreatedBy": "alice@example.com",
      "Updated": "2025-06-01T00:00:00Z",
      "UpdatedBy": "bob@example.com",
      "IsDefault": true
    }
  ]
}

UIP TM プロジェクト get-default​

テナントの既定の Test Manager プロジェクトを取得します。テナントに既定のプロジェクトがない場合、コマンドは既定のプロジェクトを作成して返します。

既定のプロジェクトは、 でマークproject listプロジェクトですIsDefault: trueプロジェクトを指定せずにテストを実行した場合、「 プロジェクトなしで実行する」の説明に従って、Test Manager によって結果が既定のプロジェクトに保存されます。別のプロジェクトを既定に設定するには、 を使用しますproject update --set-defaultを使用します。

既定のプロジェクトを作成するには、Test Manager ライセンス、[ TM.Projects スコープ]、およびテナントの Project.Create 権限が必要です。開くことができない既定のプロジェクトが存在する場合、コマンドは権限エラーで失敗します。Test Manager 管理者にアクセスを依頼するか、 project listのプロジェクトを使用します。

引数​

設定はありません。

オプション​

設定はありません。

uip tm project get-default
uip tm project get-default

データシェイプ​

{
  "Code": "ProjectGetDefault",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "Name": "Default Project",
    "Description": "Default project for automated test executions.",
    "Active": true,
    "AuthorizationEnabled": true,
    "SapConfigured": false,
    "Created": "2026-10-01T00:00:00Z",
    "CreatedBy": "alice@example.com",
    "Updated": "2026-10-01T00:00:00Z",
    "UpdatedBy": "alice@example.com",
    "IsDefault": true
  }
}
{
  "Code": "ProjectGetDefault",
  "Data": {
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "Name": "Default Project",
    "Description": "Default project for automated test executions.",
    "Active": true,
    "AuthorizationEnabled": true,
    "SapConfigured": false,
    "Created": "2026-10-01T00:00:00Z",
    "CreatedBy": "alice@example.com",
    "Updated": "2026-10-01T00:00:00Z",
    "UpdatedBy": "alice@example.com",
    "IsDefault": true
  }
}

uip tm project create​

Test Manager プロジェクトを作成します。新しいプロジェクトがアクティブになります。

引数​

設定はありません。

オプション​

フラグ説明
--name <name>必須。プロジェクト名。
--project-key <key>必須。プロジェクト キー: プロジェクト内のすべてのオブジェクト キーのプレフィックス。たとえば、プロジェクト DEMO のオブジェクト キーは のようになります DEMO:1のようになります。
--description <text>自由形式のプロジェクトの説明。既定では空です。
uip tm project create \
  --name "Demo Project" \
  --project-key DEMO \
  --description "Smoke tests"
uip tm project create \
  --name "Demo Project" \
  --project-key DEMO \
  --description "Smoke tests"

データシェイプ​

{
  "Code": "ProjectCreate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}
{
  "Code": "ProjectCreate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}

uip tm project update​

プロジェクトの名前または説明を更新するか、テナントの既定のプロジェクトに設定するか、あるいはその両方を行います。省略したフィールドでは現在の値が保持されます。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>必須。更新するプロジェクトです。
--name <name>新しい名前。
--description <text>新しい説明。
--set-defaultこのプロジェクトをテナントの既定のプロジェクトにします。get-default が返すプロジェクトです。プロジェクトを開くことができるユーザーは変更されません。ユーザーは Tenant Administrator である必要があります。外部アプリケーションには、 TM.Administration スコープと TM.Projects スコープが必要です。

--set-default と --name または --descriptionを使用すると、名前変更が最初に実行されます。その後、既定値の設定に失敗すると、プロジェクトが更新されたものの既定にはなっていないことを示すエラー メッセージが表示されます。

# Rename a project
uip tm project update --project-key DEMO --name "Demo Project (2026)"

# Make a project the tenant default
uip tm project update --project-key DEMO --set-default
# Rename a project
uip tm project update --project-key DEMO --name "Demo Project (2026)"

# Make a project the tenant default
uip tm project update --project-key DEMO --set-default

データシェイプ​

{
  "Code": "ProjectUpdate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project (2026)",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}
{
  "Code": "ProjectUpdate",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Name": "Demo Project (2026)",
    "Description": "Smoke tests",
    "IsDefault": false
  }
}

uip tm project delete​

Test Manager プロジェクトをキーで削除する。削除は永続的で、プロジェクトのテスト ケース、テスト セット、実行履歴が削除されます。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>必須。削除するプロジェクトです。
-y, --yes必須。元に戻せない操作を確定します。CLI ではプロンプトは表示されません。 --yes 指定しない場合、コマンドは Result: "Failure" を返して終了 1。
uip tm project delete --project-key DEMO --yes
uip tm project delete --project-key DEMO --yes

データシェイプ​

{
  "Code": "ProjectDelete",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}
{
  "Code": "ProjectDelete",
  "Data": {
    "ProjectKey": "DEMO",
    "Id": "a1b2c3d4-0000-0000-0000-000000000001",
    "Result": "Deleted"
  }
}

uip tm project set-default-folder​

プロジェクトの既定の Orchestrator フォルダーを設定します。後で作成されたテスト セットは、別のフォルダーを設定しない限り、このフォルダーを継承します。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー。これを渡すか、 --project-idを渡します。
--project-id <id>Test Manager プロジェクト IDの代わりに を使用します--project-key両方を渡すと、 --project-id が使用されます。
--folder-key <uuid>必須。Orchestrator のフォルダー キー (UUID)。uip or folders listから入手します。
uip tm project set-default-folder \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001
uip tm project set-default-folder \
  --project-key DEMO \
  --folder-key f0f0f0f0-0000-0000-0000-000000000001

データシェイプ​

{
  "Code": "ProjectSetDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}
{
  "Code": "ProjectSetDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "FolderKey": "f0f0f0f0-0000-0000-0000-000000000001",
    "Result": "Updated"
  }
}

ProjectKey も --project-id とともに返されます。

uip tm project clear-default-folder​

プロジェクトから既定の Orchestrator フォルダーを削除します。クリア後、新しいテスト セットはフォルダーを自動的に継承しません。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー。これを渡すか、 --project-idを渡します。
--project-id <id>Test Manager プロジェクト IDの代わりに を使用します--project-key両方を渡すと、 --project-id が使用されます。
uip tm project clear-default-folder --project-key DEMO
uip tm project clear-default-folder --project-key DEMO

データシェイプ​

{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}
{
  "Code": "ProjectClearDefaultFolder",
  "Data": {
    "ProjectKey": "DEMO",
    "Result": "Cleared"
  }
}

uip tm project owners list​

1 回の呼び出しで 1 つ以上の Test Manager プロジェクトの所有者のリストを表示する。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key...>必須。1 つ以上のプロジェクト キー (スペース区切りまたは フラグの繰り返し)
# List owners of a single project
uip tm project owners list --project-key DEMO

# List owners of two projects in one call
uip tm project owners list --project-key DEMO DEMO2
# List owners of a single project
uip tm project owners list --project-key DEMO

# List owners of two projects in one call
uip tm project owners list --project-key DEMO DEMO2

データシェイプ​

{
  "Code": "ProjectOwnersList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Owners": [
        {
          "Identifier": "b2c3d4e5-0000-0000-0000-000000000001",
          "LocalIdentifier": "c3d4e5f6-0000-0000-0000-000000000001",
          "IdentityName": "jane.doe@example.com",
          "DisplayName": "Jane Doe",
          "Email": "jane.doe@example.com",
          "FirstName": "Jane",
          "LastName": "Doe",
          "ObjectType": "user",
          "Source": "AzureAD"
        }
      ]
    },
    {
      "ProjectKey": "DEMO2",
      "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
      "Owners": []
    }
  ]
}
{
  "Code": "ProjectOwnersList",
  "Data": [
    {
      "ProjectKey": "DEMO",
      "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
      "Owners": [
        {
          "Identifier": "b2c3d4e5-0000-0000-0000-000000000001",
          "LocalIdentifier": "c3d4e5f6-0000-0000-0000-000000000001",
          "IdentityName": "jane.doe@example.com",
          "DisplayName": "Jane Doe",
          "Email": "jane.doe@example.com",
          "FirstName": "Jane",
          "LastName": "Doe",
          "ObjectType": "user",
          "Source": "AzureAD"
        }
      ]
    },
    {
      "ProjectKey": "DEMO2",
      "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
      "Owners": []
    }
  ]
}

UIP TM プロジェクト設定 Get​

Test Manager プロジェクトの設定を表示する

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー。これを渡すか、 --project-idを渡します。
--project-id <id>Test Manager プロジェクト IDの代わりに を使用します--project-key両方を渡すと、 --project-id が使用されます。
uip tm project settings get --project-key DEMO
uip tm project settings get --project-key DEMO

データシェイプ​

{
  "Code": "ProjectSettingsGet",
  "Data": {
    "Id": "d1e2f3a4-0000-0000-0000-000000000001",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "TimeZone": "Europe/Bucharest",
    "ExecutionNameFormat": "{Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}",
    "MaxNumberOfTestSteps": 250,
    "FolderKey": null,
    "GovernanceEnabled": false,
    "GovernanceSettings": null
  }
}
{
  "Code": "ProjectSettingsGet",
  "Data": {
    "Id": "d1e2f3a4-0000-0000-0000-000000000001",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "ProjectKey": "DEMO",
    "TimeZone": "Europe/Bucharest",
    "ExecutionNameFormat": "{Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}",
    "MaxNumberOfTestSteps": 250,
    "FolderKey": null,
    "GovernanceEnabled": false,
    "GovernanceSettings": null
  }
}

settings update 変更されるのは、 TimeZone と ExecutionNameFormatのみです。FolderKeyを変更するには、 を使用しますset-default-folderを使用します。その他のフィールドは、CLI を介して読み取り専用になります。

UIP TM プロジェクト設定の更新​

プロジェクトのタイム ゾーン、実行名の形式、あるいはその両方を更新する。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー。これを渡すか、 --project-idを渡します。
--project-id <id>Test Manager プロジェクト IDの代わりに を使用します--project-key両方を渡すと、 --project-id が使用されます。
--time-zone <iana-name>プロジェクトのタイム ゾーンを IANA 名として使用します (例: Europe/Bucharest 、 UTC)。Romance Standard Time などの Windows タイム ゾーン名は拒否されます。
--execution-name-format <template>生成されたテスト実行名のテンプレート。既定値は {Execution.Type} - {TestSet.Name} - {Execution.StartTime|yyyyMMdd.HHmmss}です。

--time-zone、--execution-name-format、またはその両方を渡します。どちらも渡すと、 Result: "ValidationError" と ErrorCode: "invalid_argument"で失敗し、要求は送信されません。

実行名テンプレートでは、これらのプレースホルダーがサポートされています。中括弧で囲まれたテキストはリテラルです。

プレースホルダー値 (Value)
{TestSet.Name}テスト セット名。
{Execution.Type}manual、 automated、 autonomous、 exploratory、または unspecified。
{Execution.StartTime}開始時刻。パイプの後に .NET の日付形式を追加します (例: {Execution.StartTime|yyyyMMdd.HHmmss})。
{TestSet.<custom field name>}テスト セットのカスタム フィールドの値。

1024 文字を超えるテンプレートは却下されます。レンダリングされた名前が 1024 文字を超える短いテンプレートは、「」で切り捨て ...。

uip tm project settings update --project-id a1b2c3d4-0000-0000-0000-000000000001 --time-zone Europe/Bucharest

uip tm project settings update --project-key DEMO --time-zone UTC --execution-name-format "{TestSet.Name} - {Execution.StartTime|yyyyMMdd}"
uip tm project settings update --project-id a1b2c3d4-0000-0000-0000-000000000001 --time-zone Europe/Bucharest

uip tm project settings update --project-key DEMO --time-zone UTC --execution-name-format "{TestSet.Name} - {Execution.StartTime|yyyyMMdd}"

データシェイプ​

{
  "Code": "ProjectSettingsUpdate",
  "Data": {
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TimeZone": "Europe/Bucharest",
    "Result": "Updated"
  }
}
{
  "Code": "ProjectSettingsUpdate",
  "Data": {
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TimeZone": "Europe/Bucharest",
    "Result": "Updated"
  }
}

ProjectKey は、 を渡すときに存在 --project-key。設定すると、TimeZoneとExecutionNameFormatが存在します。タイム ゾーンは、独自の要求で最初に適用されます。タイム ゾーンの更新に失敗しても実行名の形式は変更されず、その後実行名の形式が拒否された場合、新しいタイム ゾーンは適用されたままになり、その形式を示すエラー メッセージが表示されます。

UIP TM プロジェクトのエクスポート​

プロジェクトを .tmh パッケージにエクスポートします。Test Manager はバックグラウンド移行ジョブでパッケージを構築し、完了通知を送信しません。--wait指定しない場合、コマンドはジョブを返します。migration getでチェックしてから、 でmigration downloadパッケージを取得します。--waitの場合、コマンドはジョブが完了するまでポーリングを行い、パッケージを --output-fileに書き込みます。

パッケージには、プロジェクトの要件、テスト ケース、テスト セット、ラベル、カスタム フィールド値、添付ファイル、実行が格納されます。--include と --exclude は、次の表の任意の内容を切り替えます。

コンテンツ既定 (Default)を追加します。
automation含むテスト ケースにリンクされたオートメーションの情報。
governance除外ガバナンス情報。
project-config除外プロジェクトの設定。Test Cloud のテナントが必要です。他のテナントは HTTP 403 で拒否します。
prompts除外プロジェクト プロンプト ライブラリからのユーザー定義のプロンプト。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>Test Manager プロジェクト キー。これを渡すか、 --project-idを渡します。
--project-id <id>Test Manager プロジェクト IDの代わりに を使用します--project-key両方を渡すと、 --project-id が使用されます。
--include <content...>パッケージに追加するコンテンツをスペース区切りで区切って表示します: governance、 project-config、 prompts、 automation。
--exclude <content...>同じセットから、パッケージからスペースで区切られた、除外するコンテンツ。--include と --exclude で同じコンテンツに名前を付けることは拒否されます。
--waitエクスポートが完了するまでポーリングを行い、パッケージを --output-fileにダウンロードします。
--output-file <path>.tmh パッケージを記述する場所--waitで必須です。親ディレクトリが存在する必要があります。
--overwrite--output-fileすでに存在する場合は置換します。タイムアウトが設定されていない場合、既存のファイルはエクスポートの開始前に拒否されます。
--timeout <seconds>待機する最大秒数。 0 、タイムアウトがないことを意味します。--waitが必要です。既定値は 1800です。
--poll-interval <seconds>ステータス チェックの間隔 (秒)。--waitが必要です。既定値は 10です。

--waitがない場合、--output-file、--overwrite、--timeout、および--poll-intervalは効果がなく、CLI は警告をログに記録します。ジョブが Failed または Cancelledとして終了した場合、または待機時間がタイムアウトした場合、何も書き込まれません。タイムアウト後もジョブは実行を継続します。後で を使用してパッケージを取得し migration download。

# Export, wait for the job, and write the package
uip tm project export \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --wait \
  --output-file demo.tmh

# Start the export with governance information and without automation information, and return the job
uip tm project export \
  --project-key DEMO \
  --include governance \
  --exclude automation
# Export, wait for the job, and write the package
uip tm project export \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --wait \
  --output-file demo.tmh

# Start the export with governance information and without automation information, and return the job
uip tm project export \
  --project-key DEMO \
  --include governance \
  --exclude automation

データシェイプ ( --waitあり)​

{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Completed",
    "OutputFile": "demo.tmh",
    "Bytes": 481203
  }
}
{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Completed",
    "OutputFile": "demo.tmh",
    "Bytes": 481203
  }
}

データシェイプ ( --waitなし)​

{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Ready",
    "Created": "2026-09-17T10:00:00.000Z",
    "Updated": "2026-09-17T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004"
  },
  "Instructions": "The export runs in the background. Check it with: uip tm migration get --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001. Once it reads Completed, fetch the package with: uip tm migration download --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001 --output-file <path>"
}
{
  "Code": "MigrationExport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000001",
    "Type": "ExportProject",
    "Status": "Ready",
    "Created": "2026-09-17T10:00:00.000Z",
    "Updated": "2026-09-17T10:00:00.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "ProjectId": "a1b2c3d4-0000-0000-0000-000000000001",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004"
  },
  "Instructions": "The export runs in the background. Check it with: uip tm migration get --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001. Once it reads Completed, fetch the package with: uip tm migration download --project-id a1b2c3d4-0000-0000-0000-000000000001 --job-id e5f6a7b8-0000-0000-0000-000000000001 --output-file <path>"
}

--waitされていないDataは、migration get が返すため移行ジョブです。

UIP TM プロジェクトのインポート​

.tmh パッケージを既存のプロジェクトにインポートするか、パッケージから作成された新しいプロジェクトにインポートします。CLI はファイルをチャンクにアップロードし、Test Manager はバックグラウンド移行ジョブで処理します。--waitを指定しないと、コマンドはジョブを返します。migration getで確認します。--waitを指定すると、コマンドはジョブが完了するまでポーリングを行います。

--include と --exclude は、 automation (既定で含まれています)、 governance、 project-config (どちらも既定で除外されています) を切り替えます。project-configインポートするには Test Cloud のテナントが必要です。他のテナントは HTTP 403 で拒否します。

引数​

設定はありません。

オプション​

フラグ説明
--project-key <key>インポート先のプロジェクトのキー。これ、 --project-id、または --create-projectを渡します。
--project-id <id>インポート先のプロジェクトの ID です。の代わりに を使用します--project-key両方を渡すと、 --project-id が使用されます。
--file <path>必須。project exportによって記述された、インポートする.tmhパッケージです。CLI はファイル全体をメモリに読み取り、2 GiB を超えるパッケージ、空のファイル、および有効な manifest.jsonのないファイルを拒否します。
--create-projectパッケージに記載されている名前、キー、説明から対象のプロジェクトを作成します。インポートが完了するまで、プロジェクトはアクティブ化されません。--project-key や --project-idと組み合わせることはできません。
--new-project-name <name>--create-project: パッケージ名の代わりに新しいプロジェクトの名前になります。
--new-project-key <key>--create-project: パッケージのキーの代わりに新しいプロジェクトのキーを使用します。このテナントでは Free である必要があります。
--include <content...>取り込むコンテンツ(スペース区切り): governance、 project-config、 automation。
--exclude <content...>同じセットからスペース区切りで除外するコンテンツ。--include と --exclude で同じコンテンツに名前を付けることは拒否されます。
--waitインポートが完了するまでポーリングを行います。
--timeout <seconds>待機する最大秒数。 0 、タイムアウトがないことを意味します。--waitが必要です。既定値は 14400です。
--poll-interval <seconds>ステータス チェックの間隔 (秒)。--waitが必要です。既定値は 10です。
警告:

インポートに失敗すると、パッケージの一部が対象のプロジェクトに残る可能性があります。再度インポートする前に、そのプロジェクトを確認または削除するか、 を使用して新しいプロジェクトにインポート --create-project --new-project-key <key>。--waitがタイムアウトすると、インポートはバックグラウンドで実行され続けます。コマンドを再度実行すると、すべてが 2 回目にインポートされるため、migration getで確認してください。

インポート --create-project 失敗した場合、作成したプロジェクトはそのまま非アクティブになります。project deleteで削除するか、 を使用してインポート--project-key。

# Import into an existing project and return the job
uip tm project import \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --file demo.tmh

# Create a project from the package without automation information, and wait for the import
uip tm project import \
  --create-project \
  --new-project-key DEMO2 \
  --file demo.tmh \
  --exclude automation \
  --wait
# Import into an existing project and return the job
uip tm project import \
  --project-id a1b2c3d4-0000-0000-0000-000000000001 \
  --file demo.tmh

# Create a project from the package without automation information, and wait for the import
uip tm project import \
  --create-project \
  --new-project-key DEMO2 \
  --file demo.tmh \
  --exclude automation \
  --wait

データシェイプ ( --waitあり)​

{
  "Code": "MigrationImport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000002",
    "Type": "ImportProject",
    "Status": "Completed",
    "SchemaVersion": "1.0.18",
    "Created": "2026-09-17T10:05:00.000Z",
    "Updated": "2026-09-17T10:06:40.000Z",
    "ExecutionStarted": "2026-09-17T10:05:04.000Z",
    "ExecutionFinished": "2026-09-17T10:06:40.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004",
    "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
    "ProjectCreated": true,
    "PackageName": "demo.tmh",
    "Bytes": 481203,
    "Chunks": 1
  }
}
{
  "Code": "MigrationImport",
  "Data": {
    "Id": "e5f6a7b8-0000-0000-0000-000000000002",
    "Type": "ImportProject",
    "Status": "Completed",
    "SchemaVersion": "1.0.18",
    "Created": "2026-09-17T10:05:00.000Z",
    "Updated": "2026-09-17T10:06:40.000Z",
    "ExecutionStarted": "2026-09-17T10:05:04.000Z",
    "ExecutionFinished": "2026-09-17T10:06:40.000Z",
    "CreatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "UpdatedBy": "c3d4e5f6-0000-0000-0000-000000000003",
    "TenantId": "d4e5f6a7-0000-0000-0000-000000000004",
    "ProjectId": "a2b3c4d5-0000-0000-0000-000000000002",
    "ProjectCreated": true,
    "PackageName": "demo.tmh",
    "Bytes": 481203,
    "Chunks": 1
  }
}

Data、migration get が返す移行ジョブに加えて、ターゲット ProjectId、ProjectCreated (プロジェクトを作成したときにtrue--create-project)、アップロードされたPackageName、サイズ (Bytes)、アップロードChunks数 です。--wait指定しない場合、アップロードが完了するとコマンドは を返し、応答にはジョブの migration get コマンドとともにInstructionsが返されます。

  • 移行: export および importの背後にあるジョブを確認してダウンロードします。
  • project-permissions: プロジェクトに対して保持している権限です。
  • プロンプト: パッケージを export --include prompts するプロジェクト プロンプト ライブラリ。
  • テスト ケース: プロジェクト内にテスト ケースを作成します。
  • テスト セット: テスト ケースを実行可能なスイートにグループ化します。

参照​

このページは役に立ちましたか?

接続

ヘルプ リソース サポート(opens in new window)

学習する UiPath アカデミー(opens in new window)

質問する UiPath フォーラム(opens in new window)

最新情報を取得