Get-UMIPGateway
Этот командлет доступен только в локальной среде 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
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.