Set-ServerComponentState

Ссылка

Модуль:: ExchangePowerShell

Применяется к:: Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Этот командлет доступен только в локальной среде Exchange.

Используйте командлет Set-ServerComponentState для настройки и обновления компонентов и конечных точек Microsoft Exchange на указанных серверах.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

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

Описание

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

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

В этом примере устанавливается значение "Активный" для состояния компонента единой системы обмена сообщениями по запросу режима обслуживания.

Пример 2

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

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

В этом примере сервер подготавливается к обслуживанию, например к установке обновления для системы безопасности или накопительного обновления.

Первая команда изменяет состояние всех компонентов сервера на Неактивно.

Вторая команда изменяет состояние на Активно после окончания обслуживания (обязательно).

Примечание. По умолчанию службы Microsoft Exchange IMAP4 и Microsoft Exchange POP3 останавливаются, если связанные ImapProxy компоненты и PopProxy находятся в неактивном состоянии. Вам может потребоваться вручную перезапустить службы после того, как связанные ImapProxy компоненты и PopProxy будут изменены в активное состояние.

Параметры

-Component

Параметр Component указывает компонент или конечную точку, для которой необходимо определить состояние.

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Confirm

Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.

Деструктивные командлеты (например, командлеты Remove-) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис: -Confirm:$false.
Большинство других командлетов (например, командлеты New- и Set-) не имеют встроенной паузы. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.

Тип:	SwitchParameter
Aliases:	cf
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-DomainController

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Параметр DomainController не поддерживается пограничными транспортными серверами. Пограничный транспортный сервер использует локальный экземпляр службы Active Directory облегченного доступа к каталогам (AD LDS) для чтения и записи данных.

Тип:	Fqdn
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity указывает сервер Exchange Server, на котором требуется выполнить эту команду. Можно использовать любое значение, однозначно определяющее сервер. Примеры:

Имя.
полное доменное имя;
различающееся имя (DN);
Устаревшее различающееся имя Exchange

Тип:	ServerIdParameter
Position:	1
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	True
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-LocalOnly

Параметр LocalOnly указывает, что изменения записываются только в реестр сервера Exchange, а не в Active Directory. С этим параметром не нужно указывать значение.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-RemoteOnly

Параметр RemoteOnly указывает, что изменения записываются только в Active Directory, а не в реестр сервера Exchange Server. С этим параметром не нужно указывать значение.

Тип:	SwitchParameter
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-Requester

Параметр Requester указывает систему с запросом об изменении этого состояния. Допустимые значения:

HealthAPI
Обслуживание
Обочине
Функциональный
Развертывание

Тип:	String
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-State

Параметр State указывает состояние, которое требуется задать компоненту. Допустимые значения:

Активное
Неактивно
Осушение

Тип:	ServiceState
Position:	Named
Default value:	None
Обязательно:	True
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-TimeoutInSeconds

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

Тип:	Int32
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

-WhatIf

Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.

Тип:	SwitchParameter
Aliases:	wi
Position:	Named
Default value:	None
Обязательно:	False
Принять входные данные конвейера:	False
Принять подстановочные знаки:	False
Применяется к:	Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Входные данные

Input types

Чтобы просмотреть типы входных данных, которые принимает этот командлет, см. Типы входных и выходных данных командлета. Если поле "Типы входных данных" для командлета пусто, командлет не принимает входные данные.

Выходные данные

Output types

Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.

Поделиться через