通过

Set-ServerComponentState

模块:
ExchangePowerShell
适用于:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

此 cmdlet 仅适用于本地 Exchange。

使用 Set-ServerComponentState cmdlet 在指定的服务器上配置和更新Microsoft Exchange 组件和终结点。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Set-ServerComponentState
   [-Identity] <ServerIdParameter>
   -Component <String>
   -Requester <String>
   -State <ServiceState>
   [-Confirm]
   [-DomainController <Fqdn>]
   [-LocalOnly]
   [-RemoteOnly]
   [-TimeoutInSeconds <Int32>]
   [-WhatIf]
   [<CommonParameters>]

说明

您必须先获得权限，然后才能运行此 cmdlet。 虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。 若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 Find the permissions required to run any Exchange cmdlet。

示例

示例 1

Set-ServerComponentState -Identity MailboxServer01 -Component UMCallRouter -Requester Maintenance -State Active

本示例将统一消息 (UM) 组件状态设置为维护模式所要求的 Active。

示例 2

Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Inactive -Requester Maintenance

Set-ServerComponentState -Identity Exch5 -Component ServerWideOffline -State Active -Requester Maintenance

此示例准备服务器进行维护，例如安装安全更新或累积更新。

第一个命令将所有服务器组件的状态更改为“非活动”。

第二个命令在维护完成 (所需的) 后，将状态更改为“活动”。

注意：根据设计，如果相关 ImapProxyPopProxy 和 组件处于非活动状态，Microsoft Exchange IMAP4 和 Microsoft Exchange POP3 服务将停止。 在相关 ImapProxy 和 PopProxy 组件更改为“活动”状态后，可能需要手动重启服务。

参数

-Component

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Component 参数指定要为其设置状态的组件或终结点。

类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-Confirm

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Confirm 开关指定是否显示确认提示。 此开关对 cmdlet 造成的影响取决于在你继续操作之前 cmdlet 是否需要确认。

  • 破坏性 cmdlet（例如 Remove-* cmdlets）内置有暂停，可强制要求先确认命令，然后再继续操作。 对于这些 cmdlet，您可以使用此确切语法跳过确认提示：-Confirm:$false。
  • 其他大多数 cmdlet（例如 New-* 和 Set-* cmdlet）都没有内置暂停。 对于这些 cmdlet，指定不含值的 Confirm 开关会引入暂停，从而强制要求你先确认命令，然后再继续操作。
类型:SwitchParameter
别名:cf
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-DomainController

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

DomainController 参数指定此 cmdlet 从 Active Directory 读取数据或向其写入数据时使用的域控制器。 可以使用完全限定的域名 (FQDN) 来标识域控制器。 例如，dc01.contoso.com。

边缘传输服务器上不支持 DomainController 参数。 边缘传输服务器使用活动目录轻型目录服务 (AD LDS) 的本地实例来读取和写入数据。

类型:Fqdn
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Identity

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Identity 参数指定要在其中运行此命令的 Exchange 服务器。 可以使用唯一标识该服务器的任何值。 例如：

  • 名称
  • FQDN
  • 可分辨名称 (DN)
  • Exchange 旧版 DN
类型:ServerIdParameter
Position:1
默认值:None
必需:True
接受管道输入:True
接受通配符:False

-LocalOnly

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

LocalOnly 开关指定仅将更改写入 Exchange 服务器的注册表，而不写入 Active Directory。 不必为此开关指定值。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-RemoteOnly

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

RemoteOnly 开关指定更改仅写入 Active Directory，而不写入 Exchange 服务器的注册表。 不必为此开关指定值。

类型:SwitchParameter
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-Requester

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

Requester 参数指定请求此状态更改的系统。 有效值包含:

  • HealthAPI
  • 维护
  • 缺席
  • 功能的
  • 部署
类型:String
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-State

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

State 参数指定组件所需的状态。 有效值包含:

  • 活动
  • 非活动
  • 排水
类型:ServiceState
Position:Named
默认值:None
必需:True
接受管道输入:False
接受通配符:False

-TimeoutInSeconds

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

保留此参数以供 Microsoft 内部使用。

类型:Int32
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

-WhatIf

适用：Exchange Server 2013、Exchange Server 2016、Exchange Server 2019

WhatIf 开关模拟命令操作。 可以使用此开关在不实际应用将会发生的更改的情况下预览这些更改。 不必为此开关指定值。

类型:SwitchParameter
别名:wi
Position:Named
默认值:None
必需:False
接受管道输入:False
接受通配符:False

输入

Input types

若要了解此 cmdlet 接受的输入类型，请参阅 cmdlet 的输入和输出类型。 如果 cmdlet 的"输入类型"字段为空，则表明此 cmdlet 不接受输入数据。

输出

Output types

若要了解此 cmdlet 接受的返回类型（亦称为"输出类型"），请参阅 cmdlet 的输入和输出类型。 如果"输出类型"字段为空，则表明此 cmdlet 不返回任何数据。