CLI itemresコマンド

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 を作成しようとすると
  sitecore itemres create -o TestPackage: パッケージが作成されず、以下のメッセージが表示されます:

"The output path items.{databaseName}.TestPackage.dat already existed, but Overwrite was false."

• 重複名で TestPackage を作成しようとします
  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 the same modules at the same time

• samplesフォルダからTestPackageを作成しようとします
  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 might have been executed outside a Sitecore project?

• samplesフォルダからTestPackageを作成しようとします
  sitecore itemres create -o TestPackage -c Prototype/: samplesフォルダにパッケージを作成します。
• dotnet sitecore itemres create -o TestPackage -v: ルート設定パスやパフォーマンスを持つノード数(例
  、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ファイルのデータベース項目を整理します。

!警告このコマンドはキャッシュの完全なクリーンアップを引き起こし、パフォーマンス低下を引き起こす可能性があります。メンテナンスウィンドウ中に実行すべきです。

cleanupサブコマンドで以下のオプションを使用できます:

オプション

概要

-f, --force

フィールド比較なしの強制アイテムのクリーンアップ。バージョン5.1.28から利用可能。

-w, --what-if

アイテムを削除せずにアイテムのクリーンアップをシミュレートできます。バージョン5.1.28から利用可能。

> [!ヒント]
> このオプションは、アイテムが上書きされるかどうかを判定し、その保管場所を特定するために使用できます。

-p,--path

Sitecore クリーンアップのためのアイテムパスまたはGUID。 --force または --what-if オプションを使う場合、Sitecore 10.3で必須です。

-r,--recurse

指定された経路内のすべてのアイテムを再帰的にクリーンアップします。

-c, --config

sitecore.json設定ファイルへのパス。

デフォルト: cwd。

-n, --environment-name <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 'core' database. Removed: 3 item(s).

• dotnet sitecore itemres cleanup --force:出力:

Starting cleaning up databases. Processing... Cleaning up databases is finished: Cleanup of resource items is finished for 'master' database. Removed: 1 item(s). master D /sitecore/content/item1 (3d8f6795-1c4e-462d-8a81-be27b1aec5bd) Cleanup of resource items is finished for 'core' database. Removed: 1 item(s). core D /sitecore/content/item1 (3d8f6795-1c4e-462d-8a81-be27b1aec5bd)

• dotnet sitecore itemres cleanup --what-if:出力:

What if mode is active. No changes will be made. Starting cleaning up databases. Processing... Cleaning up databases is finished: Cleanup of resource items is finished for 'master' database. Removed: 1 item(s). master D /sitecore/content/ItemResCleanUpContent (6f0a7dcd-5a69-409f-bf58-8ee64eda4515) Cleanup of resource items is finished for 'core' database. Removed: 0 item(s).

• dotnet sitecore itemres cleanup --path /sitecore/content/ItemResCleanUpContent --force:出力:

Starting cleaning up databases. Processing... Cleaning up databases is finished: Cleanup of resource items is finished for 'master' database. Removed: 1 item(s). master D /sitecore/content/ItemResCleanUpContent (6f0a7dcd-5a69-409f-bf58-8ee64eda4515) Cleanup of resource items is finished for 'core' database. Removed: 0 item(s).