Get-SiteMailbox

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

Этот командлет доступен только в локальной среде Exchange.

Командлет Get-SiteMailbox используется для просмотра сведений о почтовых ящиках сайта. Этот командлет в основном используется Майкрософт SharePoint и Exchange для отображения информации пользователям в пользовательском интерфейсе. С помощью него можно получить полезные сведения о владельцах почтовых ящиков сайта, участниках и состоянии жизненного цикла.

Почтовые ящики сайтов были устарели в Exchange Online и SharePoint Online в 2017 году. Дополнительные сведения см. в разделе Прекращение поддержки почтовых ящиков сайта.

Сведения о наборах параметров в разделе Синтаксис ниже см. В разделе Синтаксис командлета Exchange.

Синтаксис

Get-SiteMailbox
   [[-Identity] <RecipientIdParameter>]
   [-Anr <String>]
   [-BypassOwnerCheck]
   [-DeletedSiteMailbox]
   [-DomainController <Fqdn>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

Пользователи, не являющиеся членами или владельцами почтового ящика сайта, диагностическую информацию о котором им необходимо просмотреть, должны использовать параметр BypassOwnerCheck для запуска этого командлета. Пользователи, не являющиеся членами или владельцами почтового ящика сайта, которые запускают командлет без использования параметра BypassOwnerCheck, вызовут сбой команды с ошибкой "Объект не найден".

Для его запуска необходимо получить соответствующие разрешения. В этой статье перечислены все параметры командлета. Но некоторые из них могут быть вам не доступны, если они не включены в назначенные разрешения. Сведения о необходимых разрешениях для запуска командлетов и использования параметров в организации см. в статье Find the permissions required to run any Exchange cmdlet.

Примеры

Пример 1

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite

В этом примере возвращаются сведения по умолчанию о contentSite почтового ящика сайта, включая имя сайта, время закрытия почтового ящика сайта и URL-адрес SharePoint.

Пример 2

Get-SiteMailbox -BypassOwnerCheck -Identity ContentSite | Format-List

В этом примере показано возвращение полных сведений о почтовом ящике сайта ContentSite.

Пример 3

Get-SiteMailbox -BypassOwnerCheck -DeletedSiteMailbox | Remove-Mailbox -Confirm:$false

В этом примере показано, как выполнить запрос к почтовым ящикам сайта, помеченным для удаления, и удалить их из базы данных почтовых ящиков, передав данные в командлет Remove-Mailbox.

Параметры

-Anr

Параметр Anr определяет строку, по которой будет выполнен поиск с разрешением неоднозначных имен (ANR). Можно задать частичное строковое значение и выполнить поиск объектов с атрибутом, который совпадает с этой строкой. По умолчанию искомыми атрибутами являются:

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias (Псевдоним)
Type:String
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

-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

-DeletedSiteMailbox

Параметр DeletedSiteMailbox возвращает почтовые ящики сайта, помеченные как ожидающие удаления. Указывать значение для этого параметра необязательно.

Когда приложение жизненного цикла в SharePoint закрывает почтовый ящик сайта, почтовый ящик сайта сохраняется в течение периода, указанного в политике жизненного цикла, в закрытом состоянии. Затем почтовый ящик может быть повторно активирован конечным пользователем или администратором SharePoint. По истечении срока хранения для почтового ящика сайта Exchange, размещенного в базе данных почтовых ящиков, имя будет отмечено как MDEL: чтобы указать, что он помечается для удаления. Чтобы освободить место в хранилище и псевдоним, используйте командлет Remove-Mailbox, чтобы вручную удалить эти почтовые ящики сайта из базы данных почтовых ящиков.

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

-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 2013, Exchange Server 2016, Exchange Server 2019

-Identity

Параметр Identity задает идентификатор нужного почтового ящика сайта. Вы можете использовать любое значение, которое однозначно определяет почтовый ящик. Пример.

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID
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

-ReadFromDomainController

Переключатель ReadFromDomainController указывает, что сведения будут считываться из контроллера домена в домене пользователя. Указывать значение для этого параметра необязательно.

Для Set-AdServerSettings -ViewEntireForest $true включения всех объектов в лесу требуется параметр ReadFromDomainController. В противном случае команда может использовать глобальный каталог, содержащий устаревшие сведения. Кроме того, для получения сведений может потребоваться выполнить несколько итераций команды с параметром ReadFromDomainController.

По умолчанию в качестве области получателя задается домен, в котором размещаются серверы Exchange.

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

-ResultSize

Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.

Type:Unlimited
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

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