你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Get-AzADGroup

参考

模块:: Az.Resources

按键列出组中的实体或从组获取实体

语法

Get-AzADGroup
   [-Count]
   [-Expand <String[]>]
   [-Select <String[]>]
   [-Filter <String>]
   [-Orderby <String[]>]
   [-Search <String>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-CountVariable <String>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayName <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   -DisplayNameStartsWith <String>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

Get-AzADGroup
   [-Expand <String[]>]
   [-Select <String[]>]
   [-ConsistencyLevel <String>]
   [-AppendSelected]
   -ObjectId <Guid>
   [-DefaultProfile <PSObject>]
   [<CommonParameters>]

说明

按键列出组中的实体或从组获取实体

示例

示例 1：按显示名称获取组

Get-AzADGroup -DisplayName $gname

按显示名称获取组

示例 2：列出组

Get-AzADGroup -First 10

列出前 10 个组

示例 3：按对象 ID 获取组

Get-AzADGroup -ObjectId $id -Select groupTypes -AppendSelected

按对象 ID 获取组，并在默认属性后追加属性“groupTypes”：“DisplayName”、“Id”、“DeletedDateTime”、“SecurityEnabled”、“MailEnabled”、“MailEnabled”、“MailNickname”、“Description”

示例 4：使用筛选器获取组

Get-AzADGroup -Filter "startsWith(DisplayName,'some-name')"

使用筛选器获取组

示例 5：将 OdataCount 分配到变量

Get-AzADGroup -First 10 -ConsistencyLevel eventual -Count -CountVariable 'result'
$result

将 OdataCount 分配到变量

参数

-AppendSelected

当此开关处于打开状态时，使用默认属性选择的追加属性，仅适用于参数“-Select”。

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ConsistencyLevel

指示请求的一致性级别。文档 URL：https://developer.microsoft.com/en-us/office/blogs/microsoft-graph-advanced-queries-for-directory-objects-are-now-generally-available/

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Count

包括项计数

类型:	SwitchParameter
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-CountVariable

指定集合中项总数的计数。默认情况下，此变量将在全局范围内设置。

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DefaultProfile

用于与 Azure 通信的凭据、帐户、租户和订阅。

类型:	PSObject
别名:	AzContext, AzureRmContext, AzureCredential
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-DisplayName

组的显示名称。

类型:	String
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-DisplayNameStartsWith

用于查找以提供的字符串开头的组。

类型:	String
别名:	SearchString
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Expand

展开相关实体

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Filter

按属性值筛选项，有关筛选查询的更多详细信息，请参阅：https://learn.microsoft.com/en-us/graph/filter-query-parameter

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-First

仅获取第一个“n”对象。

类型:	UInt64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-ObjectId

键：组 ID

类型:	Guid
Position:	Named
默认值:	None
必需:	True
接受管道输入:	False
接受通配符:	False

-Orderby

按属性值对项进行排序

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Search

按搜索短语搜索项目

类型:	String
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Select

选择要返回的属性

类型:	String[]
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

-Skip

忽略第一个“n”对象，然后获取剩余的对象。

类型:	UInt64
Position:	Named
默认值:	None
必需:	False
接受管道输入:	False
接受通配符:	False

输出

IMicrosoftGraphGroup

通过