Share via

Set-ForeignConnector

  • Article

 

S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Dernière rubrique modifiée : 2007-06-28

La cmdlet Set-ForeignConnector permet de modifier un connecteur étranger sur un ordinateur exécutant Microsoft Exchange Server 2007 sur lequel le rôle serveur de transport Hub est installé. Un connecteur étranger utilise un répertoire de dépôt sur un serveur de transport Hub pour envoyer des messages à un serveur de messagerie local n'utilisant pas le protocole SMTP (Simple Mail Transfer Protocol) 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.

Syntaxe

Set-ForeignConnector -Identity <ForeignConnectorIdParameter> [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Force <SwitchParameter>] [-Instance <ForeignConnector>] [-IsScopedConnector <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Description détaillée

La cmdlet Set-ForeignConnector modifie un connecteur étranger existant. Les changements de propriété que vous spécifiez lorsque vous utilisez la cmdlet Set-ForeignConnector remplacent les valeurs de propriété existantes.

Pour exécuter la cmdlet Set-ForeignConnector, vous devez utiliser un compte auquel le rôle Administrateur de serveur Exchange et le groupe Administrateurs local ont été délégués pour le serveur cible.

Pour plus d'informations sur les autorisations, la délégation de rôles et les droits requis pour administrer Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.

Paramètres

Paramètre Obligatoire Type Description

Identity

Obligatoire

Microsoft.Exchange.Configuration.Tasks.ForeignConnectorIdParameter

Ce paramètre 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

AddressSpaces

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie les noms de domaine auxquels le connecteur étranger envoie des messages. La syntaxe complète pour la saisie de 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'espace d'adressage 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'espace 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ées valides pour le coût s'étend de 1 à 100. Plus le coût est bas, meilleure est la route. 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 contenant le caractère point-virgule ( ; ), vous devez spécifier le coût d'espace d'adressage.

Si vous spécifiez le type d'espace d'adressage ou le coût d'espace d'adressage, vous devez placer 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 les séparant par des virgules, par exemple, comme suit : contoso.com,fabrikam.com. Si vous spécifiez le type d'espace d'adressage ou le coût d'espace d'adressage, vous devez placer l'espace d'adressage entre guillemets ( " ), par exemple, comme suit : "contoso.com;2","fabrikam.com;3".

Comment

Facultatif

System.String

Ce paramètre spécifie un commentaire facultatif pour le connecteur étranger. Le paramètre Comment doit être placé entre guillemets, par exemple : " ceci est une note administrative ".

Confirm

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre Confirm suspend le traitement par la commande et vous demande de confirmer les actions que la commande va exécuter avant de continuer le traitement. Il n'est pas nécessaire de spécifier une valeur pour le paramètre Confirm.

DomainController

Facultatif

Microsoft.Exchange.Data.Fqdn

Pour spécifier le nom de domaine complet (FQDN) du contrôleur de domaine qui écrit ce changement de configuration dans le service d'annuaire Active Directory, incluez le paramètre DomainController.

DropDirectory

Facultatif

System.String

Ce paramètre spécifie le nom du répertoire de dépôt est 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é du connecteur étranger. Deux éléments contrôlent l'emplacement du répertoire de dépôt pour chaque connecteur étranger :

  • Paramètre RootDropDirectoryPath de la cmdlet Set-TransportServer   Cette option est utilisée pour tous les connecteurs étrangers existant sur le serveur de transport Hub. La valeur du paramètre RootDropDirectoryPath peut être un chemin local ou un chemin UNC (Universal Naming Convention) pour un serveur distant.

  • Paramètre DropDirectory de la cmdlet Set-ForeignConnector   Cette valeur est définie pour chaque connecteur étranger existant sur le serveur de transport Hub.

Par défaut, le paramètre RootDropDirectoryPath est vide. Cela indique que la valeur de RootDropDirectoryPath est le dossier d'installation Exchange 2007. Le chemin par défaut du dossier d'installation d'Exchange 2007 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

DropDirectoryQuota

Facultatif

Microsoft.Exchange.Data.Unlimited

Ce paramètre 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. Lorsque vous entrez une valeur pour le paramètre DropDirectoryQuota, qualifiez-la à l'aide de l'une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont traitées comme des octets. La plage d'entrées valides pour ce paramètre s'étend de 1 à 2147483647. 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 unlimited.

Enabled

Facultatif

System.Boolean

Ce paramètre active ou désactive le connecteur étranger. Les entrées valides sont $True ou $False. La valeur par défaut est $True.

Force

Facultatif

System.Management.Automation.SwitchParameter

Ce paramètre supprime les messages d'avertissement ou de confirmation qui s'affichent durant certaines modifications de configuration.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.ForeignConnector

Le paramètre Instance permet de transmettre un objet entier à la commande à traiter. Il est principalement utilisé dans les scripts où un objet entier doit être transmis à la commande.

IsScopedConnector

Facultatif

System.Boolean

Ce paramètre contrôle la disponibilité du connecteur pour d'autres serveurs de transport Hub. Si la valeur de ce paramètre est $False, tous les serveurs de transport Hub de l'organisation Exchange peuvent utiliser le connecteur. Si la valeur de ce paramètre est $True, seuls des serveurs de transport Hub se trouvant dans le même site Active Directory peuvent utiliser le connecteur. La valeur par défaut est $False.

MaxMessageSize

Facultatif

Microsoft.Exchange.Data.Unlimited

Ce paramètre spécifie la taille maximale des messages qui peuvent transiter par ce connecteur étranger. Lorsque vous entrez une valeur pour le paramètre MaxMessageSize, qualifiez-la à l'aide de l'une des unités suivantes :

  • B (octets)

  • KB (kilo-octets)

  • MB (mégaoctets)

  • GB (gigaoctets)

  • TB (téraoctets)

Les valeurs non qualifiées sont traitées comme des Ko. 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ées valide pour ce paramètre s'étend de 0 à 2147483647 Ko. Si vous définissez la valeur du paramètre MaxMessageSize sur 0, vous désactivez effectivement le connecteur étranger. Toutefois, si vous définissez la valeur du paramètre MaxMessageSize sur 0 lorsque la valeur de l'attribut Enabled est $True, des erreurs sont générées dans le journal des événements. La méthode préférée pour désactiver le connecteur étranger consiste à utiliser le paramètre Enabled.

Name

Facultatif

System.String

Ce paramètre spécifie un nom descriptif pour le connecteur étranger.

RelayDsnRequired

Facultatif

System.Boolean

Ce paramètre 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.

SourceTransportServers

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Ce paramètre spécifie les noms des serveurs de transport Hub qui utilisent ce connecteur étranger. Vous pouvez spécifier plusieurs serveurs de transport Hub en séparant leurs noms par des virgules. Le fait d'avoir un connecteur étranger unique hébergé sur plusieurs serveurs de transport Hub garantit la tolérance de panne et une disponibilité élevée en cas de défaillance de l'un des serveurs de transport Hub. La valeur par défaut de ce paramètre est le nom du serveur de transport Hub sur lequel ce connecteur étranger a été installé initialement.

WhatIf

Facultatif

System.Management.Automation.SwitchParameter

Le paramètre WhatIf donne pour instruction à la commande de simuler les actions qu'elle va appliquer à l'objet. Grâce au paramètre WhatIf, vous pouvez afficher des changements potentiels sans devoir les appliquer. Il n'est pas nécessaire de spécifier une valeur pour le paramètre WhatIf.

Exemple

L'exemple de code suivant présente deux exemples utilisant la cmdlet Set-ForeignConnector.

Le premier exemple affiche une commande Set-ForeignConnector qui modifie un connecteur étranger nommé « Contoso Foreign Connector ». La commande définit le paramètre MaxMessageSize sur 10 MB.

Le second exemple affiche une commande Set-ForeignConnector qui modifie les espaces d’adressage desservis par un connecteur étranger existant nommé « Contoso Foreign Connector ». Les détails des espaces d'adressage sont les suivants :

  • Premier espace d'adressage :

    • Type d'espace d'adressage : SMTP

    • Espace d'adressage : " *.contoso.com "

    • Coût d'espace d'adressage : 1

  • Deuxième espace d'adressage :

    • Type d'espace d'adressage : Lotus Notes

    • Espace d'adressage : "*@domino"

    • Coût d'espace d'adressage : 55

Set-ForeignConnector "Contoso Foreign Connector" -MaxMessageSize 10MB
Set-ForeignConnector "Contoso Foreign Connector" -AddressSpaces ".contoso.com","Lotus Notes:*@domino;55"