Set-ForeignConnector
La cmdlet est disponible uniquement dans Exchange en local.
Utilisez la cmdlet Set-ForeignConnector pour modifier un connecteur étranger dans le service de transport d'un serveur de boîtes aux lettres.
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-ForeignConnector
[-Identity] <ForeignConnectorIdParameter>
[-AddressSpaces <MultiValuedProperty>]
[-Comment <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-DropDirectory <String>]
[-DropDirectoryQuota <Unlimited>]
[-Enabled <Boolean>]
[-Force]
[-IsScopedConnector <Boolean>]
[-MaxMessageSize <Unlimited>]
[-Name <String>]
[-RelayDsnRequired <Boolean>]
[-SourceTransportServers <MultiValuedProperty>]
[-WhatIf]
[<CommonParameters>] Description
Un connecteur étranger utilise un répertoire de dépôt dans le service de transport d'un serveur de boîtes aux lettres pour envoyer des messages à un serveur de messagerie local n’utilisant pas SMTP comme mécanisme de transport principal. Ces serveurs de messagerie sont appelés serveurs de passerelle étrangers. Les serveurs de passerelle de télécopie tiers sont des exemples de serveurs de passerelle étrangers. Les espaces d’adressage affectés à un connecteur étranger peuvent être SMTP ou non-SMTP.
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-ForeignConnector "Fax Connector" -MaxMessageSize 10MBCet exemple configure une limite de taille de message de 10 Mo sur le connecteur étranger existant (en l’occurrence, le connecteur pour les télécopies).
Paramètres
-AddressSpaces
Le paramètre AddressSpaces spécifie les noms de domaine auxquels le connecteur étranger envoie des messages. La syntaxe complète pour entrer chaque espace d’adressage est la suivante : AddressSpaceType:AddressSpace;AddressSpaceCost.
- AddressSpaceType : Le type d'espace d'adressage peut être SMTP, X400 ou toute autre chaîne de texte. Si vous omettez le type d’espace d’adressage, un type d’espace d’adressage SMTP est utilisé par défaut.
- AddressSpace : Pour les types d'espaces d'adressages SMTP, l'espace d'adressage que vous entrez doit être conforme à la norme RFC 1035. Par exemple, *, *.com et *.contoso.com sont autorisés, mais *contoso.com ne l’est pas. Pour les types d’espaces d’adressage X.400, l’espace d’adressage que vous entrez doit être conforme à la norme RFC 1685, tel que o=MySite;p=MyOrg;a=adatum;c=us. Pour toutes les autres valeurs de type d’adressage, vous pouvez entrer un texte quelconque pour l’espace d’adressage.
- AddressSpaceCost : La plage d’entrée valide pour le coût s’étend de 1 à 100. Plus le coût est bas, meilleur est l’itinéraire. Si vous omettez le coût d’espace d’adressage, un coût de 1 est utilisé par défaut. Si vous entrez un espace d’adressage non SMTP qui contient un point-virgule (;), vous devez spécifier le coût de l’espace d’adressage.
Si vous spécifiez le type d’espace d’adressage ou le coût d’espace d’adressage, vous devez insérer l’espace d’adressage entre guillemets ("). Par exemple, les entrées d’espace d’adressage suivantes sont équivalentes :
- « SMTP:contoso.com;1 »
- « contoso.com;1 »
- « SMTP:contoso.com »
- contoso.com
Vous pouvez spécifier plusieurs espaces d’adressage en séparant les espaces d’adressage par des virgules, par exemple : contoso.com,fabrikam.com. Si vous spécifiez le type d’espace d’adressage ou le coût de l’espace d’adressage, vous devez placer l’espace d’adressage entre guillemets (« ), par exemple : "contoso.com;2","fabrikam.com;3".
Pour ajouter ou supprimer une ou plusieurs valeurs d’espace d’adressage sans affecter les entrées existantes, utilisez la syntaxe suivante : @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.
| Type: | MultiValuedProperty |
| 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 |
-Comment
Le paramètre Comment permet d’insérer un commentaire facultatif. Si la valeur que vous saisissez contient des espaces, placez-la entre guillemets ("). Par exemple : "Ceci est une note d’administration".
| 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 |
-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 |
-DomainController
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 ».
Les serveurs de transport Edge ne prennent pas en charge le paramètre DomainController. Un serveur de transport Edge utilise l’instance locale des services AD LDS (Active Directory Lightweight Directory Services) pour lire et écrire des données.
| 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 |
-DropDirectory
Le paramètre DropDirectory spécifie le nom du répertoire de dépôt utilisé par ce connecteur étranger. Tous les messages sortants envoyés aux espaces d’adressage définis par ce connecteur étranger sont placés dans le répertoire de dépôt spécifié. Deux éléments contrôlent l’emplacement du répertoire de dépôt pour chaque connecteur étranger :
- Paramètre RootDropDirectoryPath dans l’applet de commande Set-TransportService : cette option est utilisée pour tous les connecteurs étrangers qui existent sur le serveur de boîtes aux lettres. La valeur du paramètre RootDropDirectoryPath peut être un chemin d’accès local ou un chemin d’accès UNC (Universal Naming Convention) vers un serveur distant.
- Paramètre DropDirectory configuré dans la cmdlet Set-ForeignConnector : Cette valeur est associée à chaque connecteur étranger présent sur le serveur.
Par défaut, le paramètre RootDropDirectoryPath est vide. Cela indique que la valeur de RootDropDirectoryPath est le dossier d’installation d’Exchange 2010. Le dossier d’installation d’Exchange 2010 par défaut est C:\Program Files\Microsoft\Exchange Server\. Par défaut, la valeur du paramètre DropDirectory est le nom du connecteur étranger.
Si la valeur du paramètre DropDirectory ne contient pas d’informations de chemin absolu, l’emplacement du répertoire de dépôt est défini par la combinaison des paramètres DropDirectory et RootDropDirectoryPath. Si la valeur du paramètre DropDirectory contient des informations de chemin absolu, la valeur du paramètre RootDropDirectoryPath ne doit pas être spécifiée. L’emplacement du répertoire de dépôt est défini uniquement par la valeur du paramètre DropDirectory.
Le répertoire de dépôt n’est pas créé automatiquement. Vous devez par conséquent créer manuellement chaque dossier de répertoire de dépôt.
Le répertoire de dépôt doit avoir les autorisations suivantes :
- Service réseau : Contrôle total
- Système : Contrôle total
- Administrateurs : Contrôle total
| 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 |
-DropDirectoryQuota
Le paramètre DropDirectoryQuota spécifie la taille maximale de tous les fichiers de messages dans le répertoire de dépôt. Une fois la valeur spécifiée atteinte, aucun nouveau fichier de message ne peut être copié dans le répertoire de dépôt tant que les messages existants sont remis et supprimés.
Une valeur valide est un nombre allant jusqu’à 1,999999999 téraoctets (2199023254528 octets) ou la valeur unlimited. La valeur par défaut est de 6 gigaoctets (6442450944 octets).
- B (octets)
- KB (kilo-octets)
- MB (mégaoctets)
- GB (gigaoctets)
- To (téraoctets)
TB (téraoctets)
La plage d’entrées valide pour ce paramètre s’étend de 1 à 2147483647 octets. Si vous entrez la valeur unlimited, aucune limite de taille de message n’est imposée au répertoire de dépôt. La valeur par défaut est illimitée.
| Type: | Unlimited |
| 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 |
-Enabled
Le paramètre Enabled spécifie s’il faut activer le connecteur. Les valeurs valides sont $true ou $false. La valeur par défaut est $true.
| 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 |
-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 |
-Identity
Le paramètre Identity spécifie le connecteur étranger que vous voulez modifier. Le paramètre Identity peut prendre l’une des valeurs suivantes pour l’objet connecteur étranger :
- GUID
- Nom du connecteur
- ServerName\ConnectorName
| Type: | ForeignConnectorIdParameter |
| 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 |
-IsScopedConnector
Le paramètre IsScopedConnector indique la disponibilité du connecteur pour d'autres serveurs de boîtes que lettres. Lorsque la valeur de ce paramètre est $false, le connecteur peut être utilisé par tous les serveurs de boîtes aux lettres de l’organisation Exchange. Lorsque la valeur de ce paramètre est $true, le connecteur ne peut être utilisé que par les serveurs de boîtes aux lettres du même site Active Directory. La valeur par défaut est $false.
| 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 |
-MaxMessageSize
Le paramètre MaxMessageSize spécifie la taille maximale des messages qui peuvent transiter par ce connecteur étranger.
Une valeur valide est un nombre allant jusqu’à 1,999999999 téraoctets (2199023254528 octets) ou la valeur unlimited. La valeur par défaut est de 6 gigaoctets (6442450944 octets).
- B (octets)
- KB (kilo-octets)
- MB (mégaoctets)
- GB (gigaoctets)
- To (téraoctets)
TB (téraoctets)
Si vous entrez la valeur unlimited, aucune limite de taille de message n’est imposée au connecteur étranger. La valeur par défaut est unlimited. La plage d’entrée valide pour ce paramètre s’étend de 0 à 2147483647 kilo-octets. Si vous définissez la valeur du paramètre MaxMessageSize sur 0, vous désactivez effectivement le connecteur étranger. Cependant, si vous définissez la valeur du paramètre MaxMessageSize sur 0 lorsque la valeur de l’attribut Enabled est $true, des erreurs du journal d’événements se produisent. La méthode préférée pour désactiver le connecteur étranger consiste à utiliser le paramètre Enabled.
| Type: | Unlimited |
| 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 |
-Name
Le paramètre Name spécifie un nom descriptif pour le connecteur étranger.
| 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 |
-RelayDsnRequired
Le paramètre RelayDsnRequired spécifie si une notification d’état de remise relayée est requise par le connecteur étranger lors de l’écriture de messages dans le répertoire de dépôt. Les valeurs valides pour ce paramètre sont $true ou $false. La valeur par défaut est $false.
| 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 |
-SourceTransportServers
Le paramètre SourceTransportServers spécifie les noms des serveurs de boîtes aux lettres qui utilisent ce connecteur étranger. S’il existe un connecteur étranger unique sur plusieurs serveurs de boîtes aux lettres exécutant le service de transport, vous disposez d’une tolérance de panne et d’une capacité élevées si l’un de ces serveurs est défaillant. La valeur par défaut de ce paramètre est le nom du serveur de boîte aux lettres sur lequel ce connecteur étranger a été installé initialement.
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"...}.
| Type: | MultiValuedProperty |
| 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 |
-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 |
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.