Set-ForeignConnector (RTM)
S’applique à : Exchange Server 2007
Dernière rubrique modifiée : 2007-06-11
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>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]
Set-ForeignConnector [-AddressSpaces <MultiValuedProperty>] [-Comment <String>] [-DomainController <Fqdn>] [-DropDirectory <String>] [-DropDirectoryQuota <Unlimited>] [-Enabled <$true | $false>] [-Instance <ForeignConnector>] [-MaxMessageSize <Unlimited>] [-Name <String>] [-RelayDsnRequired <$true | $false>] [-SourceTransportServers <MultiValuedProperty>]
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. Vous pouvez spécifier plusieurs espaces d'adressage en les séparant par des virgules. La syntaxe complète pour la saisie de chaque espace d'adressage est la suivante : <ConnectorScope>:<AddressSpaceType>:<AddressSpace>;<AddressSpaceCost>
Vous devez uniquement utiliser la syntaxe complète pour le paramètre AddressSpaces dans les conditions suivantes :
Si vous entrez un nom de domaine ou une liste de noms de domaine séparés par une virgule pour la valeur du paramètre AddressSpaces, le type d’espace d’adressage SMTP et un coût de 1 sont attribués à chaque nom de domaine. |
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 ". |
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 |
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. |
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. |
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"