Get-UnifiedGroup

Модуль:
Exchange PowerShell

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

Используйте командлет Get-UnifiedGroup для просмотра Группы Microsoft 365 в облачной организации. Чтобы просмотреть участников, владельцев и подписчиков Группы Microsoft 365, используйте командлет Get-UnifiedGroupLinks.

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

Синтаксис

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

Get-UnifiedGroup
    [[-Identity] <UnifiedGroupIdParameter>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

AnrSet 

Get-UnifiedGroup
    [-Anr <String>]
    [-Filter <String>]
    [-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames]
    [-IncludeAllProperties]
    [-IncludeBypassModerationFromSendersOrMembersWithDisplayNames]
    [-IncludeGrantSendOnBehalfToWithDisplayNames]
    [-IncludeModeratedByWithDisplayNames]
    [-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames]
    [-IncludeSoftDeletedGroups]
    [-ResultSize <Unlimited>]
    [-SortBy <String>]
    [<CommonParameters>]

Описание

Группы Microsoft 365 — это объекты-группы, доступные в службах Microsoft 365.

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

Примеры

Пример 1

Get-UnifiedGroup

В этом примере возвращается сводный список всех групп Microsoft 365.

Пример 2

Get-UnifiedGroup | Format-List DisplayName,EmailAddresses,Notes,ManagedBy,AccessType

В этом примере возвращаются следующие сведения обо всех Группах Microsoft 365:

  • Различающееся имя (DN)
  • адрес электронной почты;
  • Описание
  • Владельцы
  • Конфиденциальность

Пример 3

Get-UnifiedGroup -Identity "Marketing Department" | Format-List

В этом примере возвращаются подробные сведения о группе Microsoft 365 с названием "Отдел маркетинга".

Пример 4

Get-UnifiedGroup | Where-Object {-Not $_.ManagedBy}

В этом примере возвращаются группы Группы Microsoft 365, у которых нет владельца.

Пример 5

Get-UnifiedGroup -Filter {ResourceProvisioningOptions -eq "Team"}

В этом примере возвращаются группы Группы Microsoft 365, создаваемые при создании команды Майкрософт.

Параметры

-Anr

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

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

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

AnrSet
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Filter

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

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

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

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-Identity

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр Identity указывает группу Microsoft 365, которую вы хотите просмотреть. Вы можете использовать любое значение, которое уникально идентифицирует группу Microsoft 365. Например:

  • Имя
  • Псевдоним
  • различающееся имя (DN);
  • различающееся имя (DN);
  • Каноническое краткое имя
  • GUID

Примечание. Вы можете использовать значение DisplayName для идентификации группы Microsoft 365, но результаты не гарантируют, что они уникальны. Если необходимо вернуть уникальный и уникальный результат, используйте уникальный идентификатор для группы Microsoft 365.

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

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

Тип:UnifiedGroupIdParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

Identity
Position:1
Обязательно:False
Значение из конвейера:True
Значение из конвейера по имени свойства:True
Значение из оставшихся аргументов:False

-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames определяет, должны ли возвращаться SMTP-адреса и отображаемые имена получателей AcceptMessagesOnlyFromSendersOrMembers в свойстве AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames. С этим параметром не нужно указывать значение.

Этот переключатель был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот переключатель не используется, получатели AcceptMessagesOnlyFromSendersOrMembers отображаются как GUID, а свойство AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames пусто.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeAllProperties

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

Если не использовать этот параметр, значения некоторых свойств (например, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl и PhotoUrl) могут оказаться пустыми.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeBypassModerationFromSendersOrMembersWithDisplayNames

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IncludeBypassModerationFromSendersOrMembersWithDisplayNames определяет, следует ли возвращать SMTP-адреса и отображаемые имена получателей BypassModerationFromSendersOrMembers в свойстве BypassModerationFromSendersOrMembersWithDisplayNames. С этим параметром не нужно указывать значение.

Этот переключатель был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот переключатель не используется, получатели BypassModerationFromSendersOrMembers отображаются как GUID, а свойство BypassModerationFromSendersOrMembersWithDisplayNames пусто.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeGrantSendOnBehalfToWithDisplayNames

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IncludeGrantSendOnBehalfToWithDisplayNames определяет, следует ли возвращать SMTP-адреса и отображаемые имена получателей GrantSendOnBehalfTo в свойстве GrantSendOnBehalfToWithDisplayNames. С этим параметром не нужно указывать значение.

Этот переключатель был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот переключатель не используется, получатели GrantSendOnBehalfTo отображаются в виде GUID, а свойство GrantSendOnBehalfToWithDisplayNames пусто.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeModeratedByWithDisplayNames

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IncludeModeratedByWithDisplayNames определяет, следует ли возвращать SMTP-адреса и отображаемые имена получателей ModeratedBy в свойстве ModeratedByWithDisplayNames. С этим параметром не нужно указывать значение.

Этот переключатель был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот параметр не используется, получатели ModeratedBy отображаются в виде GUID, а свойство ModeratedByWithDisplayNames пусто.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Параметр IncludeRejectMessagesFromSendersOrMembersWithDisplayNames определяет, следует ли возвращать SMTP-адреса и отображаемые имена получателей RejectMessagesFromSendersOrMembers в свойстве RejectMessagesFromSendersOrMembersWithDisplayNames. С этим параметром не нужно указывать значение.

Этот переключатель был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот переключатель не используется, получатели ModeratedBy отображаются в виде GUID, а свойство RejectMessagesFromSendersOrMembersWithDisplayNames пусто.

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-IncludeSoftDeletedGroups

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

Переключатель IncludeSoftDeletedGroups указывает, следует ли включать программно удаленные Группы Microsoft 365 в результаты. С этим параметром не нужно указывать значение.

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

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

Тип:SwitchParameter
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-ResultSize

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

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

Тип:Unlimited
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

-SortBy

Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков

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

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

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

  • Имя
  • DisplayName
  • Alias

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

Тип:String
Значение по умолчанию:None
Поддерживаются подстановочные знаки:False
DontShow:False

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

(All)
Position:Named
Обязательно:False
Значение из конвейера:False
Значение из конвейера по имени свойства:False
Значение из оставшихся аргументов:False

CommonParameters

Этот командлет поддерживает общие параметры: -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction и -WarningVariable. Дополнительные сведения см. в статье about_CommonParameters.