Remove-AddressRewriteEntry
S’applique à : Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Dernière rubrique modifiée : 2007-07-27
La cmdlet Remove-AddressRewriteEntry permet de supprimer une entrée de réécriture d'adresses existante devenue inutile.
Syntaxe
remove-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Description détaillée
Dans Microsoft Exchange Server 2007, la réécriture d'adresses vous permet de modifier les adresses d'expéditeurs et de destinataires sur les messages entrants et sortants d'une organisation Exchange 2007. Vous configurez les agents de réécriture d'adresses sur le connecteur de réception et le connecteur d'envoi d'un ordinateur sur lequel le rôle serveur de transport Edge est installé.
Pour exécuter la cmdlet Remove-AddressRewriteEntry 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 Exchange 2007, consultez la rubrique Considérations relatives aux autorisations.
Paramètres
| Paramètre | Obligatoire | Type | Description |
|---|---|---|---|
Identity |
Obligatoire |
Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter |
Ce paramètre spécifie l'entrée de réécriture d'adresses à supprimer. Le paramètre Identity accepte un GUID ou le nom unique de réécriture d'adresses. Vous pouvez omettre le libellé du paramètre Identity. |
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. |
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 |
|---|---|
|
Exceptions
| Exceptions | Description |
|---|---|
|
Exemple
Les exemples suivants montrent comment supprimer des entrées de réécriture d'adresses existantes devenues inutiles. Le premier exemple montre comment supprimer une entrée de réécriture d'adresses spécifique.
Le second exemple montre comment afficher une liste récapitulative de toutes les entrées de réécriture d'adresses qui seront supprimées si elles contiennent la chaîne "contoso.com". Pour supprimer plusieurs entrées de réécriture d'adresses, vous devez canaliser les résultats de la commande Get-AddressRewriteEntry vers la commande Remove-AddressRewriteEntry. Utilisez le paramètre WhatIf pour simuler les actions que la commande exécuterait sans réellement appliquer les modifications. Si vous supprimez le paramètre WhatIf et exécutez de nouveau la commande, les entrées de réécriture d'adresses sont supprimées.
Pour plus d'informations sur le traitement en pipeline, consultez la rubrique Traitement en pipeline.
Remove-AddressRewriteEntry "Address rewrite entry for contoso.com"
Get-AddressRewriteEntry "*contoso.com" | Remove-AddressRewriteEntry -WhatIf:$true