Set-ForeignConnector
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 :
|
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>
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 (
Vous pouvez spécifier plusieurs espaces d'adressage en les séparant par des virgules, par exemple, comme suit : |
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 :
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 :
|
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 :
Les valeurs non qualifiées sont traitées comme des octets. La plage d'entrées valides pour ce paramètre s'étend de |
Enabled |
Facultatif |
System.Boolean |
Ce paramètre active ou désactive le connecteur étranger. Les entrées valides sont |
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 |
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 :
Les valeurs non qualifiées sont traitées comme des Ko. Si vous entrez la valeur |
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 |
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"