Get-UMIPGateway

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

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

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

Синтаксис

Get-UMIPGateway
   [[-Identity] <UMIPGatewayIdParameter>]
   [-DomainController <Fqdn>]
   [-IncludeSimulator]
   [<CommonParameters>]

Описание

Командлет Get-UMIPGateway отображает свойства и значения для указанного IP-шлюза единой системы обмена сообщениями, такие как отображаемое имя, IP-адрес, состояние и параметры исходящих вызовов. Если параметр не указан, возвращаются все IP-шлюзы единой системы обмена сообщениями в лесу Active Directory.

При использовании командлета Get-UMIPGateway нельзя указать IP-адрес, настроенный для шлюза IP единой системы обмена сообщениями. Необходимо использовать имя шлюза IP единой системы обмена сообщениями. Имя, указанное с помощью параметра Identity командлета Get-UMIPGateway, может совпадать с именем хоста шлюза IP единой системы обмена сообщениями (например, Get-UMIPGatewayMyUMIPGateway) или отличаться от него.

После завершения этой задачи можно просмотреть список свойств и значений отдельного шлюза IP единой системы обмена сообщениями. Или, если не используется параметр Identity, командлет возвращает список всех шлюзов IP в лесе.

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

Примеры

Пример 1

Get-UMIPGateway | Format-List

В этом примере отображается форматированный список всех шлюзов IP единой системы обмена сообщениями в лесу службы каталогов Active Directory.

Пример 2

Get-UMIPGateway -Identity MyUMIPGateway

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

Пример 3

Get-UMIPGateway -IncludeSimulator $true

В этом примере отображаются все IP-шлюзы единой системы обмена сообщениями, включая симуляторы IP-шлюзов в лесу Active Directory.

Параметры

-DomainController

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

Type:Fqdn
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-Identity

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

Type:UMIPGatewayIdParameter
Position:1
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

-IncludeSimulator

Переключатель IncludeSimulator возвращает имитатор просматриваемого шлюза IP единой системы обмена сообщениями. Указывать значение для этого параметра необязательно.

Имитатор позволяет клиенту подключаться к серверу почтовых ящиков.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

Input types

Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.

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

Output types

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.