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 usar 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.
Syntax
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>]
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 tema se enumeran todos los parámetros correspondientes a este cmdlet, tal vez no tenga acceso a algunos parámetros si no están incluidos en los permisos que se le han asignado. 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
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.
Type: | PSCredential[] |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Array
Este parámetro está reservado para uso interno de Microsoft.
Type: | ClientAccessArrayIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AutoDiscoverServiceInternalUri
El parámetro AutoDiscoverServiceInternalUri especifica la dirección URL interna del servicio de detección automática.
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-AutoDiscoverSiteScope
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"
.
Type: | MultiValuedProperty |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-CleanUpInvalidAlternateServiceAccountCredentials
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.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Confirm
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, 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 demás cmdlets (por ejemplo, los cmdlets 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.
Type: | SwitchParameter |
Aliases: | cf |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-DomainController
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.
Type: | Fqdn |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
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
Type: | ClientAccessServerIdParameter |
Position: | 1 |
Default value: | None |
Required: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-IrmLogEnabled
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.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogMaxAge
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).
Type: | EnhancedTimeSpan |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogMaxDirectorySize
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)
Los valores sin calificar normalmente se tratan como bytes, pero los valores pequeños se pueden redondear al kilobyte más cercano.
Type: | Unlimited |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogMaxFileSize
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)
Los valores sin calificar normalmente se tratan como bytes, pero los valores pequeños se pueden redondear al kilobyte más cercano.
El valor de este parámetro debe ser inferior o igual que el valor del parámetro ReceiveProtocolLogMaxDirectorySize.
Type: | ByteQuantifiedSize |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IrmLogPath
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.
Type: | LocalLongFullPath |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-IsOutOfService
Este parámetro solo está disponible en Exchange Server 2010.
Este parámetro está reservado para uso interno de Microsoft.
Type: | Boolean |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010 |
-RemoveAlternateServiceAccountCredentials
El parámetro RemoveAlternateServiceAccountCredentials especifica si se quita una cuenta de servicio alternativa distribuida anteriormente. No es necesario especificar un valor con este modificador.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-WhatIf
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.
Type: | SwitchParameter |
Aliases: | wi |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
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.