Compartir a través de


Set-ClientAccessServer

Este cmdlet solo está disponible en el entorno local de Exchange.

Use el cmdlet Set-ClientAccessServer para modificar la configuración asociada al rol de servidor de acceso de cliente.

Nota: En Exchange 2013 o posterior, use el cmdlet Set-ClientAccessService en su lugar. Si tiene scripts que usan Set-ClientAccessServer, actualícelos para que usen Set-ClientAccessService.

Para obtener más información acerca de los conjuntos de parámetros de la sección Sintaxis a continuación, vea Sintaxis del cmdlet de Exchange.

Sintaxis

AlternateServiceAccount

Set-ClientAccessServer
    [-Identity] <ClientAccessServerIdParameter>
    [-AlternateServiceAccountCredential <PSCredential[]>]
    [-CleanUpInvalidAlternateServiceAccountCredentials]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IrmLogEnabled <Boolean>]
    [-IrmLogMaxAge <EnhancedTimeSpan>]
    [-IrmLogMaxDirectorySize <Unlimited>]
    [-IrmLogMaxFileSize <ByteQuantifiedSize>]
    [-IrmLogPath <LocalLongFullPath>]
    [-IsOutOfService <Boolean>]
    [-RemoveAlternateServiceAccountCredentials]
    [-WhatIf]
    [<CommonParameters>]

Identity

Set-ClientAccessServer
    [-Identity] <ClientAccessServerIdParameter>
    [-Array <ClientAccessArrayIdParameter>]
    [-AutoDiscoverServiceInternalUri <Uri>]
    [-AutoDiscoverSiteScope <MultiValuedProperty>]
    [-Confirm]
    [-DomainController <Fqdn>]
    [-IrmLogEnabled <Boolean>]
    [-IrmLogMaxAge <EnhancedTimeSpan>]
    [-IrmLogMaxDirectorySize <Unlimited>]
    [-IrmLogMaxFileSize <ByteQuantifiedSize>]
    [-IrmLogPath <LocalLongFullPath>]
    [-IsOutOfService <Boolean>]
    [-WhatIf]
    [<CommonParameters>]

Description

Deberá tener asignados permisos antes de poder ejecutar este cmdlet. Aunque en este artículo se enumeran todos los parámetros del cmdlet, es posible que no tenga acceso a algunos parámetros si no se incluyen en los permisos que se le asignan. Para obtener los permisos necesarios para ejecutar cualquier cmdlet o parámetro en su organización, consulte Find the permissions required to run any Exchange cmdlet.

Ejemplos

Ejemplo 1

Set-ClientAccessServer -Identity "MBX-01" -AutoDiscoverServiceInternalUri "https://mbx01.contoso.com/autodiscover/autodiscover.xml" -AutoDiscoverSiteScope "Mail"

En este ejemplo se configura la dirección URL de detección automática interna para el sitio de Active Directory denominado Mail en los servicios de acceso de cliente del servidor denominado MBX-01.

Parámetros

-AlternateServiceAccountCredential

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

El parámetro AlternateServiceAccountCredential especifica un nombre de usuario y una contraseña de cuenta de servicio alternativos que se usan normalmente para la autenticación Kerberos en Exchange Server entornos de coexistencia de 2010. Puede especificar distintos valores separados por comas.

Un valor para este parámetro requiere el cmdlet Get-Credential. Para pausar este comando y recibir una solicitud de credenciales, use el valor (Get-Credential). O bien, antes de ejecutar este comando, almacene las credenciales en una variable (por ejemplo, $cred = Get-Credential) y, a continuación, use el nombre de variable ($cred) para este parámetro. Para más información, vea Get-Credential.

Propiedades del parámetro

Tipo:

PSCredential[]

Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AlternateServiceAccount
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Array

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

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

Propiedades del parámetro

Tipo:ClientAccessArrayIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AutoDiscoverServiceInternalUri

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

El parámetro AutoDiscoverServiceInternalUri especifica la dirección URL interna del servicio de detección automática.

Propiedades del parámetro

Tipo:Uri
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-AutoDiscoverSiteScope

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

El parámetro AutoDiscoverSiteScope especifica el sitio de Active Directory para el que el servicio de detección automática es autoritativo. Los clientes que se conectan al servicio de detección automática mediante la dirección URL interna tienen que existir en el sitio especificado.

Para ver los sitios de Active Directory disponibles, use el cmdlet Get-ADSite.

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

Propiedades del parámetro

Tipo:MultiValuedProperty
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

Identity
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-CleanUpInvalidAlternateServiceAccountCredentials

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

El parámetro CleanUpInvalidAlternateServiceAccountCredentials especifica si se quita una cuenta de servicio alternativa configurada anteriormente que ya no es válida. No es necesario especificar un valor con este modificador.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AlternateServiceAccount
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Confirm

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

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 del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:cf

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-DomainController

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

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 del parámetro

Tipo:Fqdn
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-Identity

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

El parámetro Identity especifica el servidor que desea modificar. Puede usar cualquier valor que identifique de forma exclusiva el servidor. Por ejemplo:

  • Nombre
  • Nombre distintivo (DN)
  • FQDN
  • GUID

Propiedades del parámetro

Tipo:ClientAccessServerIdParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:1
Mandatory:True
Valor de la canalización:True
Valor de la canalización por nombre de propiedad:True
Valor de los argumentos restantes:False

-IrmLogEnabled

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro IrmLogEnabled especifica si el registro está habilitado para Information Rights Management (IRM). Los valores válidos son $true o $false. El valor predeterminado es $true.

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IrmLogMaxAge

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro IrmLogMaxAge especifica la antigüedad máxima de los registros de IRM. Los registros anteriores al valor especificado se eliminan.

Para especificar un valor, especifíquelo como un intervalo de tiempo: dd.hh:mm:ss en el que d = días, h = horas, m = minutos y s = segundos.

Por ejemplo, para especificar un intervalo de 15 horas, escriba 15:00:00. El valor predeterminado es 30 días (30.00:00:00).

Propiedades del parámetro

Tipo:EnhancedTimeSpan
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IrmLogMaxDirectorySize

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro IrmLogMaxDirectorySize especifica el tamaño máximo del directorio para los registros IRM. Cuando se alcanza el tamaño máximo del directorio, el servidor elimina primero los archivos de registro antiguos.

Un valor válido es un número de hasta 909,5 terabytes (999999999999999 bytes) o el valor unlimited. El valor predeterminado es de 250 megabytes (262144000 bytes).

Cuando especifique un valor, califíquelo con una de las siguientes unidades:

  • B (bytes)
  • KB (kilobytes)
  • MB (megabytes)
  • GB (gigabytes)
  • TB (terabytes)

Normalmente, los valores no calificados se tratan como bytes, pero los valores pequeños se pueden redondear hasta el kilobyte más cercano.

Propiedades del parámetro

Tipo:Unlimited
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IrmLogMaxFileSize

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro IrmLogMaxFileSize especifica el tamaño máximo del registro IRM. Este valor no puede ser mayor que el valor del parámetro IrmLogMaxDirectorySize.

Un valor válido es un número de hasta 4 gigabytes (4294967296 bytes). El valor predeterminado es de 10 megabytes (10485760 bytes).

Cuando especifique un valor, califíquelo con una de las siguientes unidades:

  • B (bytes)
  • KB (kilobytes)
  • MB (megabytes)
  • GB (gigabytes)

Normalmente, los valores no calificados se tratan como bytes, pero los valores pequeños se pueden redondear hasta el kilobyte más cercano.

El valor de este parámetro debe ser inferior o igual que el valor del parámetro ReceiveProtocolLogMaxDirectorySize.

Propiedades del parámetro

Tipo:ByteQuantifiedSize
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IrmLogPath

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

El parámetro IrmLogPath especifica la ubicación de los archivos de registro de IRM. La ubicación predeterminada es %ExchangeInstallPath%Logging\IRMLogs.

Si establece el valor de este parámetro en $null, se deshabilita de forma efectiva el registro de IRM. Sin embargo, si el valor del parámetro IrmLogEnabled es $true, Exchange agrega errores al registro de eventos application. La mejor manera de deshabilitar el registro de IRM es establecer el parámetro IrmLogEnabled en $false.

Propiedades del parámetro

Tipo:LocalLongFullPath
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-IsOutOfService

Aplicable: Exchange Server 2010

Este parámetro solo está disponible en Exchange Server 2010.

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

Propiedades del parámetro

Tipo:Boolean
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-RemoveAlternateServiceAccountCredentials

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

El parámetro RemoveAlternateServiceAccountCredentials especifica si se quita una cuenta de servicio alternativa distribuida anteriormente. No es necesario especificar un valor con este modificador.

Propiedades del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False

Conjuntos de parámetros

AlternateServiceAccount
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

-WhatIf

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

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 del parámetro

Tipo:SwitchParameter
Valor predeterminado:None
Admite caracteres comodín:False
DontShow:False
Alias:Wi

Conjuntos de parámetros

(All)
Posición:Named
Mandatory:False
Valor de la canalización:False
Valor de la canalización por nombre de propiedad:False
Valor de los argumentos restantes:False

CommonParameters

Este cmdlet admite los parámetros comunes: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction y -WarningVariable. Para más información, consulte about_CommonParameters.

Entradas

Input types

Para ver los tipos de entrada que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de entrada de un cmdlet está en blanco, el cmdlet no acepta datos de entrada.

Salidas

Output types

Para ver los tipos de valor devuelto (también conocidos como tipos de resultado) que acepta este cmdlet, consulte Tipos de entrada y salida de cmdlet. Si el campo Tipo de resultado está en blanco, el cmdlet no devuelve datos.