Get-FederationInformation
cmdlet은 온-프레미스 Exchange 및 클라우드 기반 서비스에서 제공됩니다. 일부 매개 변수와 설정은 특정 환경에서만 사용할 수 있습니다.
Get-FederationInformation cmdlet을 사용하여 외부 Exchange 조직에서 페더레이션된 도메인 이름 및 대상 URL을 포함한 페더레이션 정보를 가져옵니다.
아래 구문 섹션에 있는 매개 변수 집합에 대한 자세한 내용은 Exchange cmdlet 구문을 참조하십시오.
Syntax
Get-FederationInformation
-DomainName <SmtpDomain>
[-BypassAdditionalDomainValidation]
[-Force]
[-TrustedHostnames <MultiValuedProperty>]
[<CommonParameters>] Description
Get-FederationInformation cmdlet은 지정된 도메인에서 페더레이션 정보를 검색합니다. cmdlet의 결과를 New-OrganizationRelationship cmdlet에 파이프하여 쿼리 중인 Exchange 조직과 조직 관계를 설정할 수 있습니다.
지정된 도메인에서 페더레이션을 사용할 수 있어야 합니다.
이 cmdlet을 실행하려면 먼저 사용 권한을 할당받아야 합니다. 이 항목에는 해당 cmdlet의 모든 매개 변수가 나열되지만 사용자에게 할당된 사용 권한에 포함되지 않은 일부 매개 변수에는 액세스할 수 없습니다. 조직에서 cmdlet 또는 매개 변수를 실행하는 데 필요한 사용 권한을 확인하려면 Find the permissions required to run any Exchange cmdlet를 참조하세요.
예제
예 1
Get-FederationInformation -DomainName contoso.com이 예에서는 contoso.com 도메인에서 페더레이션 정보를 가져옵니다.
매개 변수
-BypassAdditionalDomainValidation
BypassAdditionalDomainValidation 스위치는 명령이 외부 Exchange 조직에서 도메인의 유효성 검사를 건너뛰는 것을 지정합니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
이 스위치를 사용하여 온-프레미스와 Exchange Online 조직 간의 하이브리드 배포에서 페더레이션 정보를 검색하는 것이 좋습니다. 이 스위치를 사용하여 조직 간 정렬에서 온-프레미스 Exchange 조직에 대한 페더레이션 정보를 검색하지 마세요.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-DomainName
DomainName 매개 변수는 페더레이션 정보를 검색할 도메인 이름을 지정합니다.
| Type: | SmtpDomain |
| Position: | Named |
| Default value: | None |
| Required: | True |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-Force
강제 스위치는 경고 또는 확인 메시지를 숨깁니다. 이 스위치를 사용하면 값을 지정할 필요가 없습니다.
확인 프롬프트는 도메인의 자동 검색 엔드포인트에 있는 호스트 이름이 엔드포인트에서 제공하는 SSL(Secure Sockets Layer) 인증서와 일치하지 않고 호스트 이름이 TrustedHostnames 매개 변수에 지정되지 않은 경우 경고합니다.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
-TrustedHostnames
TrustedHostnames 매개 변수는 페더레이션 끝점의 FQDN(정규화된 도메인 이름)을 지정합니다. 페더레이션 끝점은 페더레이션이 사용하도록 설정된 조직의 사서함 서버에 있는 클라이언트 액세스(프런트 엔드) 서비스입니다. TrustedHostnames 매개 변수를 명시적으로 지정하면 끝점에서 제공하는 인증서가 DomainName 매개 변수에 지정된 도메인 이름과 일치하지 않을 경우 cmdlet이 메시지를 무시할 수 있습니다.
| Type: | MultiValuedProperty |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
| Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection |
입력
Input types
이 cmdlet이 수락하는 입력 형식을 보려면 Cmdlet 입출력 형식을 참조하세요. cmdlet의 입력 형식 필드가 비어 있을 경우 cmdlet은 입력 데이터를 수락하지 않습니다.
출력
Output types
이 cmdlet이 수락하는 반환 형식(출력 형식이라고도 함)을 보려면 Cmdlet 입출력 형식을 참조하세요. 출력 형식 필드가 비어 있는 경우 cmdlet은 데이터를 반환하지 않습니다.