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 |