Get-UnifiedGroup

参考

模块:: ExchangePowerShell

适用于:: Exchange Online, Exchange Online Protection

此 cmdlet 仅在基于云的服务中可用。

使用 Get-UnifiedGroup cmdlet 查看基于云的组织中的Microsoft 365 组。若要查看Microsoft 365 组的成员、所有者和订阅者，请使用 Get-UnifiedGroupLinks cmdlet。

有关以下语法部分的参数设置的详细信息，请参阅 Exchange cmdlet 语法。

语法

Get-UnifiedGroup
   [[-Identity] <UnifiedGroupIdParameter>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

Get-UnifiedGroup
   [-Anr <String>]
   [-Filter <String>]
   [-IncludeAllProperties]
   [-IncludeSoftDeletedGroups]
   [-ResultSize <Unlimited>]
   [-SortBy <String>]
   [<CommonParameters>]

说明

Microsoft 365 组是跨 Microsoft 365 服务可用的组对象。

您必须先获得权限，然后才能运行此 cmdlet。虽然本主题中列出了此 cmdlet 的所有参数，但如果这些参数并未包含在分配给您的权限中，那么您将无法使用这些参数。若要查找在贵组织中运行任何 cmdlet 或参数所需的权限，请参阅 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)
电子邮件地址
说明
Owners
隐私

示例 3

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

此示例返回有关名为 Marketing Department 的 Microsoft 365 组的详细信息。

示例 4

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

此示例返回没有所有者Microsoft 365 组。

示例 5

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

此示例返回创建Microsoft团队时创建的Microsoft 365 组。

参数

-Anr

保留此参数以供 Microsoft 内部使用。

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

-Filter

Filter 参数使用 OPATH 语法按指定的属性和值筛选结果。搜索条件使用语法 "Property -ComparisonOperator 'Value'"。

将整个 OPATH 筛选器括在双引号“”中。如果筛选器包含系统值 (，例如 $true、 $false或 $null) ，请改用单引号 ' 。虽然此参数是一个字符串 (不是) 的系统块，但也可以使用大括号 { }，但前提是筛选器不包含变量。
属性是可筛选的属性。有关 Exchange server 和 Exchange Online 中的可筛选属性的详细信息，请参阅 Filterable properties for the Filter 参数。
ComparisonOperator 是一个 OPATH 比较运算符， (例如 -eq 用于等于和 -like 字符串比较) 。有关比较运算符的详细信息，请参阅 about_Comparison_Operators。
Value 是要搜索的属性值。将文本值和变量括在单引号 ('Value' 或 '$Variable') 。如果变量值包含单引号，则需要识别 (转义) 单引号才能正确展开变量。例如，使用 '$($User -Replace "'","''")'而不是 '$User'。不要将整数或系统值括在引号 (例如，改用 500、 $true、 $false或 $null) 。

可以使用逻辑运算符 -and 和 -or将多个搜索条件链接在一起。例如，"Criteria1 -and Criteria2" 或 "(Criteria1 -and Criteria2) -or Criteria3"。

有关 Exchange 中的 OPATH 筛选器的详细信息，请参阅其他 OPATH 语法信息。

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

-Identity

Identity 参数指定要查看的 Microsoft 365 组。可以使用唯一标识 Microsoft 365 组的任何值。例如：

名称
别名
可分辨名称 (DN)
可分辨名称 (DN)
规范 DN
GUID

注意：可以使用 DisplayName 值来标识Microsoft 365 组，但结果不保证是唯一的。如果必须返回单一且唯一的结果，请使用Microsoft 365 组的唯一标识符。

Type:	UnifiedGroupIdParameter
Position:	1
Default value:	None
Required:	False
Accept pipeline input:	True
Accept wildcard characters:	False
Applies to:	Exchange Online, Exchange Online Protection

-IncludeAllProperties

IncludeAllProperties 开关指定是否在结果中包含所有属性的值。不必为此开关指定值。

如果不使用此开关，某些属性的值 (例如 CalendarMemberReadOnly、CalendarUrl、InboxUrl、PeopleUrl 和 PhotoUrl) 可能会显示为空白。

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

-IncludeSoftDeletedGroups

IncludeSoftDeletedGroups 开关指定是否在结果中包含软删除Microsoft 365 组。不必为此开关指定值。

软删除Microsoft 365 组是仍可恢复的已删除组。

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

-ResultSize

ResultSize 参数指定了要返回的结果的最大数量。若要返回所有与查询相匹配的请求，则请将此参数的值设为无限制。默认值为 1000。

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

-SortBy

SortBy 参数指定用作结果排序依据的属性。每次只能按一个属性进行排序。结果将按升序进行排序。

如果默认视图不包括要排序依据的属性，则可以使用 | Format-Table -Auto Property1,Property2,...PropertyX追加命令。创建包含要查看的所有属性的新视图。支持在属性名称中使用通配符 (*)。

可以按下列属性排序：

名称
DisplayName
别名

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