SharePoint 마이그레이션 평가 도구 개요Overview of the SharePoint Migration Assessment Tool

SharePoint 마이그레이션 평가 도구는 간단한 명령줄 실행 도구입니다.The SharePoint Migration Assessment Tool is a simple command line executable tool. SharePoint 팜의 콘텐츠를 검사하여 Microsoft 365를 사용하여 서버를 SharePoint로 마이그레이션하는 경우의 영향을 파악하는 데 도움이 됩니다.It scans the contents of your SharePoint farm to help identify the impact of migrating your server to SharePoint with Microsoft 365.

이 도구는 환경에 영향을 주지 않고 실행하도록 디자인되었습니다. 따라서 이 도구가 사용자 환경의 검색을 완료하는 데 1-2일이 필요하다는 것을 관찰할 수 있습니다.The tool is designed to run without impacting your environment, so you might observe that the tool requires one to two days to complete a scan of your environment. 이 시간 동안 도구는 콘솔 창의 진행률을 보고합니다.During this time, the tool reports progress in the console window. 검사가 완료되면 출력 파일이 Logs 디렉터리에 있습니다.After the scan finishes, the output files are in the Logs directory. 여기서 마이그레이션에 영향을 줄 수 있는 시나리오에 대한 요약 및 자세한 정보를 찾을 수 있습니다.This is where you can find the summary and more detailed insights into the scenarios that could be impacted by migration.

참고

SharePoint 마이그레이션 도구를 다운로드하려면 SharePoint 마이그레이션 평가 도구 다운로드를 참조하세요.To download the SharePoint Migration Tool, see Download the SharePoint Migration Assessment Tool.

참고

Microsoft 제품 및 서비스의 품질을 개선하기 위해 이 도구는 익명 통계 정보를 Microsoft에 다시 보고합니다.To improve the quality of Microsoft products and services, the tool reports anonymous statistical information back to Microsoft. 선택적으로 검사가 끝날 때 메시지가 표시될 때 조직을 식별할 수 있습니다.Optionally, you can identify your organization when prompted at the end of the scan. 도구가 인터넷에 연결하여 이 정보를 보고할 수 없는 경우 이 도구는 예상대로 계속 작동합니다.If the tool can't connect to the internet to report this information, the tool still functions as otherwise expected.

SharePoint 마이그레이션 평가 도구의 모드Modes in SharePoint Migration Assessment Tool

이 도구는 평가 및 ID 매핑의 두 가지 모드를 제공합니다.The tool offers two modes: Assessment and Identity Mapping.

평가Assessment

기본 모드입니다.This is the default mode. 이 SMAT.exe 실행하면 평가가 실행됩니다.If you run SMAT.exe, the assessment runs. 평가 프로세스는 SharePoint 팜 및 관련 콘텐츠에 대해 검색을 실행합니다.The assessment process runs scans against the SharePoint farm and associated content. SharePoint로 마이그레이션하는 고객의 문제를 유발하는 것으로 알려진 문제를 조사합니다.It looks for issues that have been known to cause issues for customers who are migrating into SharePoint. 사용 가능한 검사에 대한 자세한 내용은 SharePoint 마이그레이션 평가 도구: 보고서 로드맵 검사 로드맵을 참조하세요.For more info about the scans that are available, see SharePoint Migration Assessment Tool: Scan Reports Roadmap.

ID 매핑Identity Mapping

ID 매핑을 사용하여 SharePoint 환경에 액세스할 수 있으며 이러한 ID를 Azure AD 사용자 및 그룹 ID에 매핑하려는 모든 사용자 및 그룹 ID에 대한 보고서를 생성할 수 있습니다.You can use Identity Mapping to generate a report of all the user and group identities that have access to your SharePoint environment and attempts to map those identities to Azure AD user and group identities.

이 프로세스는 마이그레이션에 매우 중요합니다.This process is very important to migration. 마이그레이션 전에 ID가 올바르게 설정되지 않으면 사용자가 사이트에 대한 잘못된 정보뿐만 아니라 콘텐츠에 대한 액세스 권한을 잃을 수 있습니다.If identities aren't correctly set up before migration, users could possibly lose access to content, as well as incorrect information on the site. 예를 들어 만든 사용자 및 수정한 필드에 마이그레이션 후 올바른 ID가 표시되지 않을 수 있습니다.For example, the Created By and Modified fields might not show the correct identity post migration.

ID 매핑에 대한 자세한 내용은 SharePoint 마이그레이션 ID 매핑 도구를 참조하세요.For more info about Identity Mapping, see SharePoint Migration Identity Mapping Tool.

필수 구성 요소Prerequisites

이 도구는 SharePoint 2010 또는 2013 팜 내에서 실행될 수 있으며 다음의 선행해야 합니다.The tool is built to be run from within a SharePoint 2010 or 2013 farm and has these prerequisites:

  • 도구를 실행하려면 모든 파일을 실행하기 전에 압축된 패키지에서 추출해야 합니다.To run the tool, all files must be extracted from any compressed package before execution.

  • 이 도구는 팜 서비스 계정으로 실행해야 합니다.The tool must run as the Farm service account. 계정에 모든 웹 응용 프로그램에 대한 읽기 액세스 권한이 부여된 경우 팜 관리자 계정이 허용됩니다.A farm administrator account is acceptable as long as the account has been given read access to all web applications. 또한 이 계정에는 Operations Administrators 및 User Profile Service 응용 프로그램에 대한 공유 권한 둘 다에 대한 명시적 모든 권한이 > > 필요합니다.The account also needs explicit Full Control permissions on both Operations > Administrators and Sharing > Permissions on the User Profile service application. 환경을 검색하기 전에 계정에 충분한 사용 권한이 있도록 하는 일련의 검사가 있습니다.There are a series of checks to ensure that the account has enough permissions before it scans the environment.

  • 이 도구는 영어 버전의 SharePoint만 지원됩니다.The tool supports only English versions of SharePoint.

구성 파일Config files

SMAT에 대해 두 개의 구성 파일을 수정할 수 있습니다.You can modify two config files for SMAT:

  • SiteSkipList.csv 동일한 디렉터리에 설치됩니다SMAT.exe.SiteSkipList.csv is installed in the same directory as SMAT.exe. 이 CSV에 사이트를 추가하면 보고서 출력에 이러한 사이트가 포함되지 않습니다.Adding sites to this CSV tells SMAT not to include these sites in the report output. 건너뛰기 목록에 사이트를 추가하는 방법에 대한 예제는 다음 SiteSkipList.csv.For examples about how to add sites to the skip list, see SiteSkipList.csv.

  • ScanDef.jsSMAT와 동일한 디렉터리에 설치됩니다.ScanDef.json is installed in the same directory as the SMAT. 이 기능을 ScanDef.jsSMAT에 대한 개별 검색을 설정하거나 사용하지 않도록 설정할 수 있습니다.You can use ScanDef.json to enable or disable individual scans for SMAT. 이 파일에는 SharePoint 2010 및 2013에 대한 평가 구성과 ID 매핑이 포함되어 있습니다.This file contains configurations for assessment on both SharePoint 2010 and 2013, as well as Identity Mapping.

검색을 사용하지 않도록 설정하기 위해 파일에서 ScanDef.js항목을 찾고 Enabled를 false로 설정합니다.To disable a scan, locate the entry in the ScanDef.json file, and set Enabled to false. 이 기능은 비즈니스에서 중요하지 않은 검사가 있는 경우 유용합니다.This is useful if there is a scan that your business doesn't care about. 검색을 중지하면 SMAT의 전체 실행 시간이 줄어듭습니다.Disabling the scan reduces the overall execution time of SMAT.

다음은 경고 검색을 사용하지 않도록 설정하는 예제입니다.The following disables the Alerts scan.

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

SupportedVersion은 특정 검사가 적용되는 SharePoint 버전을 SMAT에 알릴 수 있습니다.The SupportedVersion informs SMAT which versions of SharePoint a specific scan applies to. 예를 들어 SharePoint 2010에는 SharePoint 추가 기능도 제공되지 않았기 때문에 앱 스캐너는 2010을 지원되는 버전으로 나열하지 않습니다.For example, SharePoint 2010 didn't have SharePoint add-ins, so the Apps scanner doesn't list 2010 as a supported version.

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

일부 검사에는 추가 구성 옵션이 있습니다.Some scans have additional configuration options. 이러한 파일은 파일에서 구성할 ScanDef.js있습니다.These are configurable in the ScanDef.json file. 모든 검사에 구성 가능한 속성이 있는 것은 아니며,Not all scans have configurable properties. 그러나 검사에 속성이 있는 경우 파일의 ScanDef.js기본 속성이 구성됩니다.However, if a scan does have a property, there's a default property configured in the ScanDef.json file that can be modified. 예를 들어 SiteTemplateLanguage 검사에는 영어 사이트 [locale 1033]을 제외하는 필터가 있습니다.For example, the SiteTemplateLanguage scan has a filter to exclude English sites [locale 1033]. 팀에서 영어 사이트 마이그레이션이 우려되는 경우 해당 사이트를 포함하도록 필터를 수정할 수 있습니다.If your team has concerns about migrating English sites, you could modify the filter to include those sites:

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

파일의 파일 ScanDef.js손상하는 경우 SMAT.exe 파일에 포함된 기본 구성이 대신 사용됩니다.If you remove or corrupt the ScanDef.json file, a default configuration that is embedded in the SMAT.exe executable file will be used instead. 이 파일은 SMAT.log 파일에 기록됩니다.This is noted in the SMAT.log file. 검색을 사용하지 않도록 설정하거나 속성을 변경하면 검색을 실행할 때 변경이 선택되지 SMAT.exe 자세한 내용은 SMAT.log 파일을 참조합니다.If you disable a scan or change a property and notice that the change isn't picked up when you run SMAT.exe, look in the SMAT.log file for details.

실행Execution

추출된 smat.exe 위치에서 파일을 실행합니다.Run smat.exe from the extracted files location. 사용 가능한 모든 매개 변수를 표시하기 위해 smat.exe /help 다음을 실행합니다.To see all the available parameters, run: smat.exe /help.

SMAT.exe 전달된 매개 변수에 따라 의도를 확인한 다음 요청된 작업을 위해 적절한 응용 프로그램을 로드하는 시작 프로그램입니다.SMAT.exe is a launcher program that determines your intentions based on the parameters passed in, and then loads the appropriate application to do the requested work. 이 표에는 작업을 담당하는 세 개의 실행 파일이 있습니다.Under the covers, there are three executable files that are responsible for doing the work:

  • SMAT2010.exe - SharePoint 2010 환경에 대한 평가를 수행 합니다.SMAT2010.exe - Performs assessment on SharePoint 2010 environments.

  • SMAT2013.exe - SharePoint 2013 환경에 대한 평가를 수행 합니다.SMAT2013.exe - Performs assessment on SharePoint 2013 environments.

  • SMIT.exe - SharePoint 2010 및 2013 환경 모두에 대해 ID 매핑 작업을 수행 합니다.SMIT.exe - Performs identity mapping work for both SharePoint 2010 and 2013 environments.

이 SMAT.exe 실행하여 PowerShell.exe 수행하면 다음 작업이 수행됩니다.When running SMAT.exe to perform an assessment from PowerShell.exe, the following actions occur. 실행 중인 PowerShell SMAT.exe 앱을 실행하여 작업을 실행합니다.The PowerShell window running SMAT.exe launches the app to perform the work. 작업 앱이 로드되면 로더 SMAT.exe 종료되고 운영자에게 컨트롤이 반환됩니다.After the working app is loaded, the SMAT.exe loader program terminates, and returns control to the operator. 작업을 수행하는 도구는 완료될 때까지 자체 창에서 실행됩니다.The tool performing the work runs in its own window until it completes.

로그 파일Log files

출력 디렉터리에 최대 3개의 로그 파일이 표시될 수 있습니다.You might see up to three log files in the output directory:

  • SMAT.log - 이 파일에는 도구 실행의 모든 로깅이 포함되어 있습니다.SMAT.log - This file contains all the logging from the tool execution. 여기에는 정보, 경고 및 오류의 세 가지 로깅 수준이 포함되어 있습니다.This contains three levels of logging: Information, Warning, and Errors. 정보는 진행률 및 문제 해결을 추적하는 데 도움이 됩니다.Information helps track down progress and troubleshooting issues. 일반적으로 경고는 예상 오류 조건입니다.Typically, Warnings are expected error conditions. 오류는 도구에서 앞으로 이동하는 데 차단할지 여부를 결정할 수 없는 예기치 않은 상황입니다.Errors are unexpected conditions that our tooling was unable to determine whether they will be a blocker to moving forward. 이러한 경우를 검토해야 합니다.These need to be reviewed.

  • SMAT_Errors.log - Error 이벤트만 포함SMAT_Errors.log - This contains only the Error events. 도구가 완료된 후 이 파일이 누락되면 오류가 없음을 나타냅니다.If this file is missing after the tooling completes, it indicates that no errors were found.

  • SMATTelemetry.log - 여기에는 원격 분석 업로드 도구에 대한 로깅이 포함되어 있습니다.SMATTelemetry.log - This contains logging for the telemetry upload tooling. 여기서는 모든 문제가 보고서 생성에 영향을 미치지 않습니다.Any issues in here don't impact generating your reports.

평가 자동화Automating assessment

평가 프로세스를 예약해야 하는 경우 특정 .exe 파일을 실행하여 예약할 수 있습니다.If you need to schedule the assessment process, you can do so by running the specific .exe file. 예를 들어 평가를 위해 SharePoint 2010 팜에서 예약된 작업을 설정하려는 경우 예약된 작업을 해당 작업을 SMAT2010.exe.For example, if you want to set up a scheduled task on a SharePoint 2010 farm for assessment, you would point the scheduled task to SMAT2010.exe. SharePoint 2013에서 평가를 실행한 PowerShell 스크립트를 작성하려는 경우 스크립트에서 해당 스크립트를 SMAT2013.exe.If you want to write a PowerShell script that ran assessment on SharePoint 2013, you would point the script to SMAT2013.exe.

모든 스크립팅 시나리오에서는 스위치를 사용하여 .exe 파일을 Quiet -q 모드로 실행해야 합니다.Any scripting scenario must use the -q switch to run the .exe file in quiet mode. 이 모드는 콘솔에 어떤 출력도 제공하지 못하며, 연산자에게 입력을 요청하는 모든 것을 방지합니다.This mode doesn't provide any output to the console and avoids anything that would prompt the operator for input.

현재 ID 매핑(SMIT.exe)에 대한 실행 파일은 스크립팅을 지원하지 않습니다.At this time, the executable file for Identity Mapping (SMIT.exe) doesn't support scripting. 이 프로세스에서는 최소한 Azure에 대한 자격 증명을 묻는 메시지가 표시될 수 있으며 Active Directory에 연결할 자격 증명을 묻는 메시지가 표시될 수 있습니다.This process prompts for credentials to Azure at a minimum and might prompt for credentials to connect to Active Directory. 이 실행 파일에 대해 스크립트를 작성하려고 시도하면 프로그램이 자격 증명을 입력하라는 메시지가 표시될 때 실행 파일이 중단되고 완료되지 않습니다.If you attempt to script against this executable file, it hangs and doesn't complete when the program prompts for credentials.

추가 정보More info

SharePoint 마이그레이션 도구를 다운로드하고 평가 보고서에서 식별된 문제를 해결하는 방법에 대한 자세한 내용은 다음을 참조하세요.To download the SharePoint Migration Tool, and for more info about how to address issues identified in the assessment reports, see