Командлет Set-UMIPGateway используется, чтобы изменять параметры настройки для автономного IP-шлюза единой системы обмена сообщениями или возвращать список параметров настройки, которые могут быть изменены для данного IP-шлюза единой системы обмена сообщениями.

Синтаксис

Set-UMIPGateway -Identity <UMIPGatewayIdParameter> [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]
Set-UMIPGateway [-Address <UMSmartHost>] [-Confirm [<SwitchParameter>]] [-DomainController <Fqdn>] [-Instance <UMIPGateway>] [-Name <String>] [-OutcallsAllowed <$true | $false>] [-Port <Int32>] [-Simulator <$true | $false>] [-Status <Enabled | Disabled | NoNewCalls>] [-WhatIf [<SwitchParameter>]]

Параметры

Параметр Обязательный Тип Описание

Identity

Обязательный

Microsoft.Exchange.Configuration.Tasks.UMIPGatewayIdParameter

Этот параметр указывает идентификатор изменяемого IP-шлюза единой системы обмена сообщениями. Этот параметр является кодом объекта каталога для IP-шлюза единой системы обмена сообщениями.

Address

Необязательный

Microsoft.Exchange.Data.UMSmartHost

Этот параметр определяет IP-адрес, настроенный для шлюза IP или IP-УАТС с включенной поддержкой SIP.

Confirm

Дополнительно

System.Management.Automation.SwitchParameter

Этот параметр используется для приостановки команды и требует, чтобы администратор подтвердил ее выполнение. По умолчанию он имеет значение «$true».

DomainController

Необязательный

Microsoft.Exchange.Data.Fqdn

Этот параметр определяет полное доменное имя контроллера домена, который записывает это изменение конфигурации в службу каталогов Active Directory.

Instance

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.UMIPGateway

Этот параметр указывает параметр ввода, представляющий новый IP-шлюз.

Name

Необязательный

System.String

Этот параметр указывает отображаемое имя, которое будет использоваться для IP-шлюза единой системы обмена сообщениями. Отображаемое имя может содержать не более 64 символов.

OutcallsAllowed

Необязательный

System.Boolean

Этот параметр указывает, следует ли разрешить использование объекта IP-шлюза для исходящих вызовов. Параметр не управляет перенаправлением вызовов.

Port

Необязательный

System.Int32

Этот параметр указывает IP-порт, на котором выполняет прослушивание шлюз IP или IP-УАТС. По умолчанию этим портом является порт 5060. Диапазон для этого параметра находится в пределах от 0 до 65535.

Simulator

Необязательный

System.Boolean

Этот параметр указывает имитатор, который будет использоваться для просматриваемого IP-шлюза единой системы обмена сообщениями. Имитатор позволяет клиенту подключаться к серверу единой системы обмена сообщениями. Это подключение обычно используется в приложении тестового телефона Exchange.

Status

Необязательный

Microsoft.Exchange.Data.Directory.SystemConfiguration.GatewayStatus

Этот параметр определяет включение и выключение IP-шлюза единой системы обмена сообщениями.

WhatIf

Дополнительно

System.Management.Automation.SwitchParameter

Этот параметр заставляет команду имитировать действия, которые она будет выполнять над объектом. С помощью параметра WhatIf администратор может просматривать изменения, которые могли бы произойти, без применения всех этих изменений. По умолчанию он имеет значение «$true».

Подробное описание

Командлет Set-UMIPGateway изменяет параметры настройки для шлюза IP единой системы обмена сообщениями, например IP-адрес для шлюза IP. К этим изменениям относятся разрешение исходящих вызовов и управление взаимодействием с шлюзом IP или IP-УАТС с поддержкой протокола SIP.

Важно!
Изменения параметров шлюза IP единой системы обмена сообщениями могут привести к разрыву связи между серверами единой системы обмена сообщениями и шлюзом IP или IP-УАТС с поддержкой протокола SIP. Изменения объекта IP-шлюза единой системы обмена сообщениями должно выполняться только администратором, полностью осознающим последствия выполнения изменений настройки IP-шлюза единой системы обмена сообщениями.

Для выполнения командлета Set-UMIPGateway используемой учетной записи необходимо делегировать роль администратора организации Exchange.

Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.

Типы входных данных

Типы возвращаемых данных

Ошибки

Ошибка Описание

 

 

Исключения

Исключения Описание

 

 

Пример

В первом примере программы изменяется IP-адрес IP-шлюза единой системы обмена сообщениями под названием MyUMIPGateway.

Во втором примере предотвращаются получение входящих вызовов IP-шлюзом единой системы обмена сообщениями и исходящие вызовы.

Третий пример позволяет шлюзу IP единой системы обмена сообщениями выполнять функции имитатора шлюза IP и может быть использован с командлетом Test-UMConnectivity или программой тестового телефона единой системы обмена сообщениями Exchange.

Копировать код
Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1

Set-UMIPGateway -Identity MyUMIPGateway -Address 10.10.10.1 -Status 2 -OutcallsAllowed $false

Set-UMIPGateway -Identity MyUMIPGateway -Simulator $true