Get-FederationInformation

Módulo:

ExchangePowerShell

Se aplica a:

Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Este cmdlet está disponible en Exchange local y en el servicio basado en la nube. Puede que algunos parámetros y opciones de configuración sean exclusivos de un entorno u otro.

Use el cmdlet Get-FederationInformation para obtener información de federación, incluidos los nombres de dominio federados y las direcciones URL de destino, de una organización externa de Exchange.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Syntax

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

Description

El cmdlet Get-FederationInformation recupera información de federación desde el dominio especificado. Los resultados del cmdlet se pueden canalizar al cmdlet New-OrganizationRelationship para establecer una relación de organización con la organización de Exchange que se está consultando.

El dominio especificado debe tener la federación habilitada.

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Get-FederationInformation -DomainName contoso.com

En este ejemplo se obtiene información de federación del dominio Contoso.com.

Parámetros

-BypassAdditionalDomainValidation

El modificador BypassAdditionalDomainValidation especifica que el comando omite la validación de dominios de la organización externa de Exchange. No es necesario especificar un valor con este modificador.

Se recomienda usar este modificador solo para recuperar información de federación en una implementación híbrida entre organizaciones locales y Exchange Online. No use este modificador para recuperar la información de federación de las organizaciones locales de Exchange en un acuerdo entre organizaciones.

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

El parámetro DomainName especifica el nombre de dominio para el que se recuperará la información de federación.

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

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Un mensaje de confirmación le advierte si el nombre de host en el punto de conexión de detección automática del dominio no coincide con el certificado de capa de sockets seguros (SSL) presentado por el punto de conexión y el nombre de host no se especifica en el parámetro 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

El parámetro TrustedHostnames especifica el nombre de dominio completo (FQDN) de los puntos finales de federación. Los puntos de conexión de federación son los servicios de acceso cliente (front-end) en los servidores de buzones de correo de una organización con la federación habilitada. La especificación explícita del parámetro TrustedHostnames permite al cmdlet omitir la solicitud si el certificado presentado por el punto final no coincide con el nombre de dominio especificado en el parámetro DomainName.

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

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.