Test-SiteMailbox

  • Ссылка
Модуль:
ExchangePowerShell
Применяется к:
Exchange Server 2013, Exchange Server 2016, Exchange Server 2019

Этот командлет доступен только в локальной среде 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

Сведения о типах возвращаемых данных, которые также называются типами выходных данных, которые принимает этот командлет, см. в разделе Типы входных и выходных данных командлетов. Если поле Тип вывода пусто, командлет не возвращает данные.