Get-MailUser

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

Используйте командлет Get-MailUser для просмотра почтовых пользователей, а также гостевых пользователей для групп Microsoft 365 в облачных средах.

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

Синтаксис

Get-MailUser
   [-Anr <String>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [-SoftDeletedMailUser]
   [-SortBy <String>]
   [<CommonParameters>]
Get-MailUser
   [[-Identity] <MailUserIdParameter>]
   [-Credential <PSCredential>]
   [-DomainController <Fqdn>]
   [-Filter <String>]
   [-IgnoreDefaultScope]
   [-OrganizationalUnit <OrganizationalUnitIdParameter>]
   [-ReadFromDomainController]
   [-ResultSize <Unlimited>]
   [-SoftDeletedMailUser]
   [-SortBy <String>]
   [<CommonParameters>]

Описание

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

Примеры

Пример 1

Get-MailUser

Этот пример возвращает сводный список всех пользователей почты в организации.

Пример 2

Get-MailUser -Identity Ed | Format-List

В этом примере возвращаются подробные сведения для почтового пользователя с именем ED.

Параметры

-— ANR

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

  • Коммоннаме (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-— Credential

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

Параметр Credential указывает имя пользователя и пароль, используемые для выполнения этой команды. Как правило, этот параметр используется в сценариях, или если требуется указывать различные учетные данные, которые предоставляют необходимые разрешения.

Для этого параметра необходимо создавать и передавать объект учетных данных. Этот объект создается с помощью командлета Get-Credential. Для получения дополнительной информации см. Get-Credential.

Type:PSCredential
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— Filter

Параметр Filter использует синтаксис OPath для фильтрации результатов по указанным свойствам и значениям. В условиях поиска используется синтаксис "Property -ComparisonOperator 'Value'" .

  • Заключите весь фильтр OPath в двойные кавычки "". Если фильтр содержит системные значения (например,, $true $false или $null ), используйте одинарные кавычки ' '. Несмотря на то, что этот параметр является строкой (не системным блоком), можно также использовать фигурные скобки {}, только если фильтр не содержит переменных.
  • Свойство является фильтруемым свойством. Дополнительные сведения о фильтруемых свойствах можно узнать в статье фильтруемые свойства для параметра Filter.
  • Компарисоноператор — это оператор сравнения OPath (например -eq , для Equals и -like для сравнения строк). Дополнительные сведения об операторах сравнения можно найти в статье about_Comparison_Operators.
  • Value — это искомое значение свойства. Заключите текстовые значения и переменные в одинарные кавычки ( 'Value' или '$Variable' ). Если значение переменной содержит одиночные кавычки, необходимо определить (ESC) одинарные кавычки, чтобы правильно развернуть переменную. Например, вместо '$User' , используйте '$($User -Replace "'","''")' . Не включайте целые числа и системные значения (например,,, 500 , $true $false или $null ).

Вы можете связать несколько критериев поиска вместе, используя логические операторы -and и -or . Например, "Criteria1 -and Criteria2" или "(Criteria1 -and Criteria2) -or Criteria3" .

Подробные сведения о фильтрах OPath в Exchange приведены в статье Дополнительные сведения о синтаксисе OPATH.

Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-— IgnoreDefaultScope

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

Параметр IgnoreDefaultScope указывает, что при выполнении команды необходимо игнорировать параметр, определяющий для сеанса командной консоли Exchange область получателя по умолчанию, и задает в качестве области действия весь лес. Это позволяет команде получать доступ к объектам Active Directory, которые в настоящее время недоступны в области по умолчанию.

При использовании параметра IgnoreDefaultScope действуют следующие ограничения:

  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
  • При этом параметр DomainController использовать нельзя. Команда автоматически использует соответствующий сервер глобального каталога.
Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— OrganizationalUnit

Параметр OrganizationalUnit фильтрует результаты на основе расположения объекта в Active Directory. Возвращаются только те объекты, которые существуют в указанном расположении. Допустимые входные данные для этого параметра — это подразделение (OU) или домен, возвращенные командлетом Get-OrganizationalUnit. Вы можете использовать любое значение, уникальным образом определяющее подразделение или домен. Пример:

  • Имя
  • Имя
  • различающееся имя (DN);
  • GUID
Type:OrganizationalUnitIdParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-— ReadFromDomainController

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

Переключатель ReadFromDomainController указывает, что сведения будут считываться из контроллера домена в домене пользователя. Если выполнить команду Set-AdServerSettings -ViewEntireForest $true для включения всех объектов в лесу и переключатель ReadFromDomainController не используется, сведения могут быть считаны из глобального каталога с устаревшими данными. Если переключатель ReadFromDomainController используется, возможно, понадобится выполнить считывание несколько раз, чтобы получить сведения. Значение этого параметра указывать необязательно.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-— ResultSize

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

Type:Unlimited
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-— SortBy

Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.

Если представление по умолчанию не включает свойство, по которому выполняется сортировка, можно добавить команду с параметром | Format-Table -Auto Property1,Property2,...PropertyX . для создания представления, которое содержит все свойства, которые вы хотите просмотреть. *В именах свойств поддерживаются подстановочные знаки ().

Можно выполнять сортировку по следующим свойствам:

  • Имя
  • DisplayName
  • Alias
Type:String
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection
-— Софтделетедмаилусер

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

Параметр Софтделетедмаилусер указывает, следует ли включать в результаты необратимо удаленные пользователи почты. С этим параметром не нужно указывать значение.

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

Type:SwitchParameter
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online, Exchange Online Protection
-DomainController

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

Параметр DomainController указывает контроллер домена, который используется этим командлетом для чтения или записи данных в Active Directory. Вы определяете контроллер домена по его полному доменному имени (FQDN). Например, dc01.contoso.com.

Type:Fqdn
Position:Named
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019
-Identity

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID
Type:MailUserIdParameter
Position:1
Default value:None
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Server 2010, Exchange Server 2013, Exchange Server 2016, Exchange Server 2019, Exchange Online, Exchange Online Protection

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

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

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

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