Get-MapiVirtualDirectory
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Get-MapiVirtualDirectory для просмотра виртуальных каталогов MAPI, которые используются в службах IIS на серверах Microsoft Exchange. Виртуальный каталог MAPI используется поддерживаемыми версиями Microsoft Outlook для подключения к почтовым ящикам по протоколу MAPIHTTP.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Server
Get-MapiVirtualDirectory
-Server <ServerIdParameter>
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Identity
Get-MapiVirtualDirectory
[[-Identity] <VirtualDirectoryIdParameter>]
[-ADPropertiesOnly]
[-DomainController <Fqdn>]
[-ShowMailboxVirtualDirectories]
[<CommonParameters>]
Описание
Для его запуска необходимо получить соответствующие разрешения. Хотя в этой статье перечислены все параметры командлета, у вас может не быть доступа к некоторым параметрам, если они не включены в назначенные вам разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Get-MapiVirtualDirectory -Server ContosoMail
В этом примере возвращается сводный список виртуальных каталогов MAPI на сервере с именем ContosoMail.
Пример 2
Get-MapiVirtualDirectory -Identity "ContosoMail\mapi (Default Web Site)" | Format-List
Get-MapiVirtualDirectory "ContosoMail\mapi (Default Web Site)" | Format-List
Get-MapiVirtualDirectory ContosoMai\mapi* | Format-List
В этих примерах возвращаются подробные сведения для виртуального каталога MAPI с именем mapi (веб-сайт по умолчанию) на сервере ContosoMail. Все три команды выполняют одно и то же действие.
Пример 3
Get-MapiVirtualDirectory
В этом примере возвращается сводный список всех виртуальных каталогов MAPI в службах клиентского доступа на серверах почтовых ящиков в организации.
Параметры
-ADPropertiesOnly
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Параметр ADPropertiesOnly указывает, следует ли возвращать только свойства виртуального каталога, хранящиеся в Active Directory. С этим параметром не нужно указывать значение.
Если этот параметр не используется, возвращаются свойства в Active Directory и метабазе СЛУЖБ IIS.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-DomainController
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.
Свойства параметров
| Тип: | Fqdn |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-Identity
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Параметр Identity указывает виртуальный каталог MAPI, который требуется просмотреть. Можно использовать любое уникальное значение, идентифицирующее виртуальный каталог. Например:
- Имя или Сервер\Имя
- различающееся имя (DN);
- GUID
Значение Name использует синтаксис "VirtualDirectoryName (WebsiteName)" из свойств виртуального каталога. Вместо веб-сайта по умолчанию можно указать подстановочный знак (*) с помощью синтаксиса VirtualDirectoryName*.
Параметры Identity и Server не могут использоваться в одной команде.
Внимание! Значение $null или несуществующее значение для параметра Identity возвращает все объекты, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity являются точными и не содержат несуществующих $null значений.
Свойства параметров
| Тип: | VirtualDirectoryIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-Server
Применимо: Exchange Server 2013 г., Exchange Server 2016 г., Exchange Server 2019 г., Exchange Server SE
Параметр Server указывает сервер Exchange Server, на котором размещается виртуальный каталог. Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- Имя.
- полное доменное имя;
- различающееся имя (DN);
- ExchangeLegacyDN
Параметры Server и Identity не могут использоваться в одной команде.
Свойства параметров
| Тип: | ServerIdParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Server
| Position: | Named |
| Обязательно: | True |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-ShowMailboxVirtualDirectories
Применимо: Exchange Server 2013 г.
Этот параметр доступен только в Exchange Server 2013 г.
Параметр ShowMailboxVirtualDirectories отображает сведения о серверных виртуальных каталогах на серверах почтовых ящиков. С этим параметром не нужно указывать значение.
По умолчанию этот командлет отображает сведения о виртуальных каталогах в службах клиентского доступа на серверах почтовых ящиков. Клиентские подключения выполняются через прокси-серверы служб клиентского доступа на серверах почтовых ящиков к внутренним службам на серверах почтовых ящиков. Настроить виртуальный каталог для внутренних служб на сервере почтовых ящиков.
По умолчанию этот командлет отображает сведения о виртуальных каталогах в службах клиентского доступа на серверах почтовых ящиков. Службы клиентского доступа на серверах почтовых ящиков выступают в роли прокси-серверов, передавая подключения клиентов во внутренние службы на серверах почтовых ящиков. Клиенты не подключаются непосредственно ко внутренним службам.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | 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
Чтобы просмотреть типы возвращаемых данных, также называемые типами вывода, которые принимает этот командлет, см. раздел Типы ввода и вывода командлета. Если поле "Типы выходных данных" пусто, командлет не возвращает данные.