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