--- title: "CLI itemresコマンド" slug: "the-cli-itemres-command" abstract: "DevEx CLIのitemresコマンドの説明で、リソースファイル内にアイテムパッケージを作成し、設定可能なオプションを持っています。" --- # CLI itemresコマンド [Sitecore Items as Resourcesプラグイン](https://doc.sitecore.com/xp/ja/developers/101/developer-tools/items-as-resources-plugin.html "Items as Resources plugin")にはitemresコマンドが含まれています。このコマンドは、設定可能なオプションを持つリソースファイル内にアイテムパッケージを作成します。 Items as Resourcesプラグインをインストールするには、以下のコードを実行します。 dotnet sitecore plugin add -n Sitecore.DevEx.Extensibility.ResourcePackage --version 4.0.0 > !注このコマンドはCLI 4.0以降から利用可能です。 ## 使用例 コマンドの使い方は以下の通りです: dotnet sitecore itemres subcommand options ## サブコマンド 以下のサブコマンドを使用できます: - [createサブコマンド](https://doc.sitecore.com/xp/ja/developers/101/developer-tools/the-cli-itemres-command.html#UUID-fbe18b6c-f6d0-7648-3de8-9b66cfa873fc_section-idm4545419547297632789751032387 "The create subcommand") - リソースパッケージを作成します。 - [unicornサブコマンド](https://doc.sitecore.com/xp/ja/developers/101/developer-tools/the-cli-itemres-command.html#UUID-fbe18b6c-f6d0-7648-3de8-9b66cfa873fc_section-idm4609581585428832789750803817 "The unicorn subcommand") - ユニコーンリソースパッケージを作成します。 - [cleanupサブコマンド](https://doc.sitecore.com/xp/ja/developers/101/developer-tools/the-cli-itemres-command.html#UUID-fbe18b6c-f6d0-7648-3de8-9b66cfa873fc_section-idm4545419528574432789772612164 "The cleanup subcommand") - .datファイル内のデータベース項目を、両方のエントリのアイテムデータが等しい場合にクリーンアップします。このサブコマンドはCLI 4.1以降で利用可能です。 ### createサブコマンド createサブコマンドは新しいアイテムおよびリソースパッケージを作成します。CLIは慣例items.{databaseName}.{providedName}.datに基づいてパッケージ名を付けます。 createサブコマンドで以下のオプションを使用できます: オプション 必須ですか? 概要 \-o, --output はい パッケージから出力へのパス(提供されていない場合は拡張を追加します)。 \--overwrite いいえ 既存のパッケージを上書きします。 \-i, --include いいえ モジュール構成を含めること。ワイルドカードや複数の値を許可しています。 \-e, --exclude いいえ モジュール構成は明示的に除外してください。ワイルドカードや複数の値は許可されています。 \-c, --config いいえ ルート sitecore.config ディレクトリへのパス。デフォルト:現在の作業ディレクトリ。 \-v, --verbose いいえ 追加の診断およびパフォーマンスデータを報告してください。 \-t, --trace いいえ 追加の診断およびパフォーマンスデータを報告してください。 \-?, -h, --help いいえ コマンドの助けを。 以下はcreateサブコマンドの使用例です。 - コマンド:結果 - dotnet sitecore itemres create -o TestPackage: items.{databaseName}.TestPackage.dat ファイルを作成します。ファイルにはすべてのモジュールが含まれています。 - dotnet sitecore itemres create -o test/TestPackage: testフォルダーにitems.{databaseName}.TestPackage.datファイルを作成します。ファイルにはすべてのモジュールが含まれています。 - 重複名で TestPackage を作成しようとすると:dotnet sitecore itemres create -o TestPackage: パッケージが作成されず、以下のメッセージが表示されます: "The output path items.{databaseName}.TestPackage.dat already existed, but Overwrite was false." - 重複名で TestPackage を作成しようとします:dotnet sitecore itemres create -o TestPackage --overwrite: パッケージを作成して上書きします。 - dotnet sitecore itemres create -o TestPackage -i Project.Content.Test: パッケージを作成し、 Project.Content.Test モジュールのみを含みます。 - dotnet sitecore itemres create -o TestPackage -i Project.Content.Test, Project.Contentパッケージを作成し、 Project.Content.Test モジュールと Project.Content モジュールのみを含みます。 - dotnet sitecore itemres create -o TestPackage -i \*Testパッケージを作成し、 Project.Content.Test モジュールのみを含みます。ワイルドカード接頭辞で見られます。 - dotnet sitecore itemres create -o TestPackage -i \*Test\*パッケージを作成し、 Project.Content.Test モジュールと Project.Content.Test1 モジュールのみを含みます。周辺のワイルドカードとともに見られます。 - dotnet sitecore itemres create -o TestPackage -i Project\*パッケージを作成し、 Project.Content、 Project.Content.Test、 Project.Content.Test1 モジュールを含みます。ワイルドカード接尾辞付きで見られます。 - dotnet sitecore itemres create -o TestPackage -e Project.Content.Testパッケージを作成し、Project.Content.Testモジュールを除くProject.ContentとProject.Content.Test1モジュールのみを含みます。 - dotnet sitecore itemres create -o TestPackage -e Project.Content.Test, Project.Contentパッケージを作成し、Project.ContentおよびProject.Content.Testモジュールを除きProject.Content.Test1モジュールのみを含みます。 - dotnet sitecore itemres create -o TestPackage -e \*Testパッケージを作成し、ワイルドカード接頭辞の Project.Content.Test モジュールを除き、Project.Content と Project.Content.Test1 モジュールのみを含みます。 - dotnet sitecore itemres create -o TestPackage -e \*Test\*パッケージを作成し、 Project.Content 加群のみを含みます。 Project.Content.Test および Project.Content.Test1 加群を除外し、周辺のワイルドカードも含みます。 - dotnet sitecore itemres create -o TestPackage -e Project\*パッケージを作成し、 Project.Content、 Project.Content.Test 、 Project.Content.Test1 モジュールをワイルドカード接尾辞で除外します。 - dotnet sitecore itemres create -o TestPackage -i Project\* -e Project.Content.Testパッケージを作成し、 Project.Content と Project.Content.Test1 モジュールをワイルドカード接尾辞付きで含み、 Project.Content.Test モジュールを除外します。 - dotnet sitecore itemres create -o TestPackage -i Project.Content.Test -e Project.Content.Test: はパッケージを作成せず、以下のメッセージで返されます: The include and exclude options contain same modules at the same time - samplesフォルダからTestPackageを作成しようとします:dotnet sitecore itemres create -o TestPackage: パッケージを作成できず、以下のメッセージが表示されます: error: Couldn't resolve a root configuration file (sitecore.json) in the current or any parent directory. Looks like the command may have been executed outside a Sitecore project? - samplesフォルダからTestPackageを作成しようとします:dotnet sitecore itemres create -o TestPackage -c Prototype/: samplesフォルダにパッケージを作成します。 - dotnet sitecore itemres create -o TestPackage -v: ルート設定パスやパフォーマンスを持つノード数(例:73ms、8.1ms/node)などの追加の診断および性能データを作成します。 - dotnet sitecore itemres create -o TestPackage -t: FSIndex のような追加の診断およびパフォーマンスデータを作成します。例えば、ファイルシステムのインデックスを70ms(9メタデータ)で読み込み、1983ms(9項目、220.3ms/node)で1ツリーのパッケージを作成した場合などです。 ### ユニコーン副司令部 unicornサブコマンドはUnicornシリアライズから特定の名前フォーマットitems.{databaseName}.{providedName}.datで新しいアイテムおよびリソースパッケージを作成します。 unicornサブコマンドで以下のオプションを使用できます: オプション 必須ですか? 概要 \-p, --path はい ユニコーン・シリアライズへの道。 \-o, --output はい パッケージの出力パス(提供されていない場合は拡張を追加します)。複数の値を許可しています。 \--overwrite いいえ 既存のパッケージを上書きします。 \-c, --config いいえ ルート sitecore.config ディレクトリへのパス。デフォルト:現在の作業ディレクトリ。 \-v, --verbose いいえ 追加の診断およびパフォーマンスデータを報告してください。 \-t, --trace いいえ 追加の診断およびパフォーマンスデータを報告してください。 \-?, -h, --help いいえ コマンドの助けを。 以下はunicornサブコマンドの使用例です。 指揮 結果 dotnet sitecore itemres unicorn -p "testItem" -o "TestPackage items.{databaseName}.TestPackage.datファイルを作成します。 ### 清掃小隊 cleanupサブコマンドは、.datファイルに含まれるデータベース項目を、両方のエントリの項目データが等しい場合にクリーンアップします。 > !注このサブコマンドはCLI 4.1以降で利用可能です。 cleanupサブコマンドで以下のオプションを使用できます: オプション 必須ですか? 概要 \-c, --config いいえ sitecore.json設定ファイルへのパス。デフォルト:cwd。 \-n, --environment-name いいえ 使用Sitecore環境の名前付き。デフォルト: 'default'。 \-v, --verbose いいえ 追加の診断およびパフォーマンスデータを報告してください。 \-t, --trace いいえ 追加の診断およびパフォーマンスデータを報告してください。 \-?, -h, --help いいえ コマンドの助けを。 cleanupサブコマンドで以下のオプションを使用できます: - コマンド:結果 - dotnet sitecore itemres cleanup:出力: Starting cleaning up databases. Processing... Cleaning up databases is finished: Cleanup of resource items is finished for 'master' database. Removed: 13 item(s). Cleanup of resource items is finished for 'web' database. Removed: 19 item(s). Cleanup of resource items is finished for 'webpreview' database. Removed: 17 item(s). Cleanup of resource items is finished for 'core' database. Removed: 3 item(s).