コンテンツ ライブラリのクリーンアップ ツール
Configuration Manager (現在のブランチ) に適用
コンテンツ ライブラリ クリーンアップ コマンド ライン ツールを使用して、配布ポイント上のオブジェクトに関連付けられていないコンテンツを削除します。 この種類のコンテンツは 、孤立したコンテンツと呼ばれます。 このツールは、過去のConfiguration Manager製品でリリースされた同様のツールの古いバージョンを置き換えます。
ツールは、ツールの実行時に指定した配布ポイント上のコンテンツにのみ影響します。 このツールは、サイト サーバー上のコンテンツ ライブラリからコンテンツを削除できません。
サイト システムがオフラインの間に配布ポイントからコンテンツを削除すると、WMI に孤立したレコードが存在する可能性があります。 時間の経過と同時に、この動作によって最終的に配布ポイントの警告状態が発生する可能性があります。 バージョン 2006 以前の問題を軽減するには、WMI から孤立したエントリを手動で削除する必要がありました。 このプロセス中に間違いを犯すと、サーバーに重大な問題が発生する可能性があります。 バージョン 2010 以降では、配布ポイントの WMI プロバイダーから孤立したコンテンツ レコードを削除することもできます。
サイト サーバーで CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanupContentLibraryCleanup.exeを検索します。 この場所の詳細については、「 CD.Latest フォルダー」を参照してください。
要件
一度に 1 つの配布ポイントに対してのみツールを実行します。
配布ポイントをホストするサーバーで直接実行してクリーンアップするか、別のコンピューターからリモートで実行します。
このツールでは、1 つのコンテンツ ライブラリを持つサイト サーバーからのコンテンツの削除はサポートされていません。 サイト サーバーにも配布ポイントの役割がある場合、パッケージがサーバーを対象としていない場合、パッケージは引き続き 1 つのコンテンツ ライブラリ内にあります。
このツールでは、コンテンツが有効なクラウド管理ゲートウェイはサポートされていません。
ツールを実行するユーザー アカウントには、Configuration Managerの完全管理者セキュリティ ロールと同じアクセス許可が必要です。
操作モード
What-if と Delete の 2 つのモードでツールを実行します。
ヒント
what-if モードから開始します。 結果に問題がなければ、 ツールを削除 モードで実行します。
What-if モード
パラメーターを /delete 指定しない場合、ツールは what-if モードで実行されます。 このモードは、配布ポイントから削除されるコンテンツを識別します。
このモードで実行すると、ツールはデータを削除しません。
ツールは、削除するコンテンツに関するログ ファイル情報に書き込みます。 削除の可能性を確認するメッセージは表示されません。
削除モード
パラメーターを指定してツールを /delete 実行すると、ツールは削除モードで実行されます。
このモードで実行すると、指定した配布ポイントで見つかる孤立したコンテンツを配布ポイントのコンテンツ ライブラリから削除できます。
バージョン 2010 以降では、配布ポイントの WMI プロバイダーから孤立したコンテンツ レコードを削除することもできます。
各ファイルを削除する前に、ツールで削除する必要があることを確認します。 さらにプロンプトをスキップし、孤立したすべてのコンテンツを削除するには、[はい] に [ Y ]、[いいえ] に [N ] を選択し、 すべてに [はい ] を選択します。
ログ ファイル
ツールがいずれかのモードで実行されると、ログ ファイルが自動的に作成されます。 次の情報を使用してファイルに名前を付けます。
- ツールが実行されるモード
- 配布ポイントの名前
- 操作の日付と時刻
ツールが完了すると、Windows でログ ファイルが自動的に開きます。
既定では、ツールは、ツールを実行するユーザー アカウントの一時フォルダーにログ ファイルを書き込みます。 この場所は、ツールを実行するコンピューター上にあります。これは、ツールのターゲットとは限りません。 ネットワーク共有を /log 含む別の場所にログ ファイルをリダイレクトするには、 パラメーターを使用します。
ツールを実行する
このツールを実行するには:
管理者としてコマンド プロンプトを開きます。 ディレクトリを、 ContentLibraryCleanup.exeを含むフォルダーに変更します。
必要なコマンド ライン パラメーターと、使用する省略可能なパラメーターを含む コマンド ラインを入力します。
コマンド ライン パラメーター
これらのコマンド ライン パラメーターを任意の順序で使用します。
必須パラメーター
| パラメーター | 詳細 |
|---|---|
/dp <distribution point FQDN> |
クリーンにする配布ポイントの完全修飾ドメイン名 (FQDN) を指定します。 |
/ps <primary site FQDN> |
セカンダリ サイトの配布ポイントからコンテンツをクリーニングする場合にのみ必要です。 このツールは親プライマリ サイトに接続して、SMS プロバイダーに対してクエリを実行します。 これらのクエリを使用すると、ツールは配布ポイント上のコンテンツを決定できます。 その後、削除する孤立したコンテンツを特定できます。 セカンダリ サイトから必要な詳細を直接使用できないため、セカンダリ サイトの配布ポイントに対して親プライマリ サイトへのこの接続を行う必要があります。 |
/sc <primary site code> |
セカンダリ サイトの配布ポイントからコンテンツをクリーニングする場合にのみ必要です。 親プライマリ サイトのサイト コードを指定します。 |
例: 削除するコンテンツをスキャンしてログに記録する (what-if)
ContentLibraryCleanup.exe /dp server1.contoso.com
例: セカンダリ サイトで DP のコンテンツをスキャンしてログに記録する
ContentLibraryCleanup.exe /dp server1.contoso.com /ps siteserver1.contoso.com /sc ABC
オプションのパラメーター
| パラメーター | 詳細 |
|---|---|
/delete |
配布ポイントからコンテンツを削除する準備ができたら、このパラメーターを使用します。 コンテンツを削除する前にメッセージが表示されます。 このパラメーターを使用しない場合、ツールは削除するコンテンツに関する結果をログに記録します。 このパラメーターがないと、実際には配布ポイントからコンテンツは削除されません。 |
/q |
このパラメーターは、すべてのプロンプトを抑制するサイレント モードでツールを実行します。 これらのプロンプトには、コンテンツを削除するタイミングが含まれます。 また、ログ ファイルは自動的には開きません。 |
/ps <primary site FQDN> |
プライマリ サイトの配布ポイントからコンテンツをクリーニングする場合にのみ省略可能です。 配布ポイントが属するプライマリ サイトの FQDN を指定します。 |
/sc <primary site code> |
プライマリ サイトの配布ポイントからコンテンツをクリーニングする場合にのみ省略可能です。 配布ポイントが属するプライマリ サイトのサイト コードを指定します。 |
/log <log file directory> |
ツールがログ ファイルを書き込む場所を指定します。 この場所には、ローカル ドライブまたはネットワーク共有を指定できます。 このパラメーターを使用しない場合、ツールは、ツールが実行されているコンピューター上のユーザーの一時ディレクトリにログ ファイルを配置します。 |
例: コンテンツを削除する
ContentLibraryCleanup.exe /dp server1.contoso.com /delete
例: プロンプトなしでコンテンツを削除する
ContentLibraryCleanup.exe /q /dp server1.contoso.com /delete
例: ローカル ドライブにログを記録する
ContentLibraryCleanup.exe /dp server1.contoso.com /log C:\Users\Administrator\Desktop
例: ネットワーク共有にログを記録する
ContentLibraryCleanup.exe /dp server1.contoso.com /log \\server\share
既知の問題
バージョン 2103 以前では、パッケージまたはデプロイが失敗したか、進行中の場合、ツールは次のエラーを返す可能性があります。
System.InvalidOperationException: This content library cannot be cleaned up right now because package <packageID> is not fully installed.
この問題を回避するには、サイトをバージョン 2107 に更新します。 このツールでは孤立したファイルを確実に識別できませんが、警告が表示され、続行されます。
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示