SharePoint 마이그레이션 평가 도구 개요

아티클
04/13/2024

SharePoint 마이그레이션 평가 도구는 간단한 명령줄 실행 도구입니다. SharePoint 팜의 내용을 검사하여 Microsoft 365를 사용하여 서버를 SharePoint로 마이그레이션할 때 미치는 영향을 식별합니다.

이 도구는 환경에 영향을 주지 않고 실행되도록 설계되었기 때문에 환경 검사를 완료하는 데 1~2일이 필요한 것을 확인할 수 있습니다. 이 시간 동안 도구는 콘솔 창에서 진행률을 보고합니다. 검사가 완료되면 출력 파일이 로그 디렉터리에 있습니다. 여기서는 마이그레이션의 영향을 받을 수 있는 시나리오에 대한 요약 및 자세한 인사이트를 찾을 수 있습니다.

참고

SharePoint 마이그레이션 평가 도구를 다운로드하려면 SharePoint 마이그레이션 평가 도구 다운로드를 참조하세요.

참고

Microsoft 제품 및 서비스의 품질을 개선하기 위해 이 도구는 익명 통계 정보를 Microsoft에 다시 보고합니다. 필요에 따라 검사 끝에 메시지가 표시되면 organization 식별할 수 있습니다. 도구가 인터넷에 연결하여 이 정보를 보고할 수 없는 경우 도구는 여전히 예상대로 작동합니다.

필수 구성 요소

이 도구는 SharePoint 2010, 2013 또는 2016 팜 내에서 실행되도록 빌드되었으며 다음과 같은 필수 구성 요소가 있습니다.

도구를 실행하려면 실행하기 전에 압축된 패키지에서 모든 파일을 추출해야 합니다.
도구는 팜 서비스 계정으로 실행되어야 합니다. 팜 관리자 계정은 계정에 모든 웹 애플리케이션에 대한 읽기 권한이 부여된 한 허용됩니다. 또한 이 계정에는 사용자 프로필 서비스 애플리케이션에 대한 운영>관리자 및 공유> 권한 모두에 대한 명시적 모든 권한권한이 필요합니다. 계정을 검사하기 전에 계정에 충분한 권한이 있는지 확인하기 위한 일련의 검사가 있습니다.
이 도구는 영어 버전의 SharePoint만 지원합니다.

구성 파일

SMAT에 대해 다음 두 개의 구성 파일을 수정할 수 있습니다.

SiteSkipList.csv SMAT.exe 동일한 디렉터리에 설치됩니다. 이 CSV에 사이트를 추가하면 SMAT에 보고서 출력에 이러한 사이트를 포함하지 않도록 지시합니다. 건너뛰기 목록에 사이트를 추가하는 방법에 대한 예제는 SiteSkipList.csv 참조하세요.
ScanDef.json SMAT와 동일한 디렉터리에 설치됩니다. ScanDef.json 사용하여 SMAT에 대한 개별 검사를 사용하거나 사용하지 않도록 설정할 수 있습니다. 이 파일에는 SharePoint 2010 및 2013 모두에 대한 평가를 위한 구성이 포함되어 있습니다.

검사를 사용하지 않도록 설정하려면 ScanDef.json 파일에서 항목을 찾고 사용을false로 설정합니다. 이는 비즈니스가 신경 쓰지 않는 검사가 있는 경우에 유용합니다. 검사를 사용하지 않도록 설정하면 SMAT의 전체 실행 시간이 줄어듭니다.

다음은 경고 검사를 사용하지 않도록 설정합니다.

{ "Name": "Alerts", "Type": "AlertsScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": false }

SupportedVersion은 특정 검사가 적용되는 SharePoint 버전을 SMAT에 알릴 수 있습니다. 예를 들어 SharePoint 2010에는 SharePoint 추가 기능이 없으므로 앱 스캐너는 2010을 지원되는 버전으로 나열하지 않습니다.

{ "Name": "Apps", "Type": "AppsScanner", "SupportedVersions": [ "2013", "2016" ], "ReportCategoryType": "SPSite", "Enabled": true }

일부 검사에는 추가 구성 옵션이 있습니다. ScanDef.json 파일에서 구성할 수 있습니다. 모든 검사에 구성 가능한 속성이 있는 것은 아닙니다. 그러나 검사에 속성이 있는 경우 수정할 수 있는 기본 속성이 ScanDef.json 파일에 구성됩니다. 예를 들어 SiteTemplateLanguage 검사에는 영어 사이트 [로캘 1033]을 제외하는 필터가 있습니다. 팀에서 영어 사이트 마이그레이션에 대한 우려가 있는 경우 해당 사이트를 포함하도록 필터를 수정할 수 있습니다.

{ "Name": "SiteTemplateLanguage", "Type": "SiteTemplateLanguageScanner", "SupportedVersions": [ "2010", "2013", "2016" ], "Property": { "ExcludedLanguages": "" }, "ReportCategoryType": "SPSite", "Enabled": true }

ScanDef.json 파일을 제거하거나 손상하면 SMAT.exe 실행 파일에 포함된 기본 구성이 대신 사용됩니다. SMAT.log 파일에 설명되어 있습니다. 검색을 사용하지 않도록 설정하거나 속성을 변경하고 SMAT.exe 실행할 때 변경 내용이 선택되지 않는 경우 SMAT.log 파일에서 자세한 내용을 확인하세요.

실행

추출된 파일 위치에서 smat.exe 실행합니다. 사용 가능한 모든 매개 변수를 보려면 를 실행 smat.exe /help합니다.

SMAT.exe 전달된 매개 변수를 기반으로 의도를 확인한 다음 요청된 작업을 수행하는 적절한 애플리케이션을 로드하는 시작 관리자 프로그램입니다. 아래에는 작업을 수행하는 세 개의 실행 파일이 있습니다.

SMAT2010.exe - SharePoint 2010 환경에서 평가를 수행합니다.
SMAT2013.exe - SharePoint 2013 환경에서 평가를 수행합니다.
SMIT.exe - SharePoint 2010 및 2013 환경 모두에 대한 ID 매핑 작업을 수행합니다.

참고

SMIT는 Azure AD Graph 서비스의 사용 중단으로 인해 2023년 6월 30일 이후에 작동을 중지합니다. 최신 공지 사항에 대한 자세한 내용은 중요: Azure AD 그래프 사용 중지 및 Powershell 모듈 사용 중단을 참조하세요. PowerShell.exe 평가를 수행하기 위해 SMAT.exe 실행하는 경우 다음 작업이 수행됩니다. SMAT.exe 실행되는 PowerShell 창에서 앱을 실행하여 작업을 수행합니다. 작업 앱이 로드되면 SMAT.exe 로더 프로그램이 종료되고 컨트롤이 연산자에게 반환됩니다. 작업을 수행하는 도구는 완료될 때까지 자체 창에서 실행됩니다.

로그 파일

출력 디렉터리에 최대 3개의 로그 파일이 표시될 수 있습니다.

SMAT.log - 이 파일에는 도구 실행의 모든 로깅이 포함됩니다. 여기에는 정보, 경고 및 오류의 세 가지 수준의 로깅이 포함 됩니다. 정보는 진행 상황을 추적하고 문제를 해결하는 데 도움이 됩니다. 일반적으로 경고는 예상되는 오류 조건입니다. 오류는 도구가 앞으로 나아가는 데 방해가 될지 여부를 확인할 수 없는 예기치 않은 조건입니다. 이러한 항목을 검토해야 합니다.
SMAT_Errors.log - 오류 이벤트만 포함됩니다. 도구가 완료된 후 이 파일이 누락된 경우 오류가 없음을 나타냅니다.
SMATTelemetry.log - 원격 분석 업로드 도구에 대한 로깅이 포함됩니다. 여기에 있는 모든 문제는 보고서 생성에 영향을 주지 않습니다.

평가 자동화

평가 프로세스를 예약해야 하는 경우 특정 .exe 파일을 실행하여 수행할 수 있습니다. 예를 들어 평가를 위해 SharePoint 2010 팜에서 예약된 작업을 설정하려는 경우 예약된 작업이 SMAT2010.exe. SharePoint 2013에서 평가를 실행한 PowerShell 스크립트를 작성하려면 스크립트를 SMAT2013.exe.

모든 스크립팅 시나리오에서는 스위치를 -q 사용하여 자동 모드에서 .exe 파일을 실행해야 합니다. 이 모드는 콘솔에 출력을 제공하지 않으며 운영자에게 입력하라는 메시지를 표시하지 않습니다.

추가 정보

SharePoint 마이그레이션 도구를 다운로드하고 평가 보고서에서 식별된 문제를 해결하는 방법에 대한 자세한 내용은 를 참조하세요.