Get-FederationInformation

 

S’applique à :Exchange Online, Exchange Server 2016

Dernière rubrique modifiée :2016-03-31

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

La cmdlet Get-FederationInformation permet d'obtenir des informations de fédération, et notamment les noms de domaine fédéré et les 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 SyntaxeSyntaxe de cmdlet Exchange.

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

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

Get-FederationInformation -DomainName contoso.com

La cmdlet Get-FederationInformation récupère les informations de fédération à partir du domaine spécifié. Les résultats de cette cmdlet peuvent être transmis à la cmdlet 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 tous les paramètres de cette cmdlet soient répertoriés dans cette rubrique, 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 voir les autorisations qui vous sont nécessaires, voir Entrée « Approbations de fédération » dans la rubrique Infrastructure Exchange et des autorisations de PowerShell.

 

Paramètre Obligatoire Type Description

DomainName

Obligatoire

Microsoft.Exchange.Data.SmtpDomain

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

BypassAdditionalDomainValidation

Facultatif

System.Management.Automation.SwitchParameter

Le commutateur BypassAdditionalDomainValidation indique que la commande ignore la validation de domaines à partir 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 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 des organisations Exchange locales dans une disposition inter-organisations.

Force

Facultatif

System.Management.Automation.SwitchParameter

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.

Un message de confirmation vous avertit si le nom d’hôte dans le point de terminaison de la découverte automatique du domaine ne correspond pas au certificat SSL présenté par le point de terminaison, et si le nom d’hôte n’est pas indiqué dans le paramètre TrustedHostnames.

TrustedHostnames

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

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.

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.

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.

 
Afficher: