Set-ClientAccessRule

Sintaxis

Default (valor predeterminado)

Set-ClientAccessRule
    [-Identity] <ClientAccessRuleIdParameter>
    [-Action <ClientAccessRulesAction>]
    [-AnyOfAuthenticationTypes <MultiValuedProperty>]
    [-AnyOfClientIPAddressesOrRanges <MultiValuedProperty>]
    [-AnyOfProtocols <MultiValuedProperty>]
    [-AnyOfSourceTcpPortNumbers <MultiValuedProperty>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-Enabled <Boolean>]
    [-ExceptAnyOfAuthenticationTypes <MultiValuedProperty>]
    [-ExceptAnyOfClientIPAddressesOrRanges <MultiValuedProperty>]
    [-ExceptAnyOfProtocols <MultiValuedProperty>]
    [-ExceptAnyOfSourceTcpPortNumbers <MultiValuedProperty>]
    [-ExceptUserIsMemberOf <MultiValuedProperty>]
    [-ExceptUsernameMatchesAnyOfPatterns <MultiValuedProperty>]
    [-Name <String>]
    [-Priority <Int32>]
    [-Scope <ClientAccessRulesScope>]
    [-UserIsMemberOf <MultiValuedProperty>]
    [-UsernameMatchesAnyOfPatterns <MultiValuedProperty>]
    [-UserRecipientFilter <String>]
    [-WhatIf]
    [<CommonParameters>]

Description

Ejemplos

Ejemplo 1

Set-ClientAccessRule "Allow IMAP4" -AnyOfClientIPAddressesOrRanges @{Add="172.17.17.27/16"}

Parámetros

-Action

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Action especifica la acción para la regla de acceso de cliente. Los valores válidos de este parámetro son AllowAccess y DenyAccess.

Propiedades de parámetro

Conjuntos de parámetros

-AnyOfAuthenticationTypes

Aplicable: Exchange Server 2013, Exchange Server 2016

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-AnyOfClientIPAddressesOrRanges

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro AnyOfClientIPAddressesOrRanges especifica una condición para la regla de acceso de cliente que se basa en la dirección IPv4 o IPv6 del cliente. Los valores admitidos son:

• Dirección IP única: por ejemplo, 192.168.1.1 o 2001:DB8::2AA:FF:C0A8:640A.
• Intervalo de direcciones IP: por ejemplo, 192.168.0.1-192.168.0.254 o 2001:DB8::2AA:FF:C0A8:640A-2001:DB8::2AA:FF:C0A8:6414.
• Intervalo de direcciones IP de enrutamiento entre dominios sin clase (CIDR): por ejemplo, 192.168.3.1/24 o 2001:DB8::2AA:FF:C0A8:640A/64.

Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Para obtener más información sobre las direcciones IPv6 y la sintaxis, consulte este artículo de Exchange 2013: Conceptos básicos de direcciones IPv6.

Propiedades de parámetro

Conjuntos de parámetros

-AnyOfProtocols

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro AnyOfProtocols especifica una condición para la regla de acceso de cliente que se basa en el protocolo del cliente.

El parámetro PasswordQuality especifica la clasificación de calidad mínima de la contraseña que se requiere para las contraseñas del dispositivo. La calidad de la contraseña es una escala numérica que indica la seguridad y complejidad de la contraseña. Un valor de calidad superior indica una contraseña más segura.

• ExchangeActiveSync
• ExchangeAdminCenter
• ExchangeWebServices
• IMAP4
• OfflineAddressBook
• OutlookAnywhere
• OutlookWebApp
• POP3
• PowerShellWebServices
• RemotePowerShell
• REST
• UniversalOutlook (aplicación correo y calendario)

Nota: En Exchange 2019, los únicos valores admitidos son ExchangeAdminCenter y RemotePowerShell.

Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Propiedades de parámetro

Conjuntos de parámetros

-AnyOfSourceTcpPortNumbers

Aplicable: Exchange Server 2013

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-Confirm

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El modificador Confirm especifica si se debe mostrar u ocultar el mensaje de confirmación. Cómo afecta este modificador el cmdlet depende de si el cmdlet requiere confirmación antes de continuar.

• Los cmdlets destructivos (por ejemplo, los cmdlets Remove-*) tienen una pausa integrada que obliga a confirmar el comando antes de continuar. Para estos cmdlets, puede omitir el mensaje de confirmación mediante esta sintaxis exacta: -Confirm:$false.
• La mayoría de los otros cmdlets (por ejemplo, New-* y Set-*) no tienen una pausa integrada. En estos cmdlets, si se especifica el modificador Confirm sin ningún valor, se introduce una pausa que obliga a confirmar el comando antes de continuar.

Propiedades de parámetro

Conjuntos de parámetros

-DomainController

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro DomainController especifica el controlador de dominio que el cmdlet usa para leer datos de Active Directory o escribirlos. El controlador de dominio se identifica por su nombre de dominio completo (FQDN). Por ejemplo, dc01.contoso.com.

Propiedades de parámetro

Conjuntos de parámetros

-Enabled

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Enabled especifica si la regla de acceso de cliente está habilitada o deshabilitada. Los valores válidos para este parámetro son $true o $false.

Propiedades de parámetro

Conjuntos de parámetros

-ExceptAnyOfAuthenticationTypes

Aplicable: Exchange Server 2013, Exchange Server 2016

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-ExceptAnyOfClientIPAddressesOrRanges

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro ExceptAnyOfClientIPAddressesOrRanges especifica una excepción para la regla de acceso de cliente basada en la dirección IPv4 o IPv6 del cliente. Los valores admitidos son:

• Dirección IP única: por ejemplo, 192.168.1.1 o 2001:DB8::2AA:FF:C0A8:640A.
• Intervalo de direcciones IP: por ejemplo, 192.168.0.1-192.168.0.254 o 2001:DB8::2AA:FF:C0A8:640A-2001:DB8::2AA:FF:C0A8:6414.
• Intervalo de direcciones IP de enrutamiento entre dominios sin clase (CIDR): por ejemplo, 192.168.3.1/24 o 2001:DB8::2AA:FF:C0A8:640A/64.

Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Para obtener más información sobre las direcciones IPv6 y la sintaxis, consulte este artículo de Exchange 2013: Conceptos básicos de direcciones IPv6.

Propiedades de parámetro

Conjuntos de parámetros

-ExceptAnyOfProtocols

Aplicable: Exchange Server 2013, Exchange Server 2016

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-ExceptAnyOfSourceTcpPortNumbers

Aplicable: Exchange Server 2013

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-ExceptUserIsMemberOf

Aplicable: Exchange Server 2013

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-ExceptUsernameMatchesAnyOfPatterns

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro ExceptUsernameMatchesAnyOfPatterns especifica una excepción para la regla de acceso de cliente que se basa en el nombre de cuenta del usuario en el formato <Domain>\<UserName> (por ejemplo, contoso.com\jeff). Este parámetro acepta texto y el carácter comodín (*) (por ejemplo, , *jeff*pero no jeff*). Los caracteres que no son alfanuméricos no requieren un carácter de escape.

Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Propiedades de parámetro

Conjuntos de parámetros

-Identity

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Identity especifica la regla de acceso de cliente que quiere modificar. Puede usar cualquier valor que identifique de forma exclusiva la regla de acceso de cliente. Por ejemplo:

• Nombre
• Nombre completo (DN)
• GUID

Propiedades de parámetro

Conjuntos de parámetros

-Name

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Name especifica un nombre exclusivo para la regla de acceso de cliente.

Propiedades de parámetro

Conjuntos de parámetros

-Priority

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Priority especifica un valor de prioridad para la regla de acceso de cliente. Un valor entero inferior indica una prioridad más alta y una regla con mayor prioridad se evalúa antes de una regla con menor prioridad. El valor predeterminado es 1.

Propiedades de parámetro

Conjuntos de parámetros

-Scope

Aplicable: Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro Scope especifica el ámbito de la regla de acceso de cliente. Los valores admitidos son:

• Usuarios: la regla solo se aplica a las conexiones de usuario final.
• Todos: la regla se aplica a todas las conexiones (usuarios finales y aplicaciones de nivel intermedio).

Propiedades de parámetro

Conjuntos de parámetros

-UserIsMemberOf

Aplicable: Exchange Server 2013

Este parámetro está reservado para uso interno de Microsoft.

Propiedades de parámetro

Conjuntos de parámetros

-UsernameMatchesAnyOfPatterns

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro UsernameMatchesAnyOfPatterns especifica una condición para la regla de acceso de cliente que se basa en el nombre de cuenta del usuario en el formato <Domain>\<UserName> (por ejemplo, contoso.com\jeff). Este parámetro acepta texto y el carácter comodín (*) (por ejemplo, , *jeff*pero no jeff*). Los caracteres que no son alfanuméricos no requieren un carácter de escape.

Para especificar varios valores y sobrescribir las entradas existentes, use la siguiente sintaxis: Value1,Value2,...ValueN. Si los valores contienen espacios o necesitan comillas, use la siguiente sintaxis: "Value1","Value2",..."ValueN".

Para agregar o quitar uno o más valores sin afectar las entradas existentes, use la siguiente sintaxis: @{Add="Value1","Value2"...; Remove="Value3","Value4"...}.

Propiedades de parámetro

Conjuntos de parámetros

-UserRecipientFilter

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El parámetro UserRecipientFilter especifica una condición para la regla de acceso de cliente que usa la sintaxis de filtro de OPATH para identificar al usuario en función de un conjunto limitado de propiedades de destinatario. Las reglas de acceso de cliente no admiten la lista completa de propiedades de destinatario disponibles.

Puede usar las siguientes propiedades con este parámetro:

• Ciudad
• Company
• CountryOrRegion (código de país ISO 3166-1 alpha-2).
• CustomAttribute1 a CustomAttribute15
• Departamento
• Oficina
• PostalCode
• StateOrProvince
• StreetAddress

La sintaxis básica de este parámetro es "Property -ComparisonOperator 'Value'":

• La propiedad es una de las propiedades filtrables de la lista anterior (por ejemplo City , o CustomAttribute1).
• ComparisonOperator es un operador de comparación de OPATH (por ejemplo -eq , para igual y -like para la comparación de cadenas). Para obtener más información sobre los operadores de comparación, consulte about_Comparison_Operators.
• Value es el valor de propiedad que se va a buscar. Incluya valores de texto y variables entre comillas simples ('Value' o '$Variable'). Si un valor de variable contiene comillas simples, debe identificar (escape) las comillas simples para expandir la variable correctamente. Por ejemplo, en lugar de '$User', use '$($User -Replace "'","''")'. No incluya enteros ni valores del sistema entre comillas (por ejemplo, use 500, $true, $falseo $null en su lugar).
• Incluya todo el filtro de OPATH entre comillas dobles " ". Si el filtro contiene valores del sistema (por ejemplo, , $true$falseo $null), use comillas simples ' ' en su lugar. Aunque este parámetro es una cadena (no un bloque del sistema), también puede usar llaves { }, pero solo si el filtro no contiene variables.

Por ejemplo:

• "City -eq 'Redmond'"
• "CountryOrRegion -eq 'SG'".

Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo:

• "CustomAttribute1 -eq 'AllowOWA' -and CountryOrRegion -eq AU'"
• "(CountryOrRegion -eq 'US' -and Department -eq 'Sales') -or Department -eq 'Research'".

Para obtener información detallada sobre la sintaxis de filtro de OPATH en Exchange, vea Información adicional sobre la sintaxis de OPATH.

Propiedades de parámetro

Conjuntos de parámetros

-WhatIf

Aplicable: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Server SE

El modificador WhatIf simula las acciones del comando. Puede usar este modificador para ver los cambios que se producirían, pero sin aplicar los cambios. No es necesario especificar un valor con este modificador.

Propiedades de parámetro

Conjuntos de parámetros

CommonParameters

Entradas

Input types

Salidas

Output types