Set-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.
La cmdlet Set-OrganizationRelationship permet de modifier des relations organisationnelles existantes. 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
Set-OrganizationRelationship
[-Identity] <OrganizationRelationshipIdParameter>
[-ArchiveAccessEnabled <Boolean>]
[-Confirm]
[-DeliveryReportEnabled <Boolean>]
[-DomainController <Fqdn>]
[-DomainNames <MultiValuedProperty>]
[-Enabled <Boolean>]
[-Force]
[-FreeBusyAccessEnabled <Boolean>]
[-FreeBusyAccessLevel <FreeBusyAccessLevel>]
[-FreeBusyAccessScope <GroupIdParameter>]
[-MailboxMoveCapability <MailboxMoveCapability>]
[-MailboxMoveEnabled <Boolean>]
[-MailboxMovePublishedScopes <MultiValuedProperty>]
[-MailTipsAccessEnabled <Boolean>]
[-MailTipsAccessLevel <MailTipsAccessLevel>]
[-MailTipsAccessScope <GroupIdParameter>]
[-Name <String>]
[-OAuthApplicationId <String>]
[-OrganizationContact <SmtpAddress>]
[-PhotosEnabled <Boolean>]
[-TargetApplicationUri <Uri>]
[-TargetAutodiscoverEpr <Uri>]
[-TargetOwaURL <Uri>]
[-TargetSharingEpr <Uri>]
[-WhatIf]
[<CommonParameters>]
Description
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
Set-OrganizationRelationship -Identity "Fourth Coffee" -FreeBusyAccessLevel LimitedDetails
Cet exemple modifie le niveau d’accès aux informations de disponibilité pour le faire passer à LimitedDetails, en incluant l’heure, l’objet et l’emplacement.
Exemple 2
Set-OrganizationRelationship -Identity "Contoso" -Enabled $false
Cet exemple désactive la relation d’organisation avec Contoso
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 valeurs séparées par des virgules (par exemple, « contoso.com » ou « northamerica.contoso.com »).
Type: | MultiValuedProperty |
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 |
-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 |
-Force
Le commutateur Force masque les messages d’avertissement ou de confirmation. Il n’est pas nécessaire de spécifier une valeur pour ce commutateur.
Vous pouvez utiliser ce commutateur pour exécuter des tâches par programme, lorsqu’une intervention administrative est inappropriée.
Type: | SwitchParameter |
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 |
-Identity
Le paramètre Identity indique la relation d’organisation à modifier. Vous pouvez utiliser n’importe quelle valeur qui identifie la relation d’organisation de façon unique. Par exemple :
- Nom
- Nom canonique
- GUID
Type: | OrganizationRelationshipIdParameter |
Position: | 1 |
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 |
-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îte aux lettres vers à 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 |
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 et remplacer les entrées existantes, utilisez la syntaxe suivante : Value1,Value2,...ValueN
. Si les valeurs contiennent des espaces ou requièrent des guillemets, utilisez la syntaxe suivante : "Value1","Value2",..."ValueN"
.
Pour ajouter ou supprimer une ou plusieurs valeurs sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}
.
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: | 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 |
-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 récupérer des 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 la découverte automatique pour détecter automatiquement le point de terminaison de serveur Exchange correct à 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é par le paramètre TargetAutoDiscoverEpr n’est pas utilisé 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.