Get-MigrationEndpoint
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
Get-MigrationEndpoint cmdlet을 사용하여 단독형 또는 준비된 Exchange 마이그레이션, IMAP 마이그레이션 및 원격 이동을 위해 원본 또는 대상 서버에 대한 마이그레이션 엔드포인트 설정을 검색합니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Get-MigrationEndpoint
-ConnectionSettings <ExchangeConnectionSettings>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[<CommonParameters>] Get-MigrationEndpoint
-Type <MigrationType>
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Partition <MailboxIdParameter>]
[-DiagnosticInfo <String>]
[<CommonParameters>] Get-MigrationEndpoint
[[-Identity] <MigrationEndpointIdParameter>]
[-Diagnostic]
[-DiagnosticArgument <String>]
[-DomainController <Fqdn>]
[-Partition <MailboxIdParameter>]
[-DiagnosticInfo <String>]
[<CommonParameters>] Description
Get-MigrationEndpoint cmdlet은 서로 다른 유형의 마이그레이션에 대한 설정을 검색합니다.
- 포리스트 간 이동: 서로 다른 두 온-프레미스 Exchange 포리스트 간에 사서함을 이동합니다. 포리스트 간 이동에는 RemoteMove 엔드포인트를 사용해야 합니다.
- 원격 이동: 하이브리드 배포에서 원격 이동에는 온보딩 또는 오프보딩 마이그레이션이 포함됩니다. 원격 이동에서는 RemoteMove 끝점을 사용해야 합니다. 온보딩은 온-프레미스 Exchange 조직에서 Exchange Online 사서함을 이동하고 RemoteMove 엔드포인트를 마이그레이션 일괄 처리의 원본 엔드포인트로 사용합니다. 오프보딩은 사서함을 Exchange Online 온-프레미스 Exchange 조직으로 이동하고 RemoteMove 엔드포인트를 마이그레이션 일괄 처리의 대상 엔드포인트로 사용합니다.
- 단독형 Exchange 마이그레이션: 온-프레미스 Exchange 조직의 모든 사서함을 Exchange Online 마이그레이션합니다. Exchange 마이그레이션을 중단하려면 Exchange 엔드포인트를 사용해야 합니다.
- 준비된 Exchange 마이그레이션: 온-프레미스 Exchange 조직에서 Exchange Online 사서함의 하위 집합을 마이그레이션합니다. 준비된 Exchange 마이그레이션을 사용하려면 Exchange 엔드포인트를 사용해야 합니다.
- IMAP 마이그레이션: 온-프레미스 Exchange 조직 또는 기타 전자 메일 시스템에서 Exchange Online 사서함 데이터를 마이그레이션합니다. IMAP 마이그레이션의 경우 사서함 데이터를 마이그레이션하기 전에 먼저 클라우드 기반의 사서함을 만들어야 합니다. IMAP 마이그레이션에서는 IMAP 끝점을 사용해야 합니다.
- 로컬: 단일 온-프레미스 Exchange 포리스트 내에서 서로 다른 서버 또는 데이터베이스 간에 사서함을 이동합니다. 로컬 이동에서는 끝점을 사용할 필요가 없습니다.
다른 이동 및 마이그레이션 시나리오에 대한 자세한 내용은 다음을 참조하십시오.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-MigrationEndpoint -Identity OnboardingME01이 예에서는 마이그레이션 끝점 OnboardingME01에 대한 설정을 검색합니다.
매개 변수
-ConnectionSettings
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
ConnectionSettings 매개 변수는 일치하는 끝점을 찾으려는 원본 또는 대상 서버의 구성 설정을 지정합니다.
| Type: | ExchangeConnectionSettings |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Diagnostic
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
Diagnostic 스위치는 결과에 매우 자세한 정보를 반환할지 여부를 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
일반적으로 이 스위치는 Microsoft 고객 서비스 및 지원 요청 시에만 사용하여 문제를 해결합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DiagnosticArgument
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DiagnosticArgument 매개 변수는 Diagnostic 스위치를 사용하여 반환되는 결과를 수정합니다. 일반적으로 Diagnostic 스위치와 DiagnosticArgument 매개 변수는 Microsoft 고객 서비스 및 지원 요청 시에만 사용하여 문제를 해결합니다.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DiagnosticInfo
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
일반적으로 DiagnosticInfo 매개 변수는 Microsoft 고객 서비스 및 지원 요청 시만 사용하여 문제를 해결합니다. 유효한 값은 다음과 같습니다.
- attachmentid=String
- batch=String
- 확인
- duration=String
- 끝점
- endtime=DateTime
- maxsize=Int32
- organization=String
- partition=String
- reportid=String
- 보고서
- showtimeline
- showtimeslots=String
- starttime=DateTime
- status=String
- 보관소
- type=String
- user=String
- 자세한
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-DomainController
이 매개 변수는 온프레미스 Exchange에서만 사용 가능합니다.
DomainController 매개 변수는 Active Directory에서 데이터를 읽거나 쓰기 위해 이 cmdlet이 사용하는 도메인 컨트롤러를 지정합니다. FQDN(정규화된 도메인 이름)으로 도메인 컨트롤러를 식별합니다. 예: dc01.contoso.com
| Type: | Fqdn |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Identity 매개 변수는 설정을 검색할 마이그레이션 끝점의 이름을 지정합니다.
| Type: | MigrationEndpointIdParameter |
| Position: | 1 |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | True |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
-Partition
이 매개 변수는 클라우드 기반 서비스에서만 사용할 수 있습니다.
이 매개 변수는 Microsoft 내부에서 사용하도록 예약되어 있습니다.
| Type: | MailboxIdParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Online |
-Type
Type 매개 변수는 마이그레이션 유형별로 결과를 필터링합니다. PasswordQuality 매개 변수는 장치 암호에 필요한 최소 암호 품질 등급을 지정합니다. 암호 품질은 암호의 보안 및 복잡성을 나타내는 숫자 등급입니다. 품질 값이 높을수록 암호 보안 수준이 높습니다.
- ExchangeOutlookAnywhere: 단독형 또는 준비된 Exchange 마이그레이션
- ExchangeRemoteMove: 원격 이동 및 마이그레이션
- IMAP: IMAP 마이그레이션
- PublicFolder: 공용 폴더 마이그레이션
| Type: | MigrationType |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.