Set-UMIPGateway
Применимо к: Exchange Server 2007 SP3, Exchange Server 2007 SP2, Exchange Server 2007 SP1
Последнее изменение раздела: 2007-07-17
Командлет 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>]]
Подробное описание
Командлет Set-UMIPGateway изменяет параметры настройки для шлюза IP единой системы обмена сообщениями, например IP-адрес для шлюза IP. К этим изменениям относятся разрешение исходящих вызовов и управление взаимодействием с шлюзом IP или IP-УАТС с поддержкой протокола SIP.
.gif "important") Важно! |
|---|
| Изменения параметров шлюза IP единой системы обмена сообщениями могут привести к разрыву связи между серверами единой системы обмена сообщениями и шлюзом IP или IP-УАТС с поддержкой протокола SIP. Изменения объекта IP-шлюза единой системы обмена сообщениями должно выполняться только администратором, полностью осознающим последствия выполнения изменений настройки IP-шлюза единой системы обмена сообщениями. |
Для выполнения командлета Set-UMIPGateway используемой учетной записи необходимо делегировать роль администратора организации Exchange.
Дополнительные сведения о разрешениях, делегировании ролей и правах, необходимых для администрирования Microsoft Exchange Server 2007, см. в разделе Вопросы, связанные с разрешениями.
Параметры
| Параметр | Обязательный | Тип | Описание |
|---|---|---|---|
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». |
Типы входных данных
Типы возвращаемых данных
Ошибки
| Ошибка | Описание |
|---|---|
|
|
Исключения
| Исключения | Описание |
|---|---|
|
|
Пример
В первом примере программы изменяется 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