PowerShell cmdlet은 Migration Manager 서비스에서 실행되는 파일 공유 마이그레이션 작업을 관리하고 검사 및 마이그레이션 보고서를 다운로드하도록 설계되었습니다.
컴퓨터가 시스템 요구 사항을 충족하는지 확인하려면 이 링크를 참조하세요.
시작하기 전에
마이그레이션 관리자 파일 공유 마이그레이션을 시작하려면 다음을 수행합니다.
- 마이그레이션 관리자 에이전트를 설치한 다음 관리자 계정을 사용하여 대상 테넌트에 연결합니다.
- SharePoint 관리 센터에 관리자로 로그인하고 마이그레이션/파일 공유로 이동합니다.
여기에서 PowerShell zip 파일을 다운로드하고 빌드를 작업 폴더로 압축을 풉
PowerShell cmdlet 사용
관리자 권한으로 PowerShell 시작
다음의 명령을 실행합니다.
> Get-ChildItem -Path "working_folder" -Recurse | Unblock-File
> Set-ExecutionPolicy Unrestricted -Scope CurrentUser -Force
첫 번째 PowerShell 창을 닫고 관리자 권한으로 PowerShell을 시작합니다.
다음의 명령을 실행합니다.
> Import-Module "working_folder\Microsoft.SharePoint.MigrationManager.PowerShell.dll"
참고
Import-Module cmdlet에 절대 파일 경로를 제공합니다.
Migration Manager 서비스에 연결
> Connect-MigrationService
이 cmdlet은 Migration Manager 서비스에 연결합니다. 연결이 설정되면 마이그레이션 작업을 추가하고 마이그레이션을 시작할 수 있습니다.
마이그레이션 작업 추가
> Add-MigrationTask
이 cmdlet을 사용하여 새 마이그레이션 작업을 만듭니다. 작업을 만든 후 마이그레이션 관리자 페이지에 표시됩니다.
다음 매개 변수가 필요합니다.
TaskName: 마이그레이션 작업의 이름을 지정합니다.
SourceUri: 원본 파일 경로를 정의합니다.
TargetSiteUrl: 대상 SharePoint 사이트 URL을 나타냅니다.
TargetListName: 대상 SharePoint 목록의 이름을 지정합니다.
선택적 매개 변수:
ScheduleStartTime: 태스크가 실행하기 시작하는 시간을 지정합니다. 기본적으로 작업은 추가한 직후에 시작됩니다.
AgentGroup: 에이전트 그룹을 할당하여 작업을 실행합니다. 기본적으로 "기본" 그룹이 할당됩니다.
태그: 작업에 태그를 할당합니다. 둘 이상의 태그를 할당하기 위해 세미콜론을 사용하여 태그 값을 구분합니다.
출력 메시지:
작업이 마이그레이션 서비스에 성공적으로 추가되면 "작업 ID taskId를 사용하여 마이그레이션 작업이 만들어집니다."
"마이그레이션 작업을 추가하지 못했습니다. errorMessage" cmdlet이 오류가 발생하면 입니다.
지원되는 매개 변수의 전체 목록을 보려면 다음을 실행합니다.
> Get-Help Add-MigrationTask -Full
마이그레이션 보고서 가져오기
> Get-MigrationReport
이 cmdlet을 사용하여 지정된 매개 변수를 기반으로 완료된 마이그레이션 작업의 보고서를 검색합니다.
OutputPath: 생성된 보고서가 저장되는 디렉터리 경로를 지정합니다.
StartTime: 지정된 날짜 및 시간 이후에 시작된 마이그레이션 작업을 필터링합니다.
EndTime: 지정된 날짜 및 시간 이전에 시작된 마이그레이션 작업을 필터링합니다.
TaskNameContains: 이름이 지정된 키워드(keyword) 포함하는 마이그레이션 작업을 필터링합니다.
태그: 태그가 지정된 매개 변수와 동일한 마이그레이션 작업을 필터링합니다. 여러 태그가 지정된 경우 세미콜론(;))으로 구분되며 태그가 tags 매개 변수의 태그와 동일한 모든 작업이 반환되어야 합니다.
상태: 상태 지정된 매개 변수와 동일한 마이그레이션 작업을 필터링합니다. 지원되는 값은 Completed 및 Failed입니다. 기본적으로 완료 및 실패 작업의 보고서가 다운로드됩니다.
매개 변수를 지정하지 않으면 cmdlet은 기본적으로 모든 완료 및 실패 보고서를 다운로드합니다.
출력 메시지:
보고서 zip 파일이 다운로드된 경우 각 작업에 대해 " taskeId에 대해 보고서 다운로드됨" 그리고 마지막 메시지는 요약 줄 "마이그레이션 보고서 다운로드 완료, 출력 폴더 검사: outputPath"
"마이그레이션 보고서를 다운로드하지 못했습니다. errorMessage" cmdlet이 오류가 발생하면 입니다.
지원되는 매개 변수의 전체 목록을 보려면 다음을 실행합니다.
> Get-Help Get-MigrationReport -Full
검사 보고서 가져오기
> Get-ScanReport
이 cmdlet을 사용하여 지정된 매개 변수를 기반으로 완료된 검사 작업의 보고서를 검색합니다.
OutputPath: 생성된 보고서가 저장되는 디렉터리 경로를 지정합니다.
StartTime: 지정된 날짜 및 시간 이후에 시작된 마이그레이션 작업을 필터링합니다.
EndTime: 지정된 날짜 및 시간 이전에 시작된 마이그레이션 작업을 필터링합니다.
태그: 태그가 지정된 매개 변수와 동일한 마이그레이션 작업을 필터링합니다. 여러 태그가 지정된 경우 세미콜론(;))으로 구분되며 태그가 tags 매개 변수의 태그와 동일한 모든 작업이 반환되어야 합니다.
상태: 상태 지정된 매개 변수와 동일한 마이그레이션 작업을 필터링합니다. 지원되는 값은 준비, 경고 및 오류입니다. 기본적으로 마이그레이션 준비 완료, 경고 및 오류 태스크에 대한 보고서가 다운로드됩니다.
매개 변수를 지정하지 않으면 cmdlet은 기본적으로 마이그레이션 준비 완료, 경고 및 오류 보고서를 모두 다운로드합니다.
출력 메시지:
보고서 zip 파일이 다운로드된 경우 각 작업에 대해 " taskeid에 대해 다운로드한 검사 로그"입니다. 그리고 마지막 메시지는 요약 줄 "검색 로그 다운로드 완료, 출력 폴더 검사: outputPath"입니다.
"검사 로그를 다운로드하지 못했습니다. cmdlet이 오류가 발생하면 error_message"입니다.
지원되는 매개 변수의 전체 목록을 보려면 다음을 실행합니다.
> Get-Help Get-ScanReport -Full