Set-IPAllowListProvider

Artículo
06/26/2014

Se aplica a: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

Última modificación del tema: 2007-06-28

Utilice el cmdlet Set‑IPAllowListProviderpara modificar la información de una determinada configuración del proveedor de la lista de IP admitidas en un equipo que tenga instalada la función del servidor Transporte perimetral o transporte de concentradores.

Sintaxis

Set-IPAllowListProvider -Identity <IPAllowListProviderIdParameter> [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Set-IPAllowListProvider [-AnyMatch <$true | $false>] [-BitmaskMatch <IPAddress>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Enabled <$true | $false>] [-Instance <IPAllowListProvider>] [-IPAddressesMatch <MultiValuedProperty>] [-LookupDomain <SmtpDomain>] [-Name <String>] [-Priority <Int32>] [-WhatIf [<SwitchParameter>]]

Descripción detallada

Utilice el cmdlet Set‑IPAllowListProvider para modificar las configuraciones existentes del proveedor de la lista de IP admitidas. Esta configuración la utiliza el agente de filtro de conexiones. Se necesita el parámetro Identity.

Para ejecutar el cmdlet Set-IPAllowListProvider, debe utilizar una cuenta en la que se delegue lo siguiente:

Función de administrador de servidores de Exchange y grupo local Administradores para el servidor de destino

Para ejecutar el cmdlet Set‑IPAllowListProvider en un equipo que tiene la función del servidor Transporte perimetral instalada, tiene que iniciar sesión mediante una cuenta que sea miembro del grupo local de administradores de ese equipo.

Para obtener más información acerca de los permisos, la delegación de funciones y los derechos necesarios para administrar Microsoft Exchange Server 2007, consulte Consideraciones sobre permisos.

Parámetros

Parámetro	Necesario	Tipo	Descripción
Identity	Necesario	Microsoft.Exchange.Configuration.Tasks.IPAllowListProviderIdParameter	El parámetro Identity puede incluir un valor de cadena, que es el valor Name o la GUID.
AnyMatch	Opcional	System.Boolean	Las entradas válidas del parámetro AnyMatch son `$true` o `$false`. El valor predeterminado es `$false`. Cuando el parámetro AnyMatch tiene el valor `$true`, el agente de filtro de conexiones considera como coincidencia todos los códigos de estado de dirección IP que devuelve el servicio proveedor de la lista de IP admitidas.
BitmaskMatch	Opcional	System.Net.IPAddress	Cuando se configura una dirección IP para el parámetro BitmaskMatch, el agente de filtro de conexiones sólo actúa en los mensajes que coinciden con el código de estado de dirección IP que devuelve el servicio proveedor de la lista de IP admitidas.
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 qué controlador de dominio escribe este cambio de configuración correspondiente a los datos de configuración de filtrado de conexiones en el servicio de directorio Active Directory, incluya el parámetro DomainController en el comando. No se admite el parámetro DomainController si está ejecutando este comando en un equipo con la función del servidor Transporte perimetral instalada. El servidor de transporte perimetral sólo escribe en la instancia de ADAM local.
Enabled	Opcional	System.Boolean	Las entradas válidas del parámetro Enabled son `$true` o `$false`. El valor predeterminado es `$true`. Cuando el parámetro Enabled tiene el valor `$true`, el agente de filtro de conexiones consulta el servicio proveedor de la lista de IP admitidas según la prioridad que se haya establecido para esta configuración del proveedor de la lista IP admitidas.
Instance	Opcional	Microsoft.Exchange.Data.Directory.SystemConfiguration.IPAllowListProvider	El parámetro Instance le permite pasar un objeto completo al comando que se va a procesar. Se utiliza principalmente en scripts donde hay que pasar un objeto completo al comando.
IPAddressesMatch	Opcional	Microsoft.Exchange.Data.MultiValuedProperty	Cuando se configura una dirección IP para el parámetro IPAddressesMatch, el agente de filtro de conexiones sólo actúa en los mensajes que coinciden con el código de estado de dirección IP que devuelve el servicio proveedor de la lista de IP admitidas.
LookupDomain	Opcional	Microsoft.Exchange.Data.SmtpDomain	El nombre de dominio que consulta el agente de filtro de conexiones para los datos actualizados de la lista de IP admitidas.
Name	Opcional	System.String	El nombre del servicio proveedor de la lista de IP admitidas. El valor de cadena del parámetro Identity no cambia al modificar este valor.
Priority	Opcional	System.Int32	Establezca el parámetro Priority para configurar el orden en que el agente de filtro de conexiones consulta los servicios proveedores de la lista de IP admitidas que se han definido. De forma predeterminada, al agregar un nuevo servicio proveedor de la lista de IP admitidas, a la entrada se le asigna la prioridad N+1, donde N es el número de servicios proveedores de la lista de IP admitidas que se han configurado. Si al parámetro Priority se le asigna un valor idéntico al de otro servicio proveedor de la lista de IP admitidas, incrementa en 1 la prioridad del servicio proveedor de la lista de IP admitidas que se ha agregado en primer lugar.
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

Ejemplo

El primer ejemplo de código muestra un comando Set‑IPAllowListProvider que hace que el agente de filtro de conexiones considere como evento procesable todas las coincidencias procedentes del servicio proveedor de la lista de IP admitidas.

El segundo ejemplo de código muestra un comando Set‑IPAllowListProvider que establece en 1 la prioridad de una configuración existente.

Set-IPAllowListProvider -Identity Example.com -AnyMatch:$true 
Set-IPAllowListProvider -Identity Example.com -Priority 1