Get-FederationInformation

Référence

Module:: ExchangePowerShell

S’applique à:: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

Cette cmdlet est disponible dans Exchange sur site et dans le service cloud. Certains paramètres peuvent être propres à un environnement ou à un autre.

Utilisez l’applet de commande Get-FederationInformation pour obtenir des informations de fédération, notamment des noms de domaine fédérés et des URL cibles, à partir d’une organisation Exchange externe.

Pour plus d’informations sur les jeux de paramètres dans la section Syntaxe ci-après, voir Syntaxe da la cmdlet Exchange.

Syntax

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

Description

La cmdlet Get-FederationInformation récupère les informations de fédération à partir du domaine spécifié. Les résultats de l’applet de commande peuvent être redirigés vers l’applet de commande New-OrganizationRelationship pour établir une relation d’organisation avec l’organisation Exchange interrogée.

La fédération du domaine spécifié doit être activée.

Des autorisations doivent vous être attribuées avant de pouvoir exécuter cette cmdlet. Bien que cette rubrique répertorie tous les paramètres de cette cmdlet, il est possible que vous n’ayez pas accès à certains paramètres s’ils ne sont pas inclus dans les autorisations qui vous ont été attribuées. Pour rechercher les autorisations requises pour exécuter une cmdlet ou un paramètre dans votre organisation, voir Find the permissions required to run any Exchange cmdlet.

Exemples

Exemple 1

Get-FederationInformation -DomainName contoso.com

Cet exemple obtient des informations de fédération à partir du domaine contoso.com.

Paramètres

-BypassAdditionalDomainValidation

Le commutateur BypassAdditionalDomainValidation spécifie que la commande ignore la validation des domaines de l’organisation Exchange externe. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Nous vous recommandons d’utiliser ce commutateur uniquement pour récupérer les informations de fédération dans un déploiement hybride entre des organisations locales et Exchange Online. N’utilisez pas ce commutateur pour récupérer des informations de fédération pour les organisations Exchange locales dans un arrangement inter-organisations.

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

Le paramètre DomainName spécifie le nom de domaine pour lequel les informations de fédération doivent être récupérées.

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

Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Une invite de confirmation vous avertit si le nom d’hôte dans le point de terminaison de découverte automatique du domaine ne correspond pas au certificat SSL (Secure Sockets Layer) présenté par le point de terminaison et si le nom d’hôte n’est pas spécifié dans le paramètre 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

Le paramètre TrustedHostnames spécifie le nom de domaine complet des points de terminaison de fédération. Les points de terminaison de fédération sont les services d’accès au client (frontal) sur des serveurs de boîtes aux lettres dans une organisation dans laquelle la fédération est activée. Spécifier explicitement le paramètre TrustedHostnames permet à la cmdlet d'ignorer l'invite si le certificat présenté par le point de terminaison ne correspond pas au nom de domaine spécifié dans le paramètre 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

Entrées

Input types

Pour visualiser les types d'entrées acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type d'entrée pour une cmdlet est vide, la cmdlet n'accepte pas les données d'entrée.

Sorties

Output types

Pour visualiser les types de retours, également appelés types de sorties, acceptés par cette cmdlet, consultez la rubrique Types d'entrée et de sortie de la cmdlet d'Exchange Management Shell. Si le champ Type de sortie est vide, la cmdlet ne renvoie pas de données.