Get-FederationInformation

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 la cmdlet Get-FederationInformation pour obtenir des informations de Fédération, y compris des noms de domaines 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 (https://docs.microsoft.com/powershell/exchange/exchange-cmdlet-syntax).

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 transmis à la cmdlet New-OrganizationRelationship pour établir une relation organisationnelle 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.

Examples

Exemple 1

Get-FederationInformation -DomainName contoso.com

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

Parameters

-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 uniquement ce commutateur pour récupérer des 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 une organisation interorganisationnelle.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Force

Le commutateur Force spécifie s’il faut supprimer les messages d’avertissement ou de confirmation. Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Une invite de confirmation vous signale 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 que le nom d’hôte n’est pas spécifié dans le paramètre TrustedHostnames.

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-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
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

Inputs

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.

Outputs

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.