Get-UnifiedGroup
Этот командлет доступен только в облачной службе.
Используйте командлет 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, созданные при создании Microsoft Team.
Параметры
-Anr
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Этот параметр зарезервирован для внутреннего использования корпорацией Майкрософт.
Свойства параметров
| Тип: | String |
| Default value: | 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 см. в разделе Фильтруемые свойства для параметра 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.
Свойства параметров
| Тип: | String |
| Default value: | 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 |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
Identity
| Position: | 1 |
| Обязательно: | False |
| Значение из конвейера: | True |
| Значение из конвейера по имени свойства: | True |
| Значение из оставшихся аргументов: | False |
-IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeAcceptMessagesOnlyFromSendersOrMembersWithDisplayNames указывает, следует ли возвращать SMTP-адреса и отображаемые имена получателей AcceptMessagesOnlyFromSendersOrMembers в свойстве AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames. С этим параметром не нужно указывать значение.
Этот параметр был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот параметр не используется, получатели AcceptMessagesOnlyFromSendersOrMembers отображаются как идентификаторы GUID, а свойство AcceptMessagesOnlyFromSendersOrMembersWithDisplayNames будет пустым.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeAllProperties
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeAllProperties указывает, следует ли включать значения всех свойств в результаты. С этим параметром не нужно указывать значение.
Если этот параметр не используется, значения некоторых свойств (например, CalendarMemberReadOnly, CalendarUrl, InboxUrl, PeopleUrl и PhotoUrl) могут показаться пустыми.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeBypassModerationFromSendersOrMembersWithDisplayNames
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeBypassModerationFromSendersOrMembersWithDisplayNames указывает, следует ли возвращать SMTP-адреса и отображаемые имена получателей BypassModerationFromSendersOrMembers в свойстве BypassModerationFromSendersOrMembersWithDisplayNames. С этим параметром не нужно указывать значение.
Этот параметр был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот параметр не используется, получатели BypassModerationFromSendersOrMembers отображаются как идентификаторы GUID, а свойство BypassModerationFromSendersOrMembersWithDisplayNames пусто.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeGrantSendOnBehalfToWithDisplayNames
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeGrantSendOnBehalfToWithDisplayNames указывает, следует ли возвращать SMTP-адреса и отображаемые имена получателей GrantSendOnBehalfTo в свойстве GrantSendOnBehalfToWithDisplayNames. С этим параметром не нужно указывать значение.
Этот параметр был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот параметр не используется, получатели GrantSendOnBehalfTo отображаются как идентификаторы GUID, а свойство GrantSendOnBehalfToWithDisplayNames будет пустым.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeModeratedByWithDisplayNames
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeModeratedByWithDisplayNames указывает, следует ли возвращать SMTP-адреса и отображаемые имена получателей ModeratedBy в свойстве ModeratedByWithDisplayNames. С этим параметром не нужно указывать значение.
Этот параметр был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот параметр не используется, получатели ModeratedBy отображаются как идентификаторы GUID, а свойство ModeratedByWithDisplayNames пусто.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeRejectMessagesFromSendersOrMembersWithDisplayNames
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeRejectMessagesFromSendersOrMembersWithDisplayNames указывает, следует ли возвращать SMTP-адреса и отображаемые имена получателей RejectMessagesFromSendersOrMembers в свойстве RejectMessagesFromSendersOrMembersWithDisplayNames. С этим параметром не нужно указывать значение.
Этот параметр был введен для восстановления удобочитаемых идентификаторов в результатах командлета. Если этот параметр не используется, получатели ModeratedBy отображаются в виде идентификаторов GUID, а свойство RejectMessagesFromSendersOrMembersWithDisplayNames пусто.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-IncludeSoftDeletedGroups
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр IncludeSoftDeletedGroups указывает, следует ли включать обратимо удаленные Группы Microsoft 365 в результаты. С этим параметром не нужно указывать значение.
Обратимо удаленные Группы Microsoft 365 — это удаленные группы, которые по-прежнему можно восстановить.
Свойства параметров
| Тип: | SwitchParameter |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-ResultSize
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр ResultSize указывает максимальное число возвращаемых результатов. Если требуется возвратить все результаты, отвечающие условиям запроса, используйте для этого параметра значение unlimited. Значение по умолчанию — 1000.
Свойства параметров
| Тип: | Unlimited |
| Default value: | None |
| Поддерживаются подстановочные знаки: | False |
| DontShow: | False |
Наборы параметров
(All)
| Position: | Named |
| Обязательно: | False |
| Значение из конвейера: | False |
| Значение из конвейера по имени свойства: | False |
| Значение из оставшихся аргументов: | False |
-SortBy
Применимо: Exchange Online, встроенная надстройка безопасности для локальных почтовых ящиков
Параметр SortBy указывает свойство, по которому необходимо сортировать результаты. Вы можете выполнять сортировку не более, чем по одному свойству одновременно. Результаты будут отсортированы в порядке возрастания.
Если в представлении по умолчанию нет свойства, по которым выполняется сортировка, можно добавить команду с | Format-Table -Auto Property1,Property2,...PropertyXпомощью . , чтобы создать новое представление, содержащее все свойства, которые нужно просмотреть. В именах свойств поддерживаются подстановочные знаки (*).
Можно выполнять сортировку по следующим свойствам:
- Имя
- DisplayName
- Alias
Свойства параметров
| Тип: | String |
| Default value: | 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.