콘텐츠 라이브러리 정리 도구

  • 아티클

적용 대상: Configuration Manager(현재 분기)

콘텐츠 라이브러리 정리 명령줄 도구를 사용하여 배포 지점의 개체와 더 이상 연결되지 않은 콘텐츠를 제거합니다. 이 유형의 콘텐츠를 분리된 콘텐츠라고 합니다. 이 도구는 이전 Configuration Manager 제품에 대해 릴리스된 유사한 도구의 이전 버전을 대체합니다.

도구는 도구를 실행할 때 지정하는 배포 지점의 콘텐츠에만 영향을 줍니다. 이 도구는 사이트 서버의 콘텐츠 라이브러리에서 콘텐츠를 제거할 수 없습니다.

사이트 시스템이 오프라인 상태일 때 배포 지점에서 콘텐츠를 제거하면 분리된 레코드가 WMI에 있을 수 있습니다. 시간이 지남에 따라 이 동작은 결국 배포 지점에서 경고 상태로 이어질 수 있습니다. 버전 2006 이하의 문제를 완화하려면 WMI에서 분리된 항목을 수동으로 제거해야 했습니다. 이 프로세스 중에 실수를 하면 서버에 더 심각한 문제가 발생할 수 있습니다. 버전 2010부터 도구는 배포 지점의 WMI 공급자에서 분리된 콘텐츠 레코드를 제거할 수도 있습니다.

사이트 서버에서 CD.Latest\SMSSETUP\TOOLS\ContentLibraryCleanupContentLibraryCleanup.exe 찾습니다. 이 위치에 대한 자세한 내용은 CD.Latest 폴더를 참조하세요.

요구 사항

  • 한 번에 하나의 배포 지점에 대해서만 도구를 실행합니다.

  • 배포 지점을 호스트하는 서버에서 직접 실행하여 정리하거나 다른 컴퓨터에서 원격으로 실행합니다.

  • 이 도구는 단일 콘텐츠 라이브러리가 있는 사이트 서버에서 콘텐츠를 제거하는 것을 지원하지 않습니다. 사이트 서버에 배포 지점 역할도 있는 경우 패키지가 서버를 대상으로 하지 않는 경우 패키지는 여전히 단일 콘텐츠 라이브러리에 있습니다.

  • 이 도구는 콘텐츠 사용 클라우드 관리 게이트웨이를 지원하지 않습니다.

  • 도구를 실행하는 사용자 계정에는 Configuration Manager 전체 관리자 보안 역할과 동일한 권한이 있어야 합니다.

작업 모드

다음 두 가지 모드인 What-if 및 Delete에서 도구를 실행 합니다.

팁

what-if 모드로 시작합니다. 결과에 만족하면 삭제 모드에서 도구를 실행합니다.

What-if 모드

매개 변수를 /delete 지정하지 않으면 도구가 what-if 모드로 실행됩니다. 이 모드는 배포 지점에서 삭제될 콘텐츠를 식별합니다.

  • 이 모드에서 실행하면 도구는 데이터를 삭제하지 않습니다.

  • 도구는 삭제할 콘텐츠에 대한 로그 파일 정보를 기록합니다. 각 잠재적 삭제를 확인하라는 메시지가 표시되지 않습니다.

삭제 모드

매개 변수를 사용하여 /delete 도구를 실행하면 도구가 삭제 모드로 실행됩니다.

  • 이 모드에서 실행하면 지정된 배포 지점에서 찾은 분리된 콘텐츠를 배포 지점의 콘텐츠 라이브러리에서 삭제할 수 있습니다.

  • 버전 2010부터 배포 지점의 WMI 공급자에서 분리된 콘텐츠 레코드를 제거할 수도 있습니다.

  • 각 파일을 삭제하기 전에 도구에서 삭제해야 하는지 확인합니다. 추가 프롬프트를 건너뛰고 분리된 모든 콘텐츠를 삭제하려면 예, 아니요 또는 모두에 대해Y를 선택합니다.

로그 파일

도구가 두 모드에서 실행되면 자동으로 로그 파일이 만들어집니다. 파일 이름을 다음 정보로 지정합니다.

  • 도구가 실행되는 모드
  • 배포 지점의 이름
  • 작업 날짜 및 시간

도구가 완료되면 Windows에서 로그 파일이 자동으로 열립니다.

기본적으로 도구는 도구를 실행하는 사용자 계정의 임시 폴더에 로그 파일을 씁니다. 이 위치는 도구를 실행하는 컴퓨터에 있으며 항상 도구의 대상이 아닙니다. 매개 변수를 /log 사용하여 네트워크 공유를 포함하여 로그 파일을 다른 위치로 리디렉션합니다.

도구 실행

도구를 실행하려면:

  1. 명령 프롬프트를 관리자 권한으로 엽니다. 디렉터리를 ContentLibraryCleanup.exe포함하는 폴더로 변경합니다.

  2. 필요한 명령줄 매개 변수와 사용하려는 선택적 매개 변수를 포함하는 명령줄을 입력합니다.

명령줄 매개 변수

순서에 따라 이러한 명령줄 매개 변수를 사용합니다.

필수 매개 변수

매개 변수 세부 정보
/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로 업데이트합니다. 이 도구는 분리된 파일을 안정적으로 식별할 수 없지만 경고를 표시하고 계속합니다.