Compartir a través de


Set-ExchangeSettings

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

Use el cmdlet Set-ExchangeSettings para configurar los objetos de configuración de Exchange que creó con el cmdlet New-ExchangeSettings.

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-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-ClearHistory]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ConfigName <String>
   -ConfigValue <String>
   -Reason <String>
   [-UpdateSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ConfigName <String>
   -Reason <String>
   [-RemoveSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ExpirationDate <DateTime>
   -Reason <String>
   [-ConfigPairs <String[]>]
   [-Confirm]
   [-CreateSettingsGroup]
   [-Disable]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-MaxVersion <String>]
   [-MinVersion <String>]
   [-NameMatch <String>]
   [-Priority <Int32>]
   [-Scope <ExchangeSettingsScope>]
   [-ScopeFilter <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ExpirationDate <DateTime>
   -GuidMatch <Guid>
   -Reason <String>
   [-ConfigPairs <String[]>]
   [-Confirm]
   [-CreateSettingsGroup]
   [-Disable]
   [-DomainController <Fqdn>]
   [-Force]
   [-GroupName <String>]
   [-Priority <Int32>]
   [-Scope <ExchangeSettingsScope>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -SettingsGroup <String>
   [-CreateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -ExpirationDate <DateTime>
   -Reason <String>
   [-CreateSettingsGroup]
   [-ConfigPairs <String[]>]
   [-GenericScopeName <String>]
   [-GenericScopeValue <String>]
   [-GroupName <String>]
   [-Confirm]
   [-Disable]
   [-DomainController <Fqdn>]
   [-Force]
   [-Priority <Int32>]
   [-Scope <ExchangeSettingsScope>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-ExpirationDate <DateTime>]
   [-GroupName <String>]
   [-UpdateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-Priority <Int32>]
   [-ScopeFilter <String>]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -ConfigPairs <String[]>
   [-GroupName <String>]
   [-RemoveSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-GroupName <String>]
   [-RemoveSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -SettingsGroup <String>
   [-UpdateSettingsGroup]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   -ConfigPairs <String[]>
   [-GroupName <String>]
   [-UpdateSetting]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-WhatIf]
   [<CommonParameters>]
Set-ExchangeSettings
   [-Identity] <ExchangeSettingsIdParameter>
   -Reason <String>
   [-EnableGroup <String>]
   [-DisableGroup <String>]
   [-Confirm]
   [-DomainController <Fqdn>]
   [-Force]
   [-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-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"

Este ejemplo permite a los usuarios ver los resultados del registro de auditoría unificado. En este ejemplo se supone que ya ha creado un objeto de configuración de Exchange para el esquema de configuración auditar mediante la ejecución del comando New-ExchangeSettings -Name Audit.

Parámetros

-ClearHistory

El modificador ClearHistory especifica que desea borrar las entradas del historial de modificaciones del objeto de configuración de Exchange. No es necesario especificar un valor con este modificador.

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

-ConfigName

El parámetro ConfigName especifica la configuración de Exchange disponible que desea agregar, quitar o actualizar en el objeto de configuración de Exchange. Los valores válidos para este parámetro vienen determinados por el esquema de configuración especificado por el parámetro Name en el cmdlet New-ExchangeSettings.

Para las operaciones de adición y actualización, también debe usar el parámetro ConfigValue para especificar el valor real de la configuración. No puede usar el parámetro ConfigName con el parámetro ConfigPairs.

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

-ConfigPairs

El parámetro ConfigName especifica la configuración de Exchange disponible que desea agregar, quitar o actualizar en el objeto de configuración de Exchange. Los valores válidos para este parámetro vienen determinados por el esquema de configuración especificado por el parámetro Name en el cmdlet New-ExchangeSettings. La sintaxis de un valor es <Key>=<Value>. Puede separar varios valores separados por comas.

No se puede usar el parámetro ConfigPairs con los parámetros ConfigName o ConfigValue.

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

-ConfigValue

El parámetro ConfigValue especifica el valor de la configuración de Exchange que especificó con el parámetro ConfigName. Los valores vienen determinados por el tipo de configuración (un número, un intervalo de tiempo, $true o $false, etc.).

No puede usar el parámetro ConfigValue con el parámetro ConfigPairs.

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

-CreateSettingsGroup

El modificador CreateSettingsGroup especifica que va a crear un grupo de configuración de Exchange, que es un grupo de configuraciones de Exchange relacionadas. No es necesario especificar un valor con este modificador.

En función de cómo quiera configurar el grupo de opciones, use el parámetro GroupName o el parámetro SettingsGroup para especificar el nombre del grupo de configuración de Exchange. Elija cuidadosamente, ya que no puede cambiar el nombre de un grupo de configuración existente.

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

-Disable

El modificador Deshabilitar especifica que el grupo de configuración de Exchange está deshabilitado. No es necesario especificar un valor con este modificador.

Solo puede usar este modificador con el modificador CreateSettingsGroup.

Para usar este modificador para habilitar un grupo de configuración de Exchange, use esta sintaxis -Disable:$falseexacta .

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

-DisableGroup

El parámetro DisableGroup especifica el nombre del grupo de configuración de Exchange habilitado que desea deshabilitar. Si el valor contiene espacios, escriba el valor entre comillas (").

Puede usar los parámetros DisableGroup y EnableGroup juntos en el mismo comando para habilitar y deshabilitar diferentes grupos de configuración de Exchange al mismo tiempo.

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

-EnableGroup

El parámetro EnableGroup especifica el nombre del grupo de configuración de Exchange deshabilitado que desea habilitar. Si el valor contiene espacios, escriba el valor entre comillas (").

Puede usar los parámetros DisableGroup y EnableGroup juntos en el mismo comando para habilitar y deshabilitar diferentes grupos de configuración de Exchange al mismo tiempo.

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

-ExpirationDate

El parámetro ExpirationDate especifica la fecha y hora de finalización de la configuración de Exchange definida por el grupo de configuración de Exchange especificado.

Use el formato de fecha corta que se define en la opción Configuración regional en el equipo en el que se ejecuta el comando. Por ejemplo, si el equipo está configurado para usar el formato de fecha corta mm/dd/yyyy, escriba 09/01/2018 para especificar el 1 de septiembre de 2018. Puede escribir solo la fecha, o la fecha y la hora del día. Si escribe la fecha y la hora del día, encierre el valor entre comillas ("), por ejemplo, "01/09/2018 5:00 PM".

Solo puede usar el parámetro ExpirationDate con los parámetros de grupo CreateSettingsGroup o UpdateSettings.

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

-GenericScopeName

El parámetro GenericScopeName especifica el nombre del ámbito. Los valores disponibles vienen determinados por el esquema del objeto de configuración de Exchange.

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

-GenericScopeValue

El parámetro GenericScopeValue especifica el valor del ámbito especificado por el parámetro GenericScopeName. Los valores disponibles vienen determinados por el esquema del objeto de configuración de Exchange.

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

-GroupName

El parámetro GroupName especifica el nombre del grupo de configuración de Exchange en las operaciones de grupo. Por ejemplo:

  • Cree grupos de configuración de Exchange y configure simultáneamente el ámbito y la prioridad del grupo.
  • Modifique los valores ExpirationDate, Priority y ScopeFilter de los grupos de configuración de Exchange existentes.
  • Quite los grupos de configuración de Exchange existentes.
  • Agregue, quite o actualice objetos de configuración de Exchange en grupos de configuración de Exchange existentes.

Si el valor contiene espacios, escriba el valor entre comillas (").

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

-GuidMatch

El parámetro GuidMatch especifica el ámbito de un grupo de configuración de Exchange en función del GUID del objeto (por ejemplo, el GUID de la base de datos de buzones). Este parámetro está disponible para su uso con todos los valores de parámetro Scope distintos de Forest.

El parámetro GuidMatch solo se usa al crear grupos de configuración de Exchange mediante el modificador CreateSettingsGroup con el parámetro GroupName.

No se puede usar este parámetro con los parámetros GenericScopeName, GenericScopeValue, MaxVersion, MinVersion o NameMatch.

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

-Identity

El parámetro Identity especifica el nombre del objeto de configuración de Exchange existente que contiene la configuración de Exchange que desea configurar.

El valor de este parámetro es el valor del parámetro Name en el cmdlet New-ExchangeSetting cuando se creó el objeto de configuración de Exchange.

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

-MaxVersion

El parámetro MaxVersion especifica el ámbito de un grupo de configuración de Exchange en función de la versión del objeto (por ejemplo, la versión de Exchange instalada en el servidor). Este parámetro está disponible para su uso con todos los valores de parámetro Scope distintos de Forest.

El parámetro MaxVersion se usa junto con el parámetro MinVersion solo cuando se crean grupos de configuración de Exchange mediante el modificador CreateSettingsGroup con el parámetro GroupName.

No se puede usar este parámetro con los parámetros GuidMatch, GenericScopeName o GenericScopeValue.

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

-MinVersion

El parámetro MinVersion especifica el ámbito de un grupo de configuración de Exchange en función de la versión del objeto (por ejemplo, la versión de Exchange instalada en el servidor). Este parámetro está disponible para su uso con todos los valores de parámetro Scope distintos de Forest.

El parámetro MinVersion se usa junto con el parámetro MaxVersion solo cuando se crean grupos de configuración de Exchange mediante el modificador CreateSettingsGroup con el parámetro GroupName.

No se puede usar este parámetro con los parámetros GuidMatch, GenericScopeName o GenericScopeValue.

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

-NameMatch

El parámetro NameMatch especifica el ámbito de un grupo de configuración de Exchange en función del nombre del objeto (por ejemplo, el nombre del proceso). Este parámetro está disponible para su uso con todos los valores de parámetro Scope distintos de Forest.

El parámetro NameMatch solo se usa al crear grupos de configuración de Exchange mediante el modificador CreateSettingsGroup con el parámetro GroupName.

No se puede usar este parámetro con los parámetros GuidMatch, GenericScopeName o GenericScopeValue.

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

-Priority

El parámetro Priority especifica la prioridad de un grupo de configuración de Exchange. El valor de prioridad de cada grupo debe ser único. Un valor de prioridad inferior indica una prioridad más alta.

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

-Reason

El parámetro Reason especifica una descripción del motivo por el que se creó o modificó el grupo de configuración o configuración de Exchange. 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 2016, Exchange Server 2019

-RemoveSetting

El modificador RemoveSetting especifica que va a quitar una configuración de Exchange existente de un objeto de configuración de Exchange. No es necesario especificar un valor con este modificador.

Use el parámetro ConfigPairs o el parámetro ConfigName para especificar la configuración que desea quitar.

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

-RemoveSettingsGroup

El modificador RemoveSettingsGroup especifica que se va a quitar un grupo de configuración de Exchange. No es necesario especificar un valor con este modificador.

Use el parámetro GroupName para especificar el grupo de configuración de Exchange que desea quitar.

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

-Scope

El parámetro Scope especifica el ámbito del objeto de configuración de Exchange. Los valores admitidos son:

  • Dag
  • Base de datos
  • Bosque
  • Generic
  • Organización
  • Proceso
  • Servidor
  • User
Type:ExchangeSettingsScope
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2016, Exchange Server 2019

-ScopeFilter

El parámetro ScopeFilter usa la sintaxis de filtro OPATH para especificar el ámbito de un grupo de configuración de Exchange basado en. La sintaxis es "Property -ComparisonOperator 'Value'" (por ejemplo, "ServerRole -like 'Mailbox*'").

  • 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.
  • La propiedad es una propiedad filtrable.
  • 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).

Puede encadenar varios criterios de búsqueda mediante los operadores lógicos -and y -or. Por ejemplo, "Criteria1 -and Criteria2" o "(Criteria1 -and Criteria2) -or Criteria3".

Para obtener información detallada sobre los filtros de OPATH en Exchange, consulte Información adicional de la sintaxis de OPATH.

No puede usar este parámetro con el parámetro Scope y el valor Forest u otros parámetros relacionados con el ámbito.

Este parámetro solo se usa al actualizar los grupos de configuración de Exchange mediante el modificador UpdateSettingsGroup con el parámetro GroupName.

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

-SettingsGroup

El parámetro SettingsGroup especifica un grupo de configuración de Exchange existente que se usa para crear un nuevo grupo de configuración o modificar un grupo de configuración existente.

No puede usar el parámetro SettingsGroup con el parámetro GroupName.

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

-UpdateSetting

El modificador UpdateSetting especifica que va a actualizar una configuración de Exchange en un objeto de configuración de Exchange existente. No es necesario especificar un valor con este modificador.

Use el parámetro ConfigPairs o los parámetros ConfigName y ConfigValue para configurar la configuración de Exchange.

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

-UpdateSettingsGroup

El modificador UpdateSettingsGroup especifica que va a modificar un grupo de configuración de Exchange. No es necesario especificar un valor con este modificador.

En función de cómo quiera configurar el grupo de opciones, use el parámetro GroupName o el parámetro SettingsGroup para especificar el grupo de configuración de Exchange que desea modificar.

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