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