Get-AzADGroup
语法
EmptyParameterSet （默认值）
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>]
DisplayNameParameterSet
Get-AzADGroup
-DisplayName <String>
[-Expand <String[]>]
[-Select <String[]>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
SearchStringParameterSet
Get-AzADGroup
-DisplayNameStartsWith <String>
[-Expand <String[]>]
[-Select <String[]>]
[-ConsistencyLevel <String>]
[-First <UInt64>]
[-Skip <UInt64>]
[-AppendSelected]
[-DefaultProfile <PSObject>]
[<CommonParameters>]
ObjectIdParameterSet
Get-AzADGroup
-ObjectId <Guid>
[-Expand <String[]>]
[-Select <String[]>]
[-ConsistencyLevel <String>]
[-AppendSelected]
[-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”。
参数属性
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | 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
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Count
包括项计数
参数属性
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-CountVariable
指定集合中项总数的计数。
默认情况下，此变量将在全局范围内设置。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DefaultProfile
用于与 Azure 通信的凭据、帐户、租户和订阅。
参数属性
| 类型: | PSObject
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | AzContext, AzureRmContext, AzureCredential |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DisplayName
组的显示名称。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
DisplayNameParameterSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-DisplayNameStartsWith
用于查找以提供的字符串开头的组。
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
| 别名: | SearchString |
参数集
SearchStringParameterSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Expand
展开相关实体
参数属性
| 类型: | String[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Filter
按属性值筛选项，有关筛选查询的更多详细信息，请参阅： https://learn.microsoft.com/en-us/graph/filter-query-parameter
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-First
仅获取第一个“n”对象。
参数属性
| 类型: | UInt64
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
DisplayNameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
SearchStringParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-ObjectId
键：组 ID
参数属性
| 类型: | Guid
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
ObjectIdParameterSet
| Position: | Named |
| 必需: | True |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Orderby
按属性值对项进行排序
参数属性
| 类型: | String[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Search
按搜索短语搜索项目
参数属性
| 类型: | String
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Select
选择要返回的属性
参数属性
| 类型: | String[]
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
(All)
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
-Skip
忽略第一个“n”对象，然后获取剩余的对象。
参数属性
| 类型: | UInt64
|
| 默认值: | None |
| 支持通配符: | False |
| 不显示: | False |
参数集
EmptyParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
DisplayNameParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
SearchStringParameterSet
| Position: | Named |
| 必需: | False |
| 来自管道的值: | False |
| 来自管道的值（按属性名称）: | False |
| 来自剩余参数的值: | False |
CommonParameters
此 cmdlet 支持通用参数：-Debug、-ErrorAction、-ErrorVariable、-InformationAction、-InformationVariable、-OutBuffer、-OutVariable、-PipelineVariable、-ProgressAction、-Verbose、-WarningAction 和 -WarningVariable。 有关详细信息，请参阅 about_CommonParameters。
输出
