Set-SenderIdConfig

 

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

Dernière rubrique modifiée : 2012-04-26

La cmdlet Set-SenderIdConfig permet de modifier la configuration d'ID expéditeur sur un ordinateur sur lequel le rôle serveur de transport Hub ou Edge est installé.

Syntaxe

Set-SenderIdConfig [-BypassedRecipients <MultiValuedProperty>] [-BypassedSenderDomains <MultiValuedProperty>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-ExternalMailEnabled <$true | $false>] [-Instance <SenderIdConfig>] [-InternalMailEnabled <$true | $false>] [-SpoofedDomainAction <StampStatus | Reject | Delete>] [-TempErrorAction <StampStatus | Reject | Delete>] [-WhatIf [<SwitchParameter>]]

Description détaillée

Pour exécuter la cmdlet Set-SenderIdConfig, vous devez utiliser un compte auquel ont été délégués :

  • le rôle Administrateur de serveur Exchange et le groupe Administrateurs local pour le serveur cible.

Pour exécuter la cmdlet Set-SenderIdConfig sur un ordinateur sur lequel le rôle serveur de transport Edge est installé, vous devez ouvrir une session en utilisant un compte membre du groupe Administrateurs local présent sur cet ordinateur.

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

Paramètres

Paramètre Obligatoire Type Description

BypassedRecipients

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre BypassedRecipients a pour valeur une ou plusieurs adresses SMTP. Les messages liés pour les adresses SMTP répertoriées dans ce paramètre sont exclus du traitement par l'agent d'ID expéditeur. Pour entrer plusieurs adresses SMTP, séparez-les par des virgules et placez-les entre guillemets doubles, comme suit : "recipient1@contoso.com, recipient2@contoso.com"

Le nombre maximal de destinataires que vous pouvez entrer est 800.

ByPassedSenderDomains

Facultatif

Microsoft.Exchange.Data.MultiValuedProperty

Le paramètre BypassedSenderDomains a pour valeur un ou plusieurs noms de domaine. Les messages en provenance des domaines répertoriés dans ce paramètre sont exclus du traitement par l'agent d'ID expéditeur. Pour entrer plusieurs domaines, séparez-les à l'aide de virgules et placez les adresses entre guillemets doubles, comme suit : "contoso.com, example.com"

Le nombre maximal de noms de domaine que vous pouvez entrer est 800.

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 dans la commande. Le paramètre DomainController n'est pas pris en charge sur les ordinateurs sur lesquels le rôle serveur de transport Edge est installé. Le rôle serveur de transport Edge écrit uniquement sur l'instance ADAM locale.

Enabled

Facultatif

System.Boolean

Une entrée valide pour le paramètre Enabled est $true ou $false. Le paramètre par défaut est $true. Lorsque le paramètre Enabled a la valeur $true, l'agent d'ID expéditeur est activé sur l'ordinateur sur lequel la commande Set‑SenderIdConfig est exécutée.

ExternalMailEnabled

Facultatif

System.Boolean

Une entrée valide pour le paramètre ExternalMailEnabled est $true ou $false. Le paramètre par défaut est $true. Lorsque le paramètre ExternalMailEnabled a la valeur $true, tous les messages provenant de connexions non authentifiées sont transmis via l'agent d'ID expéditeur pour traitement.

Instance

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.SenderIdConfig

Le paramètre Instance vous 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.

InternalMailEnabled

Facultatif

System.Boolean

Une entrée valide pour le paramètre InternalMailEnabled est $true ou $false. Le paramètre par défaut est $false. Lorsque le paramètre InternalMailEnabled a la valeur $true, tous les messages provenant de domaines d'expéditeur authentifié appartenant à des domaines faisant autorité au sein de votre entreprise sont transmis via l'agent d'ID expéditeur pour traitement.

SpoofedDomainAction

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.SenderIdAction

Ce paramètre spécifie l'action que l'agent d'ID expéditeur applique au message lorsque le domaine de l'expéditeur apparaît à l'évidence falsifié. Le paramètre SpoofedDomainAction prend les valeurs suivantes : StampStatus, Reject, Delete. La valeur par défaut est StampStatus.

TempErrorAction

Facultatif

Microsoft.Exchange.Data.Directory.SystemConfiguration.SenderIdAction

Ce paramètre spécifie l'action que l'agent d'ID expéditeur applique au message si un état de TempError d'ID expéditeur est retourné. Le paramètre TempErrorAction prend les valeurs suivantes : StampStatus, Reject, Delete. La valeur par défaut est StampStatus.

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.

Types d'entrées

Types de retours

Erreurs

Erreur Description

 

Exemple

L'exemple de code suivant montre une commande Set‑SenderIdConfig dont la configuration d'ID expéditeur a été modifiée de la manière suivante :

  • Elle paramètre l'agent d'ID expéditeur pour supprimer tous les messages expédiés à partir de domaines falsifiés.

  • Elle spécifie deux destinataires que l'agent d'ID expéditeur exclut lorsqu'il traite des messages.

Set-SenderIdConfig -SpoofedDomainAction Delete -BypassedRecipients user1@contoso.com,user2@contoso.com