Update-SafeList
Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Última modificación del tema: 2008-07-18
Use el cmdlet Update-SafeList para actualizar los datos de la agregación de listas seguras del servicio de directorio de Active Directory. Los datos de la agregación de listas seguras se usan para filtrar correo no deseado en Microsoft Exchange Server 2007. EdgeSync replica los datos de la agregación de listas seguras que tienen instalada la función del servidor Transporte perimetral.
El cmdlet Update-SafeList lee los datos de la agregación de listas seguras que están almacenados en un buzón de usuario de Microsoft Office Outlook; a continuación, crea valores hash y escribe los datos en el objeto del usuario correspondiente de Active Directory. Los datos de la agregación de listas seguras incluyen la lista de remitentes seguros y la lista de destinatarios seguros del usuario de Outlook.
Use el parámetro Type para especificar si actualiza la lista de remitentes seguros o la lista de destinatarios seguros del usuario de Outlook, o ambas. Sin embargo, sólo se usan los datos de la lista de remitentes seguros en la función de agregación de listas seguras, que no actúa en los datos de la lista de destinatarios seguros. Por tanto, para reducir el sobredimensionamiento de almacenamiento y replicación de Active Directory, no se recomienda ejecutar el parámetro Type con los valores SafeRecipients o Both en Exchange 2007. El valor predeterminado del parámetro Type es SafeSenders.
Para obtener más información acerca del funcionamiento de la agregación de listas seguras, consulte Agregación de listas seguras.
Sintaxis
Update-SafeList -Identity <MailboxIdParameter> [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-IncludeDomains <SwitchParameter>] [-Type <SafeSenders | SafeRecipients | Both>] [-WhatIf [<SwitchParameter>]]
Descripción detallada
Para ejecutar el cmdlet Update-SafeList, debe usar una cuenta en la que se delegue lo siguiente:
Función de administradores con permisos de sólo vista de Exchange
Función Administrador de destinatarios de Exchange
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.Configuration.Tasks.MailboxIdParameter |
Use este parámetro para especificar el buzón de usuario de Outlook desde el que quiera recopilar datos de agregación de listas seguras. Los siguientes valores son entradas válidas para este parámetro:
|
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 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 sólo escribe en la instancia de ADAM local de Active Directory. |
IncludeDomains |
Opcional |
System.Management.Automation.SwitchParameter |
Use este parámetro si desea incluir los dominios del remitente que han especificado los usuarios en Outlook para las listas de seguridad agregadas. De forma predeterminada, los dominios que especifican los remitentes no se incluyen. En la mayoría de los casos, no le recomendamos que incluya dominios ya que los usuarios podrían incluir dominios de Proveedores de servicios Internet (ISP) grandes y así proporcionar direcciones de forma no intencionada que podrían usar o suplantar las personas que envían correos masivos. |
Type |
Opcional |
Microsoft.Exchange.Management.RecipientTasks.UpdateType |
Use este parámetro para especificar la lista generada por el usuario que se actualizará para el objeto de usuario. Los valores válidos de este parámetro son Importante En Exchange 2007, la función de agregación de listas seguras no actúa en los datos de la lista de destinatarios seguros. No se recomienda ejecutar el parámetro Type con los valores |
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
El primer ejemplo muestra cómo actualizar los datos de la lista de remitentes seguros para un solo usuario, KimA, mediante el cmdlet Update-SafeList.
El segundo ejemplo muestra cómo actualizar todos los datos de lista segura para todos los usuarios de buzón de la organización de Exchange. De forma predeterminada, el Shell de administración de Exchange está configurado para recuperar o modificar los objetos que residen en el dominio en el que reside el servidor de Exchange. Por tanto, para recuperar todos los buzones de la organización de Exchange, es necesario establecer el valor de $AdminSessionAdSettings.ViewEntireForest en $True. Así se puede ejecutar el cmdlet Get-Mailbox y canalizar la salida al cmdlet Update-Safelist para actualizar todos los datos de lista segura para todos los usuarios de buzón de la organización de Exchange.
Advertencia
Cuando se modifica el valor de $AdminSessionAdSettings.ViewEntireForest, el valor nuevo permanece hasta que se cierra la sesión del Shell de administración de Exchange abierta en ese momento. Es recomendable establecer $AdminSessionAdSettings.ViewEntireForest en $False inmediatamente después de realizar la tarea para evitar la recuperación o la modificación no intencionada de objetos que no estuviera en el plan establecido.
Update-Safelist -Identity KimA
AdminSessionAdSettings.ViewEntireForest = $True
get-mailbox -ResultSize Unlimited | where {$_.RecipientType -eq [Microsoft.Exchange.Data.Directory.Recipient.RecipientType]::UserMailbox } | update-safelist