Test-SiteMailbox
Этот командлет доступен только в локальной среде Exchange.
Используйте командлет Test-SiteMailbox, чтобы проверить почтовый ящик сайта для Майкрософт подключения к SharePoint и проверить, имеют ли пользователи правильные разрешения на использование почтового ящика сайта. Этот командлет следует использовать для устранения неполадок и диагностических целей.
Почтовые ящики сайтов были устарели в Exchange Online и SharePoint Online в 2017 году. Дополнительные сведения см. в разделе Прекращение поддержки почтовых ящиков сайта.
Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.
Синтаксис
Test-SiteMailbox
[[-Identity] <RecipientIdParameter>]
[-BypassOwnerCheck]
[-Confirm]
[-RequestorIdentity <RecipientIdParameter>]
[-SharePointUrl <Uri>]
[-UseAppTokenOnly]
[-WhatIf]
[<CommonParameters>]
Описание
Если параметр RequestorIdentity не указан, команда использует идентификатор пользователя, выполняющего данную команду.
Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.
Примеры
Пример 1
Test-SiteMailbox -BypassOwnerCheck -SharePointUrl "https://myserver/teams/edu"
В этом примере проверяется только подключение сайта SharePoint. Эту команду можно использовать до создания почтового ящика сайта или в случае проблем с созданием почтового ящика сайта.
Пример 2
Test-SiteMailbox -BypassOwnerCheck -Identity mysitemailbox@contoso.com -UseAppTokenOnly
В этом примере проверяется подключение сервера Exchange Server к существующему почтовому ящику сайта с помощью параметров Identity и UseAppTokenOnly. Параметр Identity указывает почтовый ящик сайта, а параметр UseAppTokenOnly указывает, что требуется выполнить тестирование под удостоверением сервера Exchange Server. Запускайте эту команду для устранения неполадок синхронизации документации.
Пример 3
Test-SiteMailbox -BypassOwnerCheck -RequestorIdentity "kweku@contoso.com" -SharePointUrl "https://myserver/teams/edu"
В этом примере проверяется возможность доступа конкретного пользователя к сайту SharePoint с помощью параметра RequestorIdentity.
Параметры
-BypassOwnerCheck
Параметр BypassOwnerCheck используется, если учетная запись, выполняющая команду, не является членом или владельцем почтового ящика сайта. Указывать значение для этого параметра необязательно.
Если этот параметр не используется и вы не являетесь членом или владельцем почтового ящика сайта, команда завершится ошибкой.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, Exchange Server 2016, Exchange Server 2019 |
-Identity
Параметр Identity указывает почтовый ящик сайта, который требуется проверить. Можно использовать любое значение, однозначно определяющее почтовый ящик сайта. Например:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Этот параметр невозможно использовать вместе с параметром SharePointUrl.
Type: | RecipientIdParameter |
Position: | 1 |
Default value: | None |
Required: | False |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-RequestorIdentity
Параметр RequestorIdentity указывает пользователя для проверки правильности разрешений для почтового ящика сайта SharePoint. Можно использовать любое уникальное значение, идентифицирующее пользователя. Пример:
- Имя
- Псевдоним
- различающееся имя (DN);
- различающееся имя (DN);
- Каноническое краткое имя
- GUID
Этот параметр невозможно использовать вместе с параметром UseAppTokenOnly.
Если этот параметр не указан, команда использует идентификатор пользователя, выполняющего данную команду.
Type: | RecipientIdParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-SharePointUrl
Параметр SharePointUrl указывает URL-адрес SharePoint, в котором размещен почтовый ящик сайта, например "https://myserver/teams/edu".
Имя базы данных
Type: | Uri |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | Exchange Server 2013, Exchange Server 2016, Exchange Server 2019 |
-UseAppTokenOnly
Параметр UseAppTokenOnly указывает, что требуется протестировать почтовый ящик сайта с помощью удостоверения сервера Exchange Server. Указывать значение для этого параметра необязательно.
Этот параметр нельзя использовать с параметром RequestorIdentity.
Type: | SwitchParameter |
Position: | Named |
Default value: | None |
Required: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
Applies to: | 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 2013, Exchange Server 2016, Exchange Server 2019 |
Входные данные
Input types
Сведения о типах входных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип ввода для командлета пустое, командлет не принимает входные данные.
Выходные данные
Output types
Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.