Test-PopConnectivity
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Test-PopConnectivity, чтобы убедиться, что служба MICROSOFT Exchange POP3 работает должным образом.
Примечание: этот командлет оптимальным образом работает с Exchange 2010. В более поздних версиях Exchange функциональность этого командлета была заменена управляемой доступностью. Для получения наилучших результатов используйте командлет Invoke-MonitoringProbe и укажите соответствующий активный зонд мониторинга вместо использования этого командлета.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Test-PopConnectivity
[[-ClientAccessServer] <ServerIdParameter>]
[-Confirm]
[-ConnectionType <ProtocolConnectionType>]
[-DomainController <Fqdn>]
[-LightMode]
[-MailboxCredential <PSCredential>]
[-MailboxServer <ServerIdParameter>]
[-MonitoringContext]
[-PerConnectionTimeout <Int32>]
[-PortClientAccessServer <Int32>]
[-ResetTestAccountCredentials]
[-Timeout <UInt32>]
[-TrustAnySSLCertificate]
[-WhatIf]
[<CommonParameters>] Описание
Командлет Test-PopConnectivity проверяет подключение по протоколу POP3, подключаясь к указанному почтовому ящику, указанному серверу Exchange server или всем серверам Exchange, доступным на локальном сайте Active Directory.
При первом использовании этого командлета может понадобиться создание тестового пользователя. Чтобы создать тестового пользователя, выполните следующую команду:
& $env:ExchangeInstallPath\Scripts\New-TestCasConnectivityUser.ps1
Результаты проверки отображаются на экране. Командлет вернет следующую информацию:
- CasServer — сервер Exchange, к которому подключен клиент.
- LocalSite — имя локального сайта Active Directory.
- Scenario — проверяемые действия. Проверка подключения POP3 подключается к серверу по протоколу POP3, выполняет поиск тестового сообщения и удаляет тестовое сообщение.
- Result — возвращаемые результаты. Обычно это Success (Успешно), Skipped (Пропущено) или Failure (Сбой).
- Latency(MS) — время, необходимое для выполнения проверки (в миллисекундах).
- Error — любые появившиеся сообщения об ошибках.
Результаты можно записать в файл, перенаписав выходные данные в ConvertTo-Html и Set-Content. Пример: Test-PopConnectivity -ClientAccessServer MBX01 | ConvertTo-Html | Set-Content -Path "C:\My Documents\POP Test.html".
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Test-PopConnectivity -ClientAccessServer Contoso12 -MailboxCredential (Get-Credential contoso\kweku)В этом примере выполняется проверка возможности подключения по протоколу POP3 для сервера Contoso12 с помощью учетных данных пользователя contoso\kweku.
Пример 2
Test-PopConnectivity -ClientAccessServer Contoso12В этом примере проверяется подключение клиента по протоколу POP3 к конкретному серверу Contoso12 и проверяются все почтовые ящики Exchange.
Параметры
-ClientAccessServer
Параметр ClientAccessServer указывает сервер Exchange для проверки. На этом сервере установлена роль сервера клиентского доступа, и он отвечает за прием подключений клиентов.
Можно использовать любое значение, однозначно определяющее сервер. Примеры:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
| Type: | ServerIdParameter |
| 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, Exchange Server 2019 |
-Confirm
Переключатель подтверждения указывает, показывать или скрывать запрос подтверждения. Влияние этого параметра на командлет зависит от того, требуется ли командлету подтверждение перед выполнением.
- Деструктивные командлеты (например, командлеты Remove-*) имеют встроенную паузу, которая заставляет вас подтвердить команду перед продолжением. Можно пропускать запросы на подтверждение этих командлетов, используя следующий синтаксис:
-Confirm:$false. - Большинство других командлетов (например, командлеты New-* и Set-*) не имеют встроенной приостановки. Для этих командлетов указание переключателя Confirm без значения вводит паузу, которая заставляет вас подтвердить команду перед продолжением.
| Type: | SwitchParameter |
| Aliases: | cf |
| 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, Exchange Server 2019 |
-ConnectionType
Параметр ConnectionType определяет тип подключения к службе POP3. Допустимые значения:
- Plaintext
- Ssl
- Tls
| Type: | ProtocolConnectionType |
| 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, Exchange Server 2019 |
-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, Exchange Server 2019 |
-LightMode
Параметр LightMode указывает, что при выполнении команды необходимо выполнять только проверочный вход на сервер по протоколу POP3. Указывать значение для этого параметра необязательно.
Если этот параметр не используется, команда также проверяет получение сообщения по протоколу POP3.
| 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, Exchange Server 2019 |
-MailboxCredential
Параметр MailboxCredential указывает учетные данные почтового ящика, используемые для одного теста почтового ящика.
Для значения этого параметра требуется командлет Get-Credential. Чтобы приостановить эту команду и получить приглашение для ввода учетных данных, используйте значение (Get-Credential). Или перед выполнением этой команды сохраните учетные данные в переменной (например,$cred = Get-Credential), а затем используйте имя переменной ($cred) для этого параметра. Для получения дополнительной информации см. Get-Credential.
| Type: | PSCredential |
| 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, Exchange Server 2019 |
-MailboxServer
Параметр MailboxServer указывает сервер почтовых ящиков Exchange, который требуется протестировать. Этот параметр определяет внутренний сервер, принимающий прокси-подключения от интерфейсного сервера, к которому подключаются клиенты.
Параметр MailboxServer указывает сервер почтовых ящиков exExchange2k16 или exExchange2k13, который необходимо протестировать. Примеры:
- имя;
- различающееся имя (DN);
- ExchangeLegacyDN
- GUID
Если вы не используете этот параметр, то проверяются подключения ко всем серверам почтовых ящиков на локальном сайте Active Directory.
| Type: | ServerIdParameter |
| 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, Exchange Server 2019 |
-MonitoringContext
Параметр MonitoringContext включает в результаты связанные события мониторинга и данные счетчиков производительности. Для этого переключателя не требуется указывать значение.
Обычно события мониторинга и счетчики производительности включаются в результаты при передаче выходных данных в Microsoft System Center Operations Manager (SCOM).
| 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, Exchange Server 2019 |
-PerConnectionTimeout
Параметр PerConnectionTimeout указывает время ожидания завершения проверки подключения в секундах. Допустимые значения: от 0 до 120 секунд. Значение по умолчанию: 120 секунд.
Для этого параметра рекомендуется устанавливать значение не менее 5 секунд.
| Type: | Int32 |
| 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, Exchange Server 2019 |
-PortClientAccessServer
Параметр PortClientAccessServer указывает порт, который необходимо использовать для подключения к серверу клиентского доступа. По умолчанию для службы POP3 установлен порт 110. Допустимый диапазон значений: от 0 до 65 535.
| Type: | Int32 |
| 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, Exchange Server 2019 |
-ResetTestAccountCredentials
Параметр ResetTestAccountCredentials сбрасывает пароль для тестовой учетной записи, которая используется для выполнения команды. Указывать значение для этого параметра необязательно.
Пароль для тестовой учетной записи обычно сбрасывается каждые 7 дней. Используйте этот параметр для принудительного сброса пароля в любое время, если это необходимо для поддержания безопасности.
| 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, Exchange Server 2019 |
-Timeout
Параметр Timeout указывает время ожидания завершения проверки в секундах. Допустимые значения: от 0 до 3600 секунд (1 час). Значение по умолчанию равно 180 секундам (3 минутам).
Для этого параметра рекомендуется устанавливать значение не менее 5 секунд.
| Type: | UInt32 |
| 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, Exchange Server 2019 |
-TrustAnySSLCertificate
Параметр TrustAnySSLCertificate дает возможность системе Exchange принимать сертификаты из недоверенных центров сертификации (ЦС). Для этого переключателя не требуется указывать значение.
Параметр TrustAnySSLCertificate указывает, следует ли игнорировать сбои проверки SSL-сертификатов. Указывать значение для этого параметра необязательно.
| 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, Exchange Server 2019 |
-WhatIf
Переключатель WhatIf имитирует действия команды. Вы можете использовать его для просмотра результатов изменений без фактического внесения этих изменений. С этим параметром не нужно указывать значение.
| Type: | SwitchParameter |
| Aliases: | wi |
| 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, Exchange Server 2019 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по