New-OrganizationRelationship

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 New-OrganizationRelationship pour créer des relations organisationnelles. Les relations organisationnelles définissent les paramètres qui sont utilisés avec les organisations Exchange externes pour accéder aux informations de disponibilité du calendrier ou pour déplacer des boîtes aux lettres entre des serveurs Exchange locaux et Exchange Online dans le cadre de déploiements hybrides.

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

New-OrganizationRelationship
   [-Name] <String>
   -DomainNames <MultiValuedProperty>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-OrganizationContact <SmtpAddress>]
   [-PhotosEnabled <Boolean>]
   [-TargetApplicationUri <Uri>]
   [-TargetAutodiscoverEpr <Uri>]
   [-TargetOwaURL <Uri>]
   [-TargetSharingEpr <Uri>]
   [-WhatIf]
   [<CommonParameters>]

Description

Avant de créer une relation d'organisation, vous devez tout d'abord créer une approbation de fédération. Pour plus d’informations, consultez la rubrique Federation.

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 | New-OrganizationRelationship -Name "Contoso" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel LimitedDetails

Cet exemple crée une relation d'organisation avec Contoso. Le nom de domaine pour se connecter est contoso.com. Les paramètres suivants sont utilisés :

L’accès disponible/occupé est activé.

L'organisation qui émet la demande reçoit les informations de temps, d'objet et d'emplacement de la part de l'organisation cible.

Cet exemple tente de découvrir automatiquement des informations de configuration de l’organisation externe en utilisant les noms de domaine fournis dans la commande Get-FederationInformation. Si vous utilisez cette méthode pour créer votre relation d’organisation, vous devez tout d’abord vous assurer que vous avez créé un identificateur d’organisation en utilisant la cmdlet Set-FederationOrganizationIdentifier.

Exemple 2

New-OrganizationRelationship -Name "Fourth Coffee" -DomainNames "mail.fourthcoffee.com" -FreeBusyAccessEnabled $true -FreeBusyAccessLevel AvailabilityOnly -TargetAutodiscoverEpr "https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity" -TargetApplicationUri "mail.fourthcoffee.com"

Cet exemple crée la relation d'organisation avec Fourth Coffee en utilisant les paramètres suivants. Dans cet exemple, les paramètres de connexion avec l'organisation externe sont fournis.

Le domaine de connexion est mail.fourthcoffee.com.

L'URL de l'application des services web Exchange est mail.fourthcoffee.com.

L'URL de découverte automatique est https://mail.fourthcoffee.com/autodiscover/autodiscover.svc/wssecurity.

Les informations de disponibilité sont activées.

L'organisation qui émet la demande reçoit uniquement les informations de disponibilité avec les heures de disponibilité.

Parameters

-ArchiveAccessEnabled

Le paramètre ArchiveAccessEnabled spécifie si la relation d’organisation a été configurée pour permettre un accès à l’archive à distance. Les valeurs valides sont les suivantes :

  • $true : l’organisation externe fournit un accès à distance aux Archives des boîtes aux lettres.

  • $false : l’organisation externe n’offre pas d’accès à distance aux Archives des boîtes aux lettres. Il s’agit de la valeur par défaut.

Type:Boolean
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
-Confirm

Le commutateur Confirme spécifie s’il faut afficher ou masquer l’invite de confirmation. L’incidence de ce commutateur sur la cmdlet varie selon que la cmdlet requiert une confirmation avant de poursuivre.

  • Les cmdlets destructives (par exemple, les cmdlets Remove-*) ont une pause intégrée qui vous oblige à confirmer la commande avant de poursuivre. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.

  • La plupart des autres cmdlets (par exemple, les cmdlets New-* et Set-*) n’ont pas de pause intégrée. Pour ces cmdlets, la spécification du commutateur Confirm sans valeur introduit une pause qui vous oblige à confirmer la commande avant de poursuivre.

Type:SwitchParameter
Aliases:cf
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
-DeliveryReportEnabled

Le paramètre DeliveryReportEnabled indique si les données des rapports de remise doivent être partagés dans la relation d’organisation. Les valeurs valides sont les suivantes :

  • $true : les rapports de remise doivent être partagés sur la relation organisationnelle. Cette valeur signifie que l’organisation a accepté de partager tous les rapports de remise avec l’organisation externe, et que la relation organisationnelle doit être utilisée pour récupérer les informations de rapport de remise à partir de l’organisation externe.

  • $false : les rapports de remise ne doivent pas être partagés sur la relation organisationnelle. Il s'agit de la valeur par défaut.

Pour que le suivi des messages fonctionne dans un scénario Exchange intersites, ce paramètre doit être défini sur $true des deux côtés de la relation organisationnelle. Si la valeur de ce paramètre est définie sur $false sur l’un des côtés de la relation d’organisation ou sur les deux, le suivi des messages entre les organisations ne fonctionnera ni dans un sens, ni dans l’autre.

Type:Boolean
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
-DomainController

Ce paramètre est disponible uniquement dans Exchange sur site.

Le paramètre DomainController spécifie le contrôleur de domaine qui est utilisé par cette cmdlet pour lire ou écrire les données dans Active Directory. Vous identifiez le contrôleur de domaine par son nom de domaine complet (FQDN). Par exemple, dc01.contoso.com.

Type:Fqdn
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
-DomainNames

Le paramètre DomainNames spécifie les domaines SMTP de l’organisation externe. Vous pouvez spécifier plusieurs domaines séparés par des virgules (par exemple, « contoso. com","northamerica. contoso. com »), limité à 238 domaines dans une demande.

Type:MultiValuedProperty
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-Enabled

Le paramètre Enabled spécifie s’il faut activer la relation d’organisation. Les valeurs valides sont les suivantes :

  • $true : la relation d’organisation est activée. Il s’agit de la valeur par défaut.

  • $false : la relation organisationnelle est désactivée. Cette valeur arrête complètement le partage pour la relation d’organisation.

Type:Boolean
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
-FreeBusyAccessEnabled

Le paramètre FreeBusyAccessEnabled spécifie si la relation d’organisation doit être utilisée pour récupérer des informations de disponibilité dans l’organisation externe. Les valeurs valides sont les suivantes :

  • $true : les informations de disponibilité sont récupérées à partir de l’organisation externe.

  • $false : les informations de disponibilité ne sont pas récupérées de l’organisation externe. Il s’agit de la valeur par défaut.

Vous contrôler le niveau d’accès de disponibilité et la portée à l’aide des paramètres FreeBusyAccessLevel et FreeBusyAccessScope.

Type:Boolean
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
-FreeBusyAccessLevel

Le paramètre FreeBusyAccessLevel spécifie la quantité maximale de détails renvoyés à l’organisation requérante. Les valeurs valides sont les suivantes :

  • None : pas d’accès libre/occupé.

  • AvailabilityOnly : accès libre/occupé avec heure uniquement.

  • LimitedDetails : accès aux informations de disponibilité avec l’heure, l’objet et l’emplacement.

Ce paramètre n’est significatif que si la valeur du paramètre FreeBusyAccessEnabled est $true.

Type:FreeBusyAccessLevel
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
-FreeBusyAccessScope

Le paramètre FreeBusyAccessScope spécifie un groupe de sécurité à extension de messagerie dans l’organisation interne qui contient des utilisateurs dont les informations de disponibilité sont accessibles par une organisation externe. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe. Par exemple :

  • Nom

  • Nom unique (DN)

  • Nom unique

  • GUID

Ce paramètre n’est significatif que si la valeur du paramètre FreeBusyAccessEnabled est $true.

Type:GroupIdParameter
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
-MailTipsAccessEnabled

Le paramètre MailTipsAccessEnabled spécifie si des infos-courrier des utilisateurs de cette organisation sont renvoyées dans cette relation d’organisation. Les valeurs valides sont les suivantes :

  • $true : les infos-courrier pour les utilisateurs de cette organisation sont renvoyées via la relation organisationnelle.

  • $false : les infos-courrier pour les utilisateurs de cette organisation ne sont pas renvoyées par la relation organisationnelle. Il s’agit de la valeur par défaut.

Vous contrôlez le niveau d’accès aux infos-courrier à l’aide du paramètre MailTipsAccessLevel.

Type:Boolean
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
-MailTipsAccessLevel

Le paramètre MailTipsAccessLevel spécifie le niveau des données Infos-courrier partagées en externe dans cette relation d’organisation. Ce paramètre peut prendre les valeurs suivantes :

  • All : toutes les infos-courrier sont renvoyées, mais les destinataires de l’organisation distante sont considérés comme externes. Pour l’info-courrier de réponse automatique, le message de réponse automatique externe est renvoyé.

  • Limited : uniquement les infos-courrier qui peuvent empêcher une notification d’échec de remise ou une réponse automatique sont renvoyées. Les infos-courrier personnalisées, l’info-courrier Large public et les infos-courrier des destinataires modérés ne seront pas renvoyées.

  • None : aucune infos-courrier n’est renvoyée à l’organisation distante. Il s’agit de la valeur par défaut.

Ce paramètre n’est significatif que si la valeur du paramètre MailTipsAccessEnabled est $true.

Type:MailTipsAccessLevel
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
-MailTipsAccessScope

Le paramètre MailTipsAccessScope spécifie un groupe de sécurité à extension de messagerie dans l’organisation interne qui contient des utilisateurs dont les informations de disponibilité sont accessibles par une organisation externe. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe. Par exemple :

  • Nom

  • Nom unique (DN)

  • Nom unique

  • GUID

La valeur par défaut est vide ($null), ce qui signifie qu’aucun groupe n’est indiqué.

Si vous utilisez ce paramètre, les infos-courrier propres aux destinataires sont renvoyées uniquement pour les destinataires membres du groupe spécifié. Les infos-courrier propres aux destinataires sont les suivantes :

  • Réponse automatique

  • Boîte aux lettres saturée

  • Personnalisé

Si vous n’utilisez pas ce paramètre, les infos-courrier propres aux destinataires sont renvoyées pour tous les destinataires au sein de l’organisation.

Cette restriction s’applique uniquement aux boîtes aux lettres, aux utilisateurs de messagerie et aux contacts de messagerie. EIle ne concerne pas les groupes de distribution.

Type:GroupIdParameter
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
-MailboxMoveEnabled

Le paramètre MailboxMoveEnabled spécifie si la relation d'organisation permet de déplacer des boîtes aux lettres vers ou depuis l'organisation externe. Les valeurs valides sont les suivantes :

  • $true : les déplacements de boîtes aux lettres vers ou à partir de l’organisation externe sont autorisés.

  • $false : les déplacements de boîtes aux lettres vers ou à partir de l’organisation externe ne sont pas autorisés. Il s’agit de la valeur par défaut.

Type:Boolean
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
-Name

Le paramètre Name spécifie le nom unique de la relation d’organisation. La longueur maximale est de 64 caractères.

Type:String
Position:1
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
-OrganizationContact

Le paramètre OrganizationContact spécifie l’adresse de messagerie électronique qui peut être utilisée pour contacter l’organisation externe (par exemple, administrator@fourthcoffee.com).

Type:SmtpAddress
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
-PhotosEnabled

Le paramètre PhotosEnabled spécifie si les photos des utilisateurs de l’organisation interne sont renvoyées dans la relation d’organisation. Les valeurs valides sont les suivantes :

  • $true : les photos des utilisateurs de cette organisation sont renvoyées via la relation organisationnelle.

  • $false : les photos des utilisateurs de cette organisation ne sont pas renvoyées par la relation organisationnelle. Il s’agit de la valeur par défaut.

Type:Boolean
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-TargetApplicationUri

Le paramètre TargetApplicationUri spécifie l’URI cible de l’organisation externe. Le paramètre TargetApplicationUri est spécifié par Exchange lors de la demande d’un jeton délégué pour l’organisation externe afin de récupérer les informations de disponibilité, par exemple mail.contoso.com.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-TargetAutodiscoverEpr

Le paramètre TargetAutodiscoverEpr spécifie l’URL de découverte automatique des services Web Exchange pour l’organisation externe, par exemple, https://contoso.com/autodiscover/autodiscover.svc/wssecurity . Exchange utilise le service de découverte automatique pour détecter automatiquement le point de terminaison Exchange Server correct à utiliser pour les demandes externes.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-TargetOwaURL

Le paramètre TargetOwaURL spécifie l’URL Outlook sur le Web (anciennement Outlook Web App) de l’organisation externe définie dans la relation organisationnelle. Il est utilisé pour la redirection d’Outlook sur le Web dans un scénario Exchange entre différents locaux. La configuration de cet attribut permet aux utilisateurs de l’organisation d’utiliser leur URL Outlook sur le Web actuelle pour accéder à Outlook sur le Web dans l’organisation externe.

Type:Uri
Position:Named
Default value:None
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online
-TargetSharingEpr

Le paramètre TargetSharingEpr spécifie l’URL des services Web Exchange cibles pour l’organisation externe.

Si vous utilisez ce paramètre, cette URL est toujours utilisée pour atteindre le serveur Exchange externe. L’URL spécifiée par le paramètre TargetAutodiscoverEpr n’est pas utilisée pour localiser le serveur Exchange externe.

Type:Uri
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
-WhatIf

Le commutateur WhatIf simule les actions de la commande. Vous pouvez utiliser ce commutateur pour afficher les modifications qui se produiraient sans réellement appliquer ces modifications. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.

Type:SwitchParameter
Aliases:wi
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.