Remove-AddressRewriteEntry
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2007-07-27
Utilice el cmdlet Remove-AddressRewriteEntry para quitar una entrada de reescritura de direcciones que ya no sea necesaria.
Sintaxis
remove-addressrewriteentry -Identity <AddressRewriteEntryIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
En Microsoft Exchange Server 2007, la reescritura de direcciones permite modificar las direcciones de los remitentes y destinatarios en los mensajes que entran y salen de una organización de Exchange 2007. Los agentes de reescritura de direcciones se configuran en los conectores de recepción y de envío de un equipo que tiene instalada la función del servidor Transporte perimetral.
Para ejecutar el cmdlet Remove-AddressRewriteEntry en un equipo que tiene instalada la función del servidor Transporte perimetral, debe iniciar sesión mediante una cuenta que pertenezca al grupo local de administradores de dicho equipo.
Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Exchange 2007, consulte Consideraciones sobre permisos.
Parámetros
| Parámetro | Necesario | Tipo | Descripción |
|---|---|---|---|
Identity |
Necesario |
Microsoft.Exchange.Management.MessagingPolicies.AddressRewrite.AddressRewriteEntryIdParameter |
Este parámetro especifica la entrada de reescritura de direcciones que se va a quitar. El parámetro Identity aceptará un GUID o el nombre de reescritura de direcciones único. Puede omitir la etiqueta del parámetro Identity. |
Confirm |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro Confirm hace que el comando ponga en pausa el procesamiento y requiere que usted reconozca qué hará el comando antes de seguir con el procesamiento. No es necesario especificar un valor con el parámetro Confirm. |
DomainController |
Opcional |
Microsoft.Exchange.Data.Fqdn |
Para especificar el nombre de dominio completo (FQDN) del controlador de dominio que escribe este cambio de configuración en el servicio de directorio de Active Directory, incluya el parámetro DomainController en el comando. El parámetro DomainController no se admite en equipos que tienen instalada la función del servidor Transporte perimetral. La función del servidor Transporte perimetral escribe únicamente en la instancia de ADAM local. |
WhatIf |
Opcional |
System.Management.Automation.SwitchParameter |
El parámetro WhatIf indica al comando que simule las acciones que llevaría a cabo en el objeto. Mediante el uso del parámetro WhatIf, puede ver los cambios que se producirían sin tener que aplicarlos. No es necesario especificar un valor con el parámetro WhatIf. |
Tipos de entrada
Tipos de valores devueltos
Errores
| Error | Descripción |
|---|---|
|
Excepciones
| Excepciones | Descripción |
|---|---|
|
Ejemplo
En los ejemplos siguientes se muestra cómo quitar entradas de reescritura de direcciones existentes que ya no son necesarias. En el primer ejemplo se muestra cómo quitar una entrada de reescritura de dirección específica.
En el segundo ejemplo se muestra cómo ver una lista de todas las entradas de reescritura de direcciones que se quitarán si contienen la cadena "contoso.com". Para quitar varias entradas de reescritura de direcciones, debe canalizar los resultados del comando Get-AddressRewriteEntry en el comando Remove-AddressRewriteEntry. Utilice el parámetro WhatIf para simular las acciones que el comando realizaría sin aplicar los cambios realmente. Si quita el parámetro WhatIf y vuelve a ejecutar el comando, se quitarán las entradas de reescritura de direcciones.
Para obtener más información acerca de la canalización, vea Canalización (en inglés).
Remove-AddressRewriteEntry "Address rewrite entry for contoso.com"
Get-AddressRewriteEntry "*contoso.com" | Remove-AddressRewriteEntry -WhatIf:$true