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:$false
exacta .
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
$false
o$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, use500
,$true
,$false
o$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 |