New-OrganizationRelationship

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 la cmdlet New-OrganizationRelationship pour créer des relations organisationnelles. Les relations d’organisation définissent les paramètres 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 des 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.

Syntax

New-OrganizationRelationship
   [-Name] <String>
   -DomainNames <MultiValuedProperty>
   [-ArchiveAccessEnabled <Boolean>]
   [-Confirm]
   [-DeliveryReportEnabled <Boolean>]
   [-DomainController <Fqdn>]
   [-Enabled <Boolean>]
   [-FreeBusyAccessEnabled <Boolean>]
   [-FreeBusyAccessLevel <FreeBusyAccessLevel>]
   [-FreeBusyAccessScope <GroupIdParameter>]
   [-MailboxMoveCapability <MailboxMoveCapability>]
   [-MailboxMoveEnabled <Boolean>]
   [-MailboxMovePublishedScopes <MultiValuedProperty>]
   [-MailTipsAccessEnabled <Boolean>]
   [-MailTipsAccessLevel <MailTipsAccessLevel>]
   [-MailTipsAccessScope <GroupIdParameter>]
   [-OAuthApplicationId <String>]
   [-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 Fédération.

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 | 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é.

Paramètres

-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 de boîtes aux lettres.
• $false : l’organisation externe ne fournit pas d’accès à distance aux archives de boîte aux lettres. Il s’agit de la valeur par défaut.

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

-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 applets de commande destructrices (par exemple, les applets de commande Remove-*) ont une pause intégrée qui vous oblige à accuser réception de la commande avant de continuer. Pour ces cmdlets, vous pouvez ignorer l’invite de confirmation à l’aide de cette syntaxe exacte : -Confirm:$false.
• La plupart des autres applets de commande (par exemple, les applets de commande 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
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

-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 d’organisation. Cette valeur signifie que l’organisation a accepté de partager tous les rapports de remise avec l’organisation externe, et que la relation d’organisation doit être utilisée pour récupérer les informations du rapport de remise à partir de l’organisation externe.
• $false : Les rapports de remise ne doivent pas être partagés sur la relation d’organisation. Il s'agit de la valeur par défaut.

Pour que le suivi des messages fonctionne dans un scénario Exchange intersite, ce paramètre doit être défini sur $true des deux côtés de la relation d’organisation. 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
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

-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
Required:	False
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és à 238 domaines dans une même requête.

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

-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 d’organisation est désactivée. Cette valeur arrête complètement le partage pour la relation d’organisation.

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

-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 à partir 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
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

-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 :

• Aucun : aucun accès libre/occupé.
• AvailabilityOnly : accès libre/occupé avec le temps uniquement.
• LimitedDetails : accès libre/occupé 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
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

-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
• 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
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

-MailboxMoveCapability

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre MailboxMoveCapability est utilisé dans les migrations de boîtes aux lettres entre locataires. Les valeurs valides sont les suivantes :

• Entrant
• Sortant
• RemoteInbound
• Sortant à distance

Pour plus d’informations, consultez Migration de boîtes aux lettres entre locataires.

Type:	MailboxMoveCapability
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-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îte aux lettres vers ou depuis l’organisation externe sont autorisés.
• $false : les déplacements de boîtes aux lettres vers ou depuis l’organisation externe ne sont pas autorisés. Il s’agit de la valeur par défaut.

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

-MailboxMovePublishedScopes

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

Le paramètre MailboxMovePublishedScopes est utilisé dans les migrations de boîtes aux lettres entre locataires pour spécifier les groupes de sécurité à extension messagerie dont les membres sont autorisés à migrer. Vous pouvez utiliser n’importe quelle valeur qui identifie de manière unique le groupe. Par exemple :

• Nom
• Nom unique
• Nom unique
• GUID

Pour entrer plusieurs valeurs, utilisez la syntaxe suivante : <value1>,<value2>,...<valueX>. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "<value1>","<value2>",..."<valueX>".

Pour plus d’informations, consultez Migration de boîtes aux lettres entre locataires.

Type:	MultiValuedProperty
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-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 retournées sur la relation d’organisation.
• $false : Les infos-courrier pour les utilisateurs de cette organisation ne sont pas retournées sur la relation d’organisation. 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
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

-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 :

• Tout : toutes les infos-courrier sont retourné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é.
• Limité : seules les infos-courrier susceptibles d’empêcher un rapport de non-remise (NDR) ou une réponse automatique sont retourné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.
• Aucun : aucune info-mail n’est retourné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
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

-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
• 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
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

-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
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

-OAuthApplicationId

Ce paramètre est disponible uniquement dans le service basé sur le cloud.

L’OAuthApplicationId est utilisé dans les migrations de boîtes aux lettres entre locataires pour spécifier l’ID d’application de l’application de migration de boîtes aux lettres que vous avez consentie. Pour plus d’informations, consultez Migration de boîtes aux lettres entre locataires.

Type:	String
Position:	Named
Default value:	None
Required:	False
Accept pipeline input:	False
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-OrganizationContact

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

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

-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 retournées via la relation d’organisation.
• $false : les photos des utilisateurs de cette organisation ne sont pas retournées sur la relation d’organisation. Il s’agit de la valeur par défaut.

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

-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 que l’organisation externe récupère les informations de disponibilité, par exemple, mail.contoso.com.

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

-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 de serveur Exchange approprié à utiliser pour les requêtes externes.

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

-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 d’organisation. Il est utilisé pour la redirection Outlook sur le web dans un scénario Exchange intersite. La configuration de cet attribut permet aux utilisateurs de l’organisation d’utiliser leur URL de Outlook sur le web actuelle pour accéder à Outlook sur le web dans l’organisation externe.

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

-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
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

-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
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.