Set-ExchangeSettings
此 cmdlet 仅适用于本地 Exchange。
使用 Set-ExchangeSettings cmdlet 配置使用 New-ExchangeSettings cmdlet 创建的 Exchange 设置对象。
有关以下语法部分的参数设置的详细信息,请参阅 Exchange cmdlet 语法。
语法
ClearHistory
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
[-ClearHistory]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
UpdateSetting
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-ConfigName <String>
-ConfigValue <String>
-Reason <String>
[-UpdateSetting]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-GroupName <String>]
[-WhatIf]
[<CommonParameters>]
RemoveSetting
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-ConfigName <String>
-Reason <String>
[-RemoveSetting]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-GroupName <String>]
[-WhatIf]
[<CommonParameters>]
CreateSettingsGroup
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>]
CreateSettingsGroupGuid
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>]
CreateSettingsGroupAdvanced
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
-SettingsGroup <String>
[-CreateSettingsGroup]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
CreateSettingsGroupGeneric
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>]
UpdateSettingsGroup
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
[-ExpirationDate <DateTime>]
[-GroupName <String>]
[-UpdateSettingsGroup]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-Priority <Int32>]
[-ScopeFilter <String>]
[-WhatIf]
[<CommonParameters>]
RemoveMultipleSettings
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
-ConfigPairs <String[]>
[-GroupName <String>]
[-RemoveSetting]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
RemoveSettingsGroup
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
[-GroupName <String>]
[-RemoveSettingsGroup]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
UpdateSettingsGroupAdvanced
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
-SettingsGroup <String>
[-UpdateSettingsGroup]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
UpdateMultipleSettings
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
-ConfigPairs <String[]>
[-GroupName <String>]
[-UpdateSetting]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
EnableSettingsGroup
Set-ExchangeSettings
[-Identity] <ExchangeSettingsIdParameter>
-Reason <String>
[-EnableGroup <String>]
[-DisableGroup <String>]
[-Confirm]
[-DomainController <Fqdn>]
[-Force]
[-WhatIf]
[<CommonParameters>]
说明
您必须先获得权限,然后才能运行此 cmdlet。 尽管本文列出了 cmdlet 的所有参数,但如果分配给你的权限中未包含某些参数,则可能无权访问这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限,请参阅 Find the permissions required to run any Exchange cmdlet。
示例
示例 1
Set-ExchangeSettings Audit -UpdateSetting -ConfigName AuditLogPumperEnabled -ConfigValue $true -Reason "Enable Unified Audit Logging"
此示例允许用户查看统一审核日志记录的结果。 此示例假定你已通过运行命令 New-ExchangeSettings -Name Audit 为审核配置架构创建了一个 Exchange 设置对象。
参数
-ClearHistory
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ClearHistory 开关指定要清除 Exchange 设置对象的修改历史记录中的条目。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ClearHistory
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ConfigName
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ConfigName 参数指定要在 Exchange 设置对象中添加、删除或更新的可用 Exchange 设置。 此参数的有效值由 New-ExchangeSettings cmdlet 上的 Name 参数指定的配置架构确定。
对于添加和更新操作,还需要使用 ConfigValue 参数指定设置的实际值。 不能将 ConfigName 参数与 ConfigPairs 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UpdateSetting
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
RemoveSetting
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ConfigPairs
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ConfigName 参数指定要在 Exchange 设置对象中添加、删除或更新的可用 Exchange 设置。 此参数的有效值由 New-ExchangeSettings cmdlet 上的 Name 参数指定的配置架构确定。 值的语法是 <Key>=<Value>。 可以以逗号分隔多个值。
不能将 ConfigPairs 参数与 ConfigName 或 ConfigValue 参数一起使用。
参数属性
| 类型: | String[] |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
RemoveMultipleSettings
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateMultipleSettings
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ConfigValue
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ConfigValue 参数指定使用 ConfigName 参数指定的 Exchange 设置的值。 这些值由设置类型决定 (数字、时间跨度、$true或$false等 ) 。
不能将 ConfigValue 参数与 ConfigPairs 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UpdateSetting
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Confirm
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 有何影响取决于 cmdlet 在继续操作前是否需要确认。
- 破坏性 cmdlet(例如 Remove-* cmdlets)内置有暂停,可强制要求先确认命令,然后再继续操作。 对于这些 cmdlet,您可以使用此确切语法跳过确认提示:
-Confirm:$false。 - 其他大多数 cmdlet(例如 New-* 和 Set-* cmdlet)都没有内置暂停。 对于这些 cmdlet,在不带值的情况下指定“确认”开关会引入一个暂停,从而强制你在继续之前确认命令。
此 cmdlet 具有内置的暂停,因此请跳 -Confirm:$false 过确认。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | cf |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-CreateSettingsGroup
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
CreateSettingsGroup 开关指定要创建 Exchange 设置组,该组是一组相关的 Exchange 设置。 不必为此开关指定值。
根据要配置设置组的方式,可以使用 GroupName 参数或 SettingsGroup 参数指定 Exchange 设置组的名称。 请谨慎选择,因为无法重命名现有设置组。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupAdvanced
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Disable
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
禁用开关指定禁用 Exchange 设置组。 不必为此开关指定值。
只能将此开关与 CreateSettingsGroup 开关一起使用。
要使用此开关启用 Exchange 设置组,请使用此确切语法 -Disable:$false。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DisableGroup
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DisableGroup 参数指定要禁用的已启用 Exchange 设置组的名称。 如果值中有空格,请使用双引号 (") 将此值括起来。
可以在同一命令中结合使用 DisableGroup 和 EnableGroup 参数,以同时启用和禁用不同的 Exchange 设置组。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EnableSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-DomainController
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如,dc01.contoso.com。
参数属性
| 类型: | Fqdn |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-EnableGroup
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
EnableGroup 参数指定要启用的已禁用 Exchange 设置组的名称。 如果值中有空格,请使用双引号 (") 将此值括起来。
可以在同一命令中结合使用 DisableGroup 和 EnableGroup 参数,以同时启用和禁用不同的 Exchange 设置组。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EnableSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ExpirationDate
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ExpirationDate 参数指定由指定的 Exchange 设置组定义的 Exchange 设置的结束日期/时间。
请使用短日期格式,该格式在运行命令的计算机上的“区域选项”设置中定义。 例如,如果计算机配置为使用短日期格式 MM/dd/yyyy,请输入 09/01/2018 以指定 2018 年 9 月 1 日。 可以只输入日期,也可以输入当天的日期和时间。 如果输入当天的日期和时间,请将该值括在引号 (") 中,例如,"09/01/2018 5:00 PM"。
只能将 ExpirationDate 参数与 CreateSettingsGroup 或 UpdateSettings 组参数一起使用。
参数属性
| 类型: | DateTime |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateSettingsGroup
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Force
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Force 开关会隐藏警告或确认消息。 不必为此开关指定值。
您可以在以编程方式运行任务时使用此开关,因为此时并不适合提示用户提供管理输入。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-GenericScopeName
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GenericScopeName 参数指定作用域的名称。 可用值由 Exchange 设置对象的架构确定。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-GenericScopeValue
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GenericScopeValue 参数指定 GenericScopeName 参数指定的范围的值。 可用值由 Exchange 设置对象的架构确定。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-GroupName
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GroupName 参数指定组操作中 Exchange 设置组的名称。 例如:
- 创建 Exchange 设置组,同时配置组范围和优先级。
- 修改现有 Exchange 设置组的 ExpirationDate、Priority 和 ScopeFilter 值。
- 删除现有 Exchange 设置组。
- 添加、删除或更新现有 Exchange 设置组中的 Exchange 设置对象。
如果值中有空格,请使用双引号 (") 将此值括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UpdateSetting
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
RemoveSetting
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
RemoveMultipleSettings
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
RemoveSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateMultipleSettings
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-GuidMatch
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
GuidMatch 参数基于对象 (的 GUID 指定 Exchange 设置组的范围,例如邮箱数据库) 的 GUID。 此参数可与除“林”以外的所有 Scope 参数值一起使用。
仅当通过结合使用 CreateSettingsGroup 开关和 GroupName 参数来创建 Exchange 设置组时,才能使用 GuidMatch 参数。
不能将此参数与 GenericScopeName、GenericScopeValue、MaxVersion、MinVersion 或 NameMatch 参数一起使用。
参数属性
| 类型: | Guid |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Identity
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
标识参数指定包含要配置的 Exchange 设置的现有 Exchange 设置对象的名称。
此参数的值是创建 Exchange 设置对象时 New-ExchangeSetting cmdlet 上的“名称”参数的值。
参数属性
| 类型: | ExchangeSettingsIdParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | 1 |
| 必需: | True |
| 来自管道的值: | True |
| 来自管道的值(按属性名称): | True |
| 来自剩余参数的值: | False |
-MaxVersion
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MaxVersion 参数根据对象版本指定 Exchange 设置组的范围 (例如,服务器) 上安装的 Exchange 版本。 此参数可与除“林”以外的所有 Scope 参数值一起使用。
仅当使用带有 GroupName 参数的 CreateSettingsGroup 开关创建 Exchange 设置组时,才能将 MaxVersion 参数与 MinVersion 参数一起使用。
不能将此参数与 GuidMatch、GenericScopeName 或 GenericScopeValue 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-MinVersion
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
MinVersion 参数根据对象版本指定 Exchange 设置组的范围 (例如,服务器) 上安装的 Exchange 版本。 此参数可与除“林”以外的所有 Scope 参数值一起使用。
仅当将 MinVersion 参数与 MaxVersion 参数一起使用时,应将 CreateSettingsGroup 开关与 GroupName 参数结合使用。
不能将此参数与 GuidMatch、GenericScopeName 或 GenericScopeValue 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-NameMatch
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
NameMatch 参数根据对象的名称指定 Exchange 设置组的范围 (例如进程名称) 。 此参数可与除“林”以外的所有 Scope 参数值一起使用。
仅当结合使用 CreateSettingsGroup 开关和 GroupName 参数创建 Exchange 设置组时,才能使用 NameMatch 参数。
不能将此参数与 GuidMatch、GenericScopeName 或 GenericScopeValue 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Priority
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
优先级参数指定 Exchange 设置组的优先级。 每个组的优先级值必须是唯一的。 较低的优先级值表示较高的优先级。
参数属性
| 类型: | Int32 |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Reason
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
“原因”参数指定创建或修改 Exchange 设置或设置组的原因的说明。 如果值中有空格,请使用双引号 (") 将此值括起来。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RemoveSetting
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
RemoveSetting 开关指定要从 Exchange 设置对象中删除现有 Exchange 设置。 不必为此开关指定值。
使用 ConfigPairs 参数或 ConfigName 参数指定要删除的设置。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
RemoveSetting
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
RemoveMultipleSettings
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-RemoveSettingsGroup
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
RemoveSettingsGroup 开关指定要删除 Exchange 设置组。 不必为此开关指定值。
使用 GroupName 参数指定要删除的 Exchange 设置组。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
RemoveSettingsGroup
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-Scope
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
Scope 参数指定 Exchange 设置对象的范围。 有效值包含:
- Dag
- Database
- 林
- Generic
- 组织
- 流程
- 服务器
- 用户
参数属性
| 类型: | ExchangeSettingsScope |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGuid
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CreateSettingsGroupGeneric
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-ScopeFilter
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
ScopeFilter 参数使用 OPATH 筛选器语法指定基于 Exchange 设置组的范围。 语法 (例如 "Property -ComparisonOperator 'Value'" , "ServerRole -like 'Mailbox*'") 。
- 请用双引号“ ”括住整个 OPATH 筛选器。 如果筛选器包含系统值 (例如
$true、 或$false$null) ,请改用单引号 ' '。 尽管此参数是字符串 (而不是系统块) ,但您也可以使用大括号 { },但前提是筛选器不包含变量。 - 属性是可筛选的属性。
- ComparisonOperator 是一个 OPATH 比较运算符 (例如
-eq,对于等值和-like字符串比较) 。 有关比较运算符的详细信息,请参阅 about_Comparison_Operators。 - 值是要搜索的属性值。 请将文本值和变量括在单引号 (
'Value'或'$Variable') 中。 如果变量值包含单引号,则需要标识单引号 (转义) 正确展开变量。 例如,'$User'使用'$($User -Replace "'","''")'. 而不是 。 不要将整数或系统值括在引号中,例如,使用500、$true($false$null或改为) 。
可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。 例如,"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。
有关 Exchange 中 OPATH 筛选器的详细信息,请参阅 其他 OPATH 语法信息。
不能将此参数与 Scope 参数和值 Forest 或其他与范围相关的参数一起使用。
仅当将 UpdateSettingsGroup 开关与 GroupName 参数配合使用更新 Exchange 设置组时,才使用此参数。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateSettingsGroup
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-SettingsGroup
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
SettingsGroup 参数指定用于创建新设置组或修改现有设置组的现有 Exchange 设置组。
不能将 SettingsGroup 参数与 GroupName 参数一起使用。
参数属性
| 类型: | String |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
CreateSettingsGroupAdvanced
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateSettingsGroupAdvanced
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-UpdateSetting
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
UpdateSetting 开关指定要更新现有 Exchange 设置对象中的 Exchange 设置。 不必为此开关指定值。
您可以使用 ConfigPairs 参数或 ConfigName 和 ConfigValue 参数配置 Exchange 设置。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UpdateSetting
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateMultipleSettings
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-UpdateSettingsGroup
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
UpdateSettingsGroup 开关指定要修改 Exchange 设置组。 不必为此开关指定值。
根据要配置设置组的方式,可以使用 GroupName 参数或 SettingsGroup 参数指定要修改的 Exchange 设置组。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
UpdateSettingsGroup
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
UpdateSettingsGroupAdvanced
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
-WhatIf
适用:Exchange Server 2016、Exchange Server 2019、Exchange Server SE
WhatIf 开关显示命令执行的操作,而无需进行任何更改。 不必为此开关指定值。
参数属性
| 类型: | SwitchParameter |
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | WI |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值(按属性名称): | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持以下常用参数:-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息,请参阅 about_CommonParameters。