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


Get-EXORecipient

Этот командлет доступен только в модуле PowerShell Exchange Online. Дополнительные сведения см. в разделе Сведения о модуле PowerShell Exchange Online.

Используйте командлет Get-ExORecipient для просмотра существующих объектов получателей в организации. Этот командлет возвращает все объекты с включенной поддержкой почты (например, почтовые ящики, пользователей почты, почтовые контакты и группы рассылки).

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

Синтаксис

Get-EXORecipient
   [[-Identity] <String>]
   [-ExternalDirectoryObjectId <Guid>]
   [-Filter <String>]
   [-IncludeSoftDeletedRecipients]
   [-OrganizationalUnit <String>]
   [-PrimarySmtpAddress <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-RecipientPreviewFilter <String>]
   [-RecipientType <String[]>]
   [-RecipientTypeDetails <String[]>]
   [-ResultSize <Unlimited>]
   [-UserPrincipalName <String>]
   [<CommonParameters>]
Get-EXORecipient
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeSoftDeletedRecipients]
   [-OrganizationalUnit <String>]
   [-Properties <String[]>]
   [-PropertySets <PropertySet[]>]
   [-RecipientPreviewFilter <String>]
   [-RecipientType <String[]>]
   [-RecipientTypeDetails <String[]>]
   [-ResultSize <Unlimited>]
   [<CommonParameters>]

Описание

Get-EXORecipient командлет можно использовать для просмотра существующих объектов получателей в организации. Этот командлет возвращает все объекты с включенной поддержкой почты (например, почтовые ящики, пользователей почты, почтовые контакты и группы рассылки).

Примеры

Пример 1

Get-EXORecipient -ResultSize 100

В этом примере возвращаются первые 100 объектов получателей в порядке сортировки имен.

Пример 2

Get-EXORecipient -Identity john@contosot.com

В этом примере возвращаются сведения об атрибуте получателя для пользователя. john@contoso.com

Параметры

-Anr

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

  • CommonName (CN)
  • DisplayName
  • FirstName
  • LastName
  • Alias (Псевдоним)

Этот параметр нельзя использовать с параметрами ExternalDirectoryObjectId, Identity, PrimarySmtpAddress или UserPrincipalName.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-ExternalDirectoryObjectId

Параметр ExternalDirectoryObjectId определяет получателя, который вы хотите просмотреть с помощью ObjectId в Azure Active Directory.

Этот параметр нельзя использовать с параметрами Anr, Identity, PrimarySmtpAddress или UserPrincipalName.

Type:Guid
Position:Named
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-Filter

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

  • Заключите весь фильтр OPATH в двойные кавычки "". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
  • Property — это свойство с поддержкой фильтрации. Дополнительные сведения о фильтруемых свойствах см. в разделах Наборы свойств Get-EXORecipient и Фильтруемые свойства для параметра Filter.
  • ComparisonOperator — это оператор сравнения OPATH (например -eq , для равных и -like для сравнения строк). Подробнее об операторах сравнения см. в статье about_Comparison_Operators.
  • Value — это значение свойства для поиска. Заключите текстовые значения и переменные в одиночные кавычки ('Value' или '$Variable'). Если значение переменной содержит одиночные кавычки, необходимо определить (избежать) одиночные кавычки, чтобы правильно развернуть переменную. Например, вместо '$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
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-Identity

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

  • Идентификатор пользователя или имя участника-пользователя
  • GUID

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

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • Домен\Имя пользователя
  • Адрес электронной почты
  • LegacyExchangeDN
  • SamAccountName

Этот параметр нельзя использовать с параметрами Anr, ExternalDirectoryObjectId, PrimarySmtpAddress или UserPrincipalName.

Type:String
Position:0
Default value:None
Required:False
Accept pipeline input:True
Accept wildcard characters:False
Applies to:Exchange Online

-IncludeSoftDeletedRecipients

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

Обратимо удаленные получатели — это получатели, которые по-прежнему можно восстановить.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-OrganizationalUnit

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

  • Имя
  • Имя
  • различающееся имя (DN);
  • GUID
Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PrimarySmtpAddress

PrimarySmtpAddress определяет получателя, которого вы хотите просмотреть по основному SMTP-адресу электронной почты (например, navin@contoso.com).

Этот параметр нельзя использовать с параметрами Anr, ExternalDirectoryObjectId, Identity или UserPrincipalName.

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

-Properties

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

Дополнительные сведения о доступных свойствах см. в разделе Наборы свойств Get-EXORecipient.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-PropertySets

Параметр PropertySets задает логическое группирование свойств, возвращаемых в выходных данных этого командлета. Допустимые значения:

  • Минимум (это значение по умолчанию)
  • Архив
  • Пользовательские
  • MailboxMove
  • Политика

Дополнительные сведения о свойствах, включенных в каждый набор свойств, см. в разделе Наборы свойств Get-EXORecipient.

Type:PropertySet[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RecipientPreviewFilter

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

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RecipientType

Параметр RecipientType фильтрует результаты по указанному типу получателя. Допустимые значения:

  • DynamicDistributionGroup
  • MailContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PublicFolder
  • UserMailbox

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

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to:Exchange Online

-RecipientTypeDetails

Параметр RecipientTypeDetails фильтрует результаты по указанному подтипу получателя. Допустимые значения:

  • DiscoveryMailbox
  • DynamicDistributionGroup
  • EquipmentMailbox
  • GroupMailbox
  • GuestMailUser
  • Устаревшая версияMailbox
  • LinkedMailbox
  • LinkedRoomMailbox
  • MailContact
  • MailForestContact
  • MailNonUniversalGroup
  • MailUniversalDistributionGroup
  • MailUniversalSecurityGroup
  • MailUser
  • PublicFolder
  • PublicFolderMailbox
  • RemoteEquipmentMailbox
  • RemoteRoomMailbox
  • RemoteSharedMailbox
  • RemoteTeamMailbox
  • RemoteUserMailbox
  • RoomList
  • RoomMailbox
  • SchedulingMailbox
  • SharedMailbox
  • SharedWithMailUser
  • TeamMailbox
  • UserMailbox

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

Значение параметра RecipientType влияет на значения, которые можно использовать для этого параметра. Например, если вы используете значение RecipientType MailContact, вы не сможете использовать значение UserMailbox для этого параметра. Вы получите сообщение об ошибке: ни один из указанных RecipientTypeDetails не включен в указанный тип получателя.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False
Applies to: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 Online

-UserPrincipalName

Параметр UserPrincipalName определяет получателя, который нужно просмотреть по имени участника-пользователя (например, navin@contoso.onmicrosoft.com).

Этот параметр нельзя использовать с параметрами Anr, ExternalDirectoryObjectId, Identity или PrimarySmtpAddress.

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