Поделиться через


Get-MailboxSearch

Этот командлет доступен в локальной среде Exchange и в облачной службе. Некоторые параметры и настройки могут отличаться в зависимости от среды.

Используйте командлет Get-MailboxSearch, чтобы просмотреть поисковые запросы в почтовых ящиках, которые выполняются, завершены или остановлены.

Примечание. По состоянию на октябрь 2020 г. командлеты *-MailboxSearch не используются в Exchange Online PowerShell. Вместо этого используйте командлеты *-ComplianceSearch в PowerShell для соответствия требованиям безопасности & . Дополнительные сведения см. в статье Прекращение использования устаревших средств обнаружения электронных данных.

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

Синтаксис

Get-MailboxSearch
   [[-Identity] <SearchObjectIdParameter>]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxSearch
   [[-Identity] <EwsStoreObjectIdParameter>]
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]
Get-MailboxSearch
   -InPlaceHoldIdentity <String>
   [-ShowDeletionInProgressSearches]
   [-DomainController <Fqdn>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

В локальной среде Exchange поиск в почтовом ящике используется для выполнения In-Place обнаружения электронных данных или размещения пользователей в In-Place удержания. Командлет Get-MailboxSearch используется для получения сведений о поиске по почтовым ящикам любого типа.

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

Примеры

Пример 1

Get-MailboxSearch -ResultSize "unlimited"

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

Пример 2

Get-MailboxSearch "Project Hamilton" | Format-List

В этом примере возвращается список всех свойств в результате поиска в почтовом ящике Project Hamilton.

Параметр Identity является позиционным параметром. Позиционные параметры могут использоваться без метки (Identity). Дополнительные сведения о позиционных параметрах см. в разделе О параметрах.

Пример 3

(Get-Mailbox Mark).InPlaceHolds

Get-MailboxSearch -InPlaceHoldIdentity 9953d0f0fd03415e949d4b41c5a28cbb

В этом примере возвращаются режимы сохранения, назначенные для пользователя. Первая команда выводит идентификаторы GUID In-Place Holds. Последняя команда извлекает поиск в почтовом ящике на основе GUID In-Place Hold, в который помещен пользователь.

Параметры

-DomainController

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

Параметр 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

-Identity

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

Чтобы повысить производительность этого командлета в Exchange Online, некоторые свойства поиска почтовых ящиков не возвращаются, если не указать имя поиска в почтовом ящике. К таким свойствам относятся:

  • SourceMailboxes
  • Источники
  • SearchQuery
  • ResultsLink
  • PreviewResultsLink
  • Ошибки

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

Type:SearchObjectIdParameter
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, Exchange Online

-InPlaceHoldIdentity

Параметр InPlaceHoldIdentity указывает идентификатор GUID режима сохранения. Используйте этот параметр для поиска режима сохранения, назначенного для пользователя. Идентификаторы GUID всех операций хранения на месте добавляются в свойство InPlaceHolds. Это свойство можно извлечь с помощью командлета Get-Mailbox.

Type:String
Position:Named
Default value:None
Required:True
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online

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

-ShowDeletionInProgressSearches

Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.

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, Exchange Online

Входные данные

Input types

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

Выходные данные

Output types

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