Get-EXORecipient

Синтаксис

Identity (По умолчанию)

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>]

Anr

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

Описание

Примеры

Пример 1

Get-EXORecipient -ResultSize 100

Пример 2

Get-EXORecipient -Identity john@contoso.com

Параметры

-Anr

Применимо: Exchange Online

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

• CommonName (CN)
• DisplayName
• FirstName
• LastName
• Alias

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

Свойства параметров

Наборы параметров

-ExternalDirectoryObjectId

Применимо: Exchange Online

Параметр ExternalDirectoryObjectId определяет получателя, которого нужно просмотреть по ObjectId в Microsoft Entra ID.

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

Свойства параметров

Наборы параметров

-Filter

Применимо: Exchange Online

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

• Заключите весь фильтр OPATH в двойные кавычки " ". Если фильтр содержит системные значения (например, $true, $false или $null), используйте одиночные кавычки ' '. Хотя этот параметр является строкой (а не системным блоком), вы также можете использовать фигурные скобки { }, но только если фильтр не содержит переменные.
• Property — это свойство с поддержкой фильтрации. Дополнительные сведения о фильтруемых свойствах см. в разделе Наборы свойств Get-EXORecipient и Фильтруемые свойства для параметра Фильтр.
• 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".

Свойства параметров

Наборы параметров

-Identity

Применимо: Exchange Online

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

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

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

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

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

Внимание: значение $null или несуществующее значение параметра Identity возвращает все объекты так, как если бы вы выполнили команду Get- без параметра Identity. Убедитесь, что все списки значений для параметра Identity точны и не содержат несуществующих значений $null.

Свойства параметров

Наборы параметров

-IncludeSoftDeletedRecipients

Применимо: Exchange Online

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

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

Свойства параметров

Наборы параметров

-OrganizationalUnit

Применимо: Exchange Online

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

• Имя
• Имя
• различающееся имя (DN);
• GUID

Свойства параметров

Наборы параметров

-PrimarySmtpAddress

Применимо: Exchange Online

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

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

Свойства параметров

Наборы параметров

-Properties

Применимо: Exchange Online

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

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

Свойства параметров

Наборы параметров

-PropertySets

Применимо: Exchange Online

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

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

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

Свойства параметров

Наборы параметров

-RecipientPreviewFilter

Применимо: Exchange Online

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

Свойства параметров

Наборы параметров

-RecipientType

Применимо: Exchange Online

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

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

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

Свойства параметров

Наборы параметров

-RecipientTypeDetails

Применимо: Exchange Online

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

• DiscoveryMailbox
• DynamicDistributionGroup
• ОборудованиеПочтовый ящик
• GroupMailbox
• GuestMailUser
• LegacyMailbox
• 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 не включается ни в один из указанных типов получателей".

Свойства параметров

Наборы параметров

-ResultSize

Применимо: Exchange Online

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

Свойства параметров

Наборы параметров

-UserPrincipalName

Применимо: Exchange Online

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

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

Свойства параметров

Наборы параметров

CommonParameters