Set-MailboxServer

 

适用于: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1

上一次修改主题: 2008-01-21

使用 Set-MailboxServer cmdlet 可以通过指定邮箱服务器标识和要修改的属性,来修改 Exchange 邮箱服务器的属性。

语法

Set-MailboxServer -Identity <MailboxServerIdParameter> [-AutoDatabaseMountDial <Lossless | GoodAvailability | BestAvailability>] [-ClusteredStorageType <Disabled | NonShared | Shared>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderLogForManagedFoldersEnabled <$true | $false>] [-ForcedDatabaseMountAfter <Unlimited>] [-JournalingLogForManagedFoldersEnabled <$true | $false>] [-Locale <MultiValuedProperty>] [-LogDirectorySizeLimitForManagedFolders <Unlimited>] [-LogFileAgeLimitForManagedFolders <EnhancedTimeSpan>] [-LogFileSizeLimitForManagedFolders <Unlimited>] [-LogPathForManagedFolders <LocalLongFullPath>] [-ManagedFolderAssistantSchedule <ScheduleInterval[]>] [-MAPIEncryptionRequired <$true | $false>] [-MessageTrackingLogEnabled <$true | $false>] [-MessageTrackingLogMaxAge <EnhancedTimeSpan>] [-MessageTrackingLogMaxDirectorySize <Unlimited>] [-MessageTrackingLogMaxFileSize <Unlimited>] [-MessageTrackingLogPath <LocalLongFullPath>] [-MessageTrackingLogSubjectLoggingEnabled <$true | $false>] [-RedundantMachines <MultiValuedProperty>] [-ReplicationNetworks <PrivateOnly | PrivateThenMixed | AllNetworks>] [-RetentionLogForManagedFoldersEnabled <$true | $false>] [-SubjectLogForManagedFoldersEnabled <$true | $false>] [-SubmissionServerOverrideList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

Set-MailboxServer [-AutoDatabaseMountDial <Lossless | GoodAvailability | BestAvailability>] [-ClusteredStorageType <Disabled | NonShared | Shared>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-FolderLogForManagedFoldersEnabled <$true | $false>] [-ForcedDatabaseMountAfter <Unlimited>] [-Instance <MailboxServer>] [-JournalingLogForManagedFoldersEnabled <$true | $false>] [-Locale <MultiValuedProperty>] [-LogDirectorySizeLimitForManagedFolders <Unlimited>] [-LogFileAgeLimitForManagedFolders <EnhancedTimeSpan>] [-LogFileSizeLimitForManagedFolders <Unlimited>] [-LogPathForManagedFolders <LocalLongFullPath>] [-ManagedFolderAssistantSchedule <ScheduleInterval[]>] [-MAPIEncryptionRequired <$true | $false>] [-MessageTrackingLogEnabled <$true | $false>] [-MessageTrackingLogMaxAge <EnhancedTimeSpan>] [-MessageTrackingLogMaxDirectorySize <Unlimited>] [-MessageTrackingLogMaxFileSize <Unlimited>] [-MessageTrackingLogPath <LocalLongFullPath>] [-MessageTrackingLogSubjectLoggingEnabled <$true | $false>] [-RedundantMachines <MultiValuedProperty>] [-ReplicationNetworks <PrivateOnly | PrivateThenMixed | AllNetworks>] [-RetentionLogForManagedFoldersEnabled <$true | $false>] [-SubjectLogForManagedFoldersEnabled <$true | $false>] [-SubmissionServerOverrideList <MultiValuedProperty>] [-WhatIf [<SwitchParameter>]]

详细说明

若要运行 Set-MailboxServer cmdlet,必须为您使用的帐户委派以下角色:

  • Exchange Server 管理员角色和目标服务器的本地 Administrators 组

有关权限、角色委派以及管理 Microsoft Exchange Server 2007 所需权限的详细信息,请参阅权限注意事项

若要在同时安装了邮箱服务器角色和集线器传输服务器角色的服务器上修改邮件跟踪设置,可以将邮件跟踪参数与 Set-MailboxServer cmdlet 或 Set-TransportServer cmdlet 结合使用。若要在安装了邮箱服务器角色但没有安装集线器传输服务器角色的服务器上修改邮件跟踪设置,则必须将邮件跟踪参数与 Set-MailboxServer cmdlet 结合使用。若要在安装了集线器传输服务器角色但没有安装邮箱服务器角色的服务器上修改邮件跟踪设置,则必须将邮件跟踪参数与 Set-TransportServer cmdlet 结合使用。

参数

参数 必需 类型 说明

Identity

必需

Microsoft.Exchange.Configuration.Tasks.MailboxServerIdParameter

Identity 参数指定邮箱服务器。可以使用下列值:

  • GUID

  • 可分辨名称 (DN)

  • 邮箱服务器的名称

AutoDatabaseMountDial

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.AutoDatabaseMountDial

AutoDatabaseMountDial 参数为群集连续复制 (CCR) 解决方案指定在群集邮箱服务器故障转移之后,数据库的自动装入行为。可以使用下列值:

  • BestAvailability。指定该值时,如果复制队列长度小于或等于六,则数据库将自动装入。复制队列长度是被动节点识别出的、需要复制的日志数。如果复制队列长度大于六,则数据库将不会自动装入。当复制队列长度小于或等于六时,Exchange 会尝试将剩余日志复制到被动节点,并装入数据库。

  • GoodAvailability。指定该值时,如果复制队列长度小于或等于三,则在故障转移之后数据库将立即自动装入。复制队列长度是被动节点识别出的、需要复制的日志数。如果复制队列长度大于三,则数据库将不会自动装入。当复制队列长度小于或等于二时,Exchange 会尝试将剩余日志复制到被动节点,并装入数据库。

  • Lossless。指定该值时,只有在主动节点上生成的所有日志都复制到被动节点后,数据库才会自动装入。

默认值为 BestAvailability。如果指定 BestAvailability 或 GoodAvailability,并且主动节点上的数据没有全部复制到被动节点,则可能会丢失一些邮箱数据。不过,传输转储程序功能(默认启用该功能)将通过重新提交传输转储程序队列中的邮件来帮助防止数据丢失。有关传输转储程序的详细信息,请参阅群集连续复制

如果指定这些值之一导致故障转移之后不装入数据库,则可以使用 ForcedDatabaseMountAfter 参数强制数据库在指定的时间之后装入。

有关 Lossless、GoodAvailability 和 BestAvailability 值的详细信息,请参阅计划中断和未计划中断

ClusteredStorageType

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.ClusteredStorageType

ClusteredStorageType 参数指定群集邮箱服务器的共享存储类型。可以使用下列值:

  • Disabled

  • NonShared(对于群集连续复制)

  • Shared(对于单个复制群集)

Confirm

可选

System.Management.Automation.SwitchParameter

Confirm 参数将导致命令暂停处理,并且需要您在处理继续之前确认该命令将执行的操作。不必为 Confirm 参数指定值。

DomainController

可选

Microsoft.Exchange.Data.Fqdn

若要指定用于将此配置更改写入 Active Directory 目录服务域控制器的完全限定的域名 (FQDN),请在命令中包含 DomainController 参数。

FolderLogForManagedFoldersEnabled

可选

System.Boolean

FolderLogForManagedFoldersEnabled 参数指定是否对被移动到托管文件夹中的邮件启用托管文件夹的文件夹日志。此参数的两个可能值是 $true 或 $false。如果指定 $true,则会在日志中记录已应用托管文件夹邮箱策略的文件夹的相关信息。

ForcedDatabaseMountAfter

可选

Microsoft.Exchange.Data.Unlimited

ForcedDatabaseMountAfter 参数指定在群集邮箱服务器故障转移之后在自动装入数据库之前要等待的时间量。若要指定值,请以时间跨度的形式输入:dd.hh:mm:ss,其中 d = 天数,h = 小时数,m = 分钟数,s = 秒数。例如,若要指定超时值为两小时,请输入 2:00:00。

如果将 AutoDatabaseMountDial 参数设置为 GoodAvailability 或 BestAvailability,并且数据库丢失的日志文件数已超过 AutoDatabaseMountDial 参数值所允许的数目,则邮箱服务器将等待 ForcedDatabaseMountAfter 参数指定的时间量之后,再自动装入数据库。

Instance

可选

Microsoft.Exchange.Data.Directory.Management.MailboxServer

使用 Instance 参数可以将整个对象传递给此命令以进行处理。该参数主要用于必须将整个对象传递给命令的脚本。该参数表包含于参数表,供开发人员参考。

JournalingLogForManagedFoldersEnabled

可选

System.Boolean

JournalingLogForManagedFoldersEnabled 参数指定是否对日记启用托管文件夹的日志。此参数的两个可能值是 $true 或 $false。如果指定 $true,将记录有关已记录邮件的相关信息。日志位于用 LogPathForManagedFolders 参数指定的位置。

Locale

可选

Microsoft.Exchange.Data.MultiValuedProperty

Locale 参数指定区域设置。区域设置是与语言相关的用户首选项(例如,书写系统、日历和日期格式)的集合。下面是一些示例:

  • en-US(英语 - 美国)

  • de-AT(德语 - 奥地利)

  • es-CL(西班牙语 - 智利)

若要查看完整列表,请参阅 CultureInfo Class

LogDirectorySizeLimitForManagedFolders

可选

Microsoft.Exchange.Data.Unlimited

LogDirectorySizeLimitForManagedFolders 参数指定单个邮件数据库中的所有托管文件夹日志文件的大小限制。某个邮件数据库的一组托管文件夹日志文件达到限制之后,将删除最早的文件以便为新文件留出空间。

托管文件夹日志文件的大小是按以下方法计算的:将具有相同名称前缀的所有日志文件的大小相加,求其总和。例如,对于一个名称为 Managed_Folder_Assistant[Storage Group 01][Mailbox Database 01]20061018-1.log 的文件,其前缀是 Managed_Folder_Assistant[Storage Group 01][Mailbox Database 01]。如果重命名了日志文件或将其他文件复制到了托管文件夹日志目录中,则在计算日志文件大小时不会将这些文件计算在内。每个邮件数据库的托管文件夹日志文件都具有唯一的名称前缀。因此,此限制适用于每个邮件数据库的日志文件,而不适用于此目录中的所有日志文件。如果具有多个邮件数据库,则托管文件夹日志目录的最大大小不是在 LogDirectorySizeLimitForManagedFolders 参数中指定的大小,因为由不同数据库生成的托管文件夹日志文件具有不同的名称前缀。如果具有 X 个邮件数据库,则托管文件夹日志目录的最大大小将是指定值的 X 倍。

必须指定整数或“unlimited”。默认值为“unlimited”。输入值时,请用下列单位之一限定该值:

  • B(字节)

  • KB(千字节)

  • MB(兆字节)

  • GB(千兆字节)

  • TB(兆兆字节)

未限定的值被视为以字节为单位。

LogFileAgeLimitForManagedFolders

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

LogFileAgeLimitForManagedFolders 参数指定托管文件夹日志的保留时间。超过最大保留时段的日志文件将被删除。若要指定值,请输入一个时间跨度:dd.hh:mm:ss,其中,d = 天数,h = 小时数,m = 分钟数,s = 秒数。例如,要指定 30 天的间隔,则输入 30.00:00:00。默认值为 00:00:00:00(指定文件保留没有时间限制,并且不立即覆盖该文件)。

LogFileSizeLimitForManagedFolders

可选

Microsoft.Exchange.Data.Unlimited

LogFileSizeLimtiForManagedFolders 参数指定每个托管文件夹日志文件的最大大小。达到日志文件大小限制时,将新建日志文件。默认值为 10 MB。输入值时,请使用下列单位之一限定值:

  • B(字节)

  • KB(千字节)

  • MB(兆字节)

  • GB(千兆字节)

  • TB(千吉字节)

未限定的值被视为以字节为单位。

LogPathForManagedFolders

可选

Microsoft.Exchange.Data.LocalLongFullPath

LogPathForManagedFolders 参数指定用于存储托管文件夹日志文件的目录的路径。默认值是 <Exchange 安装路径>\Logging\Managed Folder Assistant。

ManagedFolderAssistantSchedule

可选

Microsoft.Exchange.Common.ScheduleInterval[]

ManagedFolderAssistantSchedule 参数指定托管文件夹助理将 MRM 设置应用于托管文件夹的每周间隔。格式是 StartDay.Time-EndDay.Time。可以使用下列值作为起始日和结束日:

  • 星期几的完整名称

  • 星期几的缩写名称

  • 从 0 到 6 的整数,0 = 星期日

开始时间和结束时间必须至少间隔 15 分钟。分钟数将四舍五入到 0、15、30 或 45。如果指定多个间隔,则每个间隔之间必须有至少 15 分钟。

示例:

  • "Sun.11:30 PM-Mon.1:30 AM"

  • 6.22:00-6.22:15(助理将从星期六的 10:00 PM 运行到星期六的 10:15 PM。)

  • "Monday.4:30 AM-Monday.5:30 AM","Wednesday.4:30 AM-Wednesday.5:30 AM"(助理将从星期一和星期三上午的 4:30 运行到 5:30。)

  • "Sun.1:15 AM-Monday.23:00"

如果托管文件夹助理在您安排的时间内未完成对服务器上邮箱的处理,则在下次运行该助理时,将从停止位置自动恢复处理。

MAPIEncryptionRequired

可选

System.Boolean

MAPIEncryptionRequired 参数指定 Exchange 是否阻止不使用加密远程过程调用 (RPC) 的 MAPI 客户端。此参数的两个可能值是 $true 或 $false。

MessageTrackingLogEnabled

可选

System.Boolean

MessageTrackingLogEnabled 参数指定是否启用邮件跟踪。默认值为 $true。

MessageTrackingLogMaxAge

可选

Microsoft.Exchange.Data.EnhancedTimeSpan

MessageTrackingLogMaxAge 参数指定邮件跟踪日志的最长文件期限。早于指定值的日志文件将被删除。默认值是 30 天。若要指定值,请输入一个时间跨度:dd.hh:mm:ss,其中,d = 天数,h = 小时数,m = 分钟数,s = 秒数。此参数的有效输入范围是 00:00:0024855.03:14:07。如果将 MessageTrackingLogMaxAge 参数的值设置为 00:00:00,可以避免由于文件期限已到而自动删除邮件跟踪日志文件。

MessageTrackingLogMaxDirectorySize

可选

Microsoft.Exchange.Data.Unlimited

MessageTrackingLogMaxDirectorySize 参数指定邮件跟踪日志目录的最大大小。如果已达到最大目录大小,服务器会首先删除最早的日志文件。

邮件跟踪日志目录的最大大小是按以下方法计算的:将具有相同名称前缀的所有日志文件的大小相加,求其总和。在计算总目录大小时,不会将其他未遵循名称前缀约定的文件计算在内。重命名旧日志文件或将其他文件复制到邮件跟踪日志目录可能会导致目录超出其指定的最大大小。

集线器传输服务器角色和邮箱服务器角色安装在同一个服务器上时,邮件跟踪日志目录的最大大小不是指定的最大大小,因为不同服务器角色生成的邮件跟踪日志文件具有不同的名称前缀。集线器传输服务器角色或边缘传输服务器角色的邮件跟踪日志文件以名称前缀 MSGTRK 开头。邮箱服务器角色的邮件跟踪日志文件以名称前缀 MSGTRKM 开头。集线器传输服务器角色和邮箱服务器角色安装在同一个服务器上时,邮件跟踪日志目录的最大大小是指定值的两倍。

默认值为 250 MB。输入值时,请用下列单位之一限定该值:

  • B(字节)

  • KB(千字节)

  • MB(兆字节)

  • GB(千兆字节)

  • TB(兆兆字节)

未限定的值被视为以字节为单位。MessageTrackingLogMaxFileSize 参数的值必须小于或等于 MessageTrackingLogMaxDirectorySize 参数的值。这两个参数的有效输入范围都是 19223372036854775807 字节。

MessageTrackingLogMaxFileSize

可选

Microsoft.Exchange.Data.Unlimited

MessageTrackingLogMaxFileSize 参数指定邮件跟踪日志文件的最大大小。当日志文件达到其最大文件大小时,将创建新的日志文件。默认值为 10 MB。输入值时,请用下列单位之一限定该值:

  • B(字节)

  • KB(千字节)

  • MB(兆字节)

  • GB(千兆字节)

  • TB(千吉字节)

未限定的值被视为以字节为单位。MessageTrackingLogMaxFileSize 参数的值必须小于或等于 MessageTrackingLogMaxDirectorySize 参数的值。这两个参数的有效输入范围都是 1 到 9223372036854775807 字节。

MessageTrackingLogPath

可选

Microsoft.Exchange.Data.LocalLongFullPath

MessageTrackingLogPath 参数指定邮件跟踪日志的位置。默认位置为 C:\Program Files\Microsoft\Exchange Server TransportRoles\Logs\MessageTracking。在单一副本群集 (SCC) 环境中,将邮件跟踪日志目录移到共享存储资源上的物理磁盘资源。这样,即使发生故障转移,也可以继续搜索邮件跟踪日志。如果将 MessageTrackingLogPath 参数的值设置为 $null,则可以有效地禁用邮件跟踪。但是,如果在 MessageTrackingLogEnabled 属性的值为 $true 时将 MessageTrackingLogPath 参数的值设置为 $null,则会产生事件日志错误。禁用邮件跟踪的首选方法是使用 MessageTrackingLogEnabled 参数。

MessageTrackingLogSubjectLoggingEnabled

可选

System.Boolean

MessageTrackingLogSubjectLoggingEnable 参数指定邮件跟踪日志中是否应包含邮件主题。默认值为 $True

RedundantMachines

可选

Microsoft.Exchange.Data.MultiValuedProperty

RedundantMachines 参数指定群集资源的可能的所有者和首选的所有者。

ReplicationNetworks

可选

Microsoft.Exchange.Data.Directory.SystemConfiguration.ReplicationNetworks

ReplicationNetworks 参数在 Exchange Server 2007 RTM 或 SP1 中不起作用(不推荐使用)。运行 Set-MailboxServer cmdlet 时,不应当使用该参数。

RetentionLogForManagedFoldersEnabled

可选

System.Boolean

RetentionLogForManagedFoldersEnabled 参数指定托管文件夹助理是否记录已达到其保留限制的邮件的相关信息。此参数的两个可能值是 $true 或 $false。如果指定 $true,则会在日志中记录由于已达到其保留限制而已经进行处理的邮件的相关信息。

SubjectLogForManagedFoldersEnabled

可选

System.Boolean

SubjectLogForManagedFoldersEnabled 参数指定是否将在托管文件夹日志中显示邮件的主题。此参数的两个可能值是 $true 或 $false。如果指定 $false,则在托管文件夹日志中邮件的主题将为空。默认值为 $false。

SubmissionServerOverrideList

可选

Microsoft.Exchange.Data.MultiValuedProperty

SubmissionServerOverrideList 参数是邮箱服务器在可以从发件人发件箱检索邮件时将通知的集线器传输服务器(与邮箱服务器位于同一个 Active Directory 站点中)的静态列表。此列表会覆盖动态发现的集线器传输服务器的列表,在要排除集线器传输服务器故障并且不希望其接收邮件提交通知时,可以临时使用此列表,也可以使用此列表覆盖与邮箱服务器位于同一个 Active Directory 站点的所有集线器传输服务器之间的通知自动负载平衡。

WhatIf

可选

System.Management.Automation.SwitchParameter

WhatIf 参数指示命令模拟对对象执行的操作。通过使用 WhatIf 参数,您可以查看要发生的更改,而不必应用任何这些更改。不必为 WhatIf 参数指定值。

输入类型

返回类型

错误

错误 说明

 

异常

异常 说明

 

示例

此示例使用 Set-MailboxServer 命令将服务器首选参数列表设置为 HubServer01、HubServer02 和 HubServer03。

Set-MailboxServer -Identity Server1 -SubmissionServerOverrideList HubServer01,HubServer02,HubServer03