Get-FederationInformation

Модуль:
Exchange PowerShell

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут быть эксклюзивными для той или иной среды.

Используйте командлет Get-FederationInformation, чтобы получить сведения о федерации от внешней организации Exchange.

Совет

Сведения об изменениях, внесенных в командлет Get-FederationInformation для повышения безопасности и конфиденциальности, см. в разделе "Важное обновление командлета Get-FederationInformation" в Exchange Online.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Default (По умолчанию) 

Get-FederationInformation
    -DomainName <SmtpDomain>
    [-BypassAdditionalDomainValidation]
    [-Force]
    [-TrustedHostnames <MultiValuedProperty>]
    [<CommonParameters>]

Описание

Командлет Get-FederationInformation получает сведения федерации из указанного домена, в котором федерация должна быть включена.

Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-FederationInformation -DomainName contoso.com

В этом примере выполняется получение сведений о федерации для домена contoso.com.

Параметры

-BypassAdditionalDomainValidation

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды почтовые ящики

Ключ BypassAdditionalDomainValidation указывает, что команда пропускает проверку доменов из внешней организации Exchange. С этим параметром не нужно указывать значение.

Мы рекомендуем использовать этот переключатель только для получения сведений федерации в гибридном развертывании между локальной средой и организациями Exchange Online. Не используйте этот переключатель для получения сведений федерации для локальных организаций Exchange в межорганизационном соглашении.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-DomainName

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды почтовые ящики

Параметр DomainName указывает доменное имя, для которого выполняется получение сведений о федерации.

Свойства параметров

Тип:SmtpDomain
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:True
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Force

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды почтовые ящики

Переключатель "Принудительно" скрывает сообщения с предупреждениями или подтверждениями. Указывать значение для этого параметра необязательно.

Запрос на подтверждение предупреждает вас, если имя узла в конечной точке автообнаружения домена не соответствует сертификату TLS, представленному конечной точкой, и имя хоста не указано в параметре TrustedHostnames.

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-TrustedHostnames

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE, Exchange Online, встроенная надстройка безопасности для локальной среды почтовые ящики

Параметр TrustedHostnames задает полное доменное имя конечных точек федерации. Конечные точки федерации — это службы клиентского доступа на серверах почтовых ящиков в организации с включенной федерацией. Явное указание параметра TrustedHostnames позволяет командлету пропускать предупреждение, если представленный конечной точкой сертификат не совпадает с доменным именем, указанным в параметре DomainName.

Свойства параметров

Тип:MultiValuedProperty
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

Входные данные

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

Выходные данные

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.