Get-UMIPGateway

Модуль:
Exchange PowerShell

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

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

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

Синтаксис

Default (По умолчанию) 

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

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

Свойства параметров

Тип:Fqdn
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.

Свойства параметров

Тип:UMIPGatewayIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IncludeSimulator

Применимо: Exchange Server 2010, Exchange Server 2013, Exchange Server 2016

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

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

Свойства параметров

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

Наборы параметров

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.

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

Input types

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

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

Output types

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