New-SettingOverride

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

Precaución: El uso incorrecto de los cmdlets de invalidación de configuración puede causar daños graves a la organización de Exchange. Este daño podría requerir que vuelva a instalar Exchange. Use solo estos cmdlets como se indica en la documentación del producto o bajo la dirección de Microsoft servicio al cliente y soporte técnico.

Use el cmdlet New-SettingOverride para crear invalidaciones de configuración que almacenen personalizaciones de Exchange en Active Directory en lugar de en archivos de texto en el servidor.

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

New-SettingOverride
   [-Name] <String>
   -Component <String>
   -Parameters <MultiValuedProperty>
   -Reason <String>
   -Section <String>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-MaxVersion <Version>]
   [-MinVersion <Version>]
   [-Server <String[]>]
   [-WhatIf]
   [<CommonParameters>]

Description

La configuración invalida la configuración y el almacenamiento de personalizaciones del servidor Exchange en Active Directory. La configuración puede ser específica de toda la organización o del servidor, y se conservan en Active Directory en todas las Novedades acumulativas (CPU) de Exchange. Las personalizaciones de Exchange en web.config o exe.config archivos de configuración de aplicaciones XML son específicas del servidor y se pierden al instalar la siguiente instancia de Exchange CU.

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

New-SettingOverride -Name "IM Override" -Component OwaServer -Section IMSettings -Parameters @("IMServerName=skype01.contoso.com","IMCertificateThumbprint=CDF34A740E9D225A1A06193A9D44B2CE22775308") -Reason "Configure IM"

En este ejemplo se crea una nueva invalidación de configuración denominada Integración del servidor de MENSAJERÍA INSTANTÁNEA. Esta invalidación especifica el grupo de Skype Empresarial Server 2015 y una huella digital de certificado que permite la integración de mensajería instantánea (MI) entre Outlook en la Web y Skype Empresarial. Dado que no se usa el parámetro Server, la invalidación se aplica a todos los servidores de Exchange 2016 del bosque de Active Directory.

Para obtener más información, vea el tema Configuración de la integración de mensajería instantánea con Outlook en la Web en Exchange 2016.

Ejemplo 2

New-SettingOverride -Name "Change OAB Generation" -Server Mailbox01 -Component TimeBasedAssistants -Section OABGeneratorAssistant -Parameters @("WorkCycle=02:00:00") -Reason "Generate OAB Every 2 hours"

En este ejemplo se crea una nueva invalidación de configuración denominada Cambiar generación de OAB. Esta invalidación especifica un intervalo de generación de OAB de 2 horas. Dado que se usa el parámetro Server, la invalidación solo se aplica al servidor especificado denominado Mailbox01.

Para obtener más información, vea el tema Cambiar la programación de generación de libreta de direcciones sin conexión en Exchange.

Parámetros

-Component

El parámetro Component especifica el componente al que se aplica la invalidación de configuración. Por ejemplo:

  • TimeBasedAssistants
  • OwaServer
Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 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 2013, Exchange Server 2016, Exchange Server 2019

-Force

El modificador Force oculta los mensajes de advertencia o confirmación. No es necesario especificar un valor con este modificador.

Este modificador se puede usar para ejecutar tareas mediante programación en las que no es apropiado solicitar una entrada administrativa.

Type:SwitchParameter
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

-MaxVersion

El parámetro MaxVersion especifica la versión más reciente de Exchange 2016 a la que se aplica esta invalidación (hasta e incluyendo el valor especificado).

La entrada válida para este parámetro es un valor de versión de Exchange 2016 con el formato 15.1.xxx.xx. Se pueden usar valores con ceros a la izquierda, pero en los resultados no aparecerán esos ceros. Por ejemplo, 15.01.0225.042 se almacena como 15.1.225.42.

El valor predeterminado está en blanco ($null), lo que significa que la invalidación se aplica a todas las versiones de Exchange 2016.

Type:Version
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

-MinVersion

El parámetro MinVersion especifica la versión más antigua de Exchange 2016 a la que se aplica esta invalidación (hasta e incluyendo el valor especificado).

La entrada válida para este parámetro es un valor de versión de Exchange 2016 con el formato 15.1.xxx.xx. Se pueden usar valores con ceros a la izquierda, pero en los resultados no aparecerán esos ceros. Por ejemplo, 15.01.0225.042 se almacena como 15.1.225.42.

El valor predeterminado está en blanco ($null), lo que significa que la invalidación se aplica a todas las versiones de Exchange 2016.

Type:Version
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

-Name

El parámetro Name especifica el nombre único de la invalidación de configuración. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:1
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Parameters

El parámetro Parameters especifica uno o varios parámetros para la invalidación que están disponibles para la combinación de los valores de parámetro Component y Section. Este parámetro usa la sintaxis : @("Parameter1=Value1","Parameter2=Value2"...). Por ejemplo:

  • @("Enabled=true")
  • @("IMServerName=<SkypePoolFQDN>","IMCertificateThumbprint=<ThumbprintGUID>")
Type:MultiValuedProperty
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Reason

El parámetro Reason especifica por qué está creando la invalidación de configuración. Si el valor contiene espacios, escriba el valor entre comillas (").

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Section

El parámetro Section especifica el nombre de la sección para la que se crea la invalidación. Los valores disponibles para este parámetro dependen del valor del parámetro Component.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Server

El parámetro Server especifica el nombre del servidor de Exchange 2016 donde desea aplicar la invalidación. Puede especificar un único nombre de servidor de Exchange 2016 o una matriz de caracteres comodín de nombre de servidor de Exchange 2016. Por ejemplo, si tiene tres servidores de Exchange 2016 denominados Exchange01, Exchange02 y Exchange03, especifique el valor Exchange* para aplicar la invalidación a todos ellos.

Si no usa este parámetro para especificar un servidor, la invalidación se aplica a todos los servidores de Exchange 2016 del bosque de Active Directory.

Type:String[]
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

-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 2013, Exchange Server 2016, Exchange Server 2019