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

Get-AzADUser

参考

模块:: Az.Resources

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

语法

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

Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -Mail <String>
   [<CommonParameters>]

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

Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-First <UInt64>]
   [-Skip <UInt64>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -StartsWith <String>
   [<CommonParameters>]

Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -ObjectId <String>
   [<CommonParameters>]

Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   -UserPrincipalName <String>
   [<CommonParameters>]

Get-AzADUser
   [-Expand <String[]>]
   [-Select <String[]>]
   [-AppendSelected]
   [-DefaultProfile <PSObject>]
   [-SignedIn]
   [<CommonParameters>]

说明

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

示例

示例 1：获取登录用户

Get-AzADUser -SignedIn

获取登录用户

示例 2：列出用户

Get-AzADUser -First 10 -Select 'City' -AppendSelected

列出前 10 个用户，并在默认属性后追加属性“City”：“DisplayName”、“Id”、“DeletedDateTime”、“UserPrincipalName”、“UsageLocation”、“GivenName”、“SurName”、“AccountEnabled”、“MailNickName”、“Mail”

示例 3：按显示名称获取用户

Get-AzADUser -DisplayName $name

按显示名称获取用户

示例 4：获取具有筛选器的用户

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

获取具有筛选器的用户

示例 5：将 OdataCount 分配到变量

Get-AzADUser -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

-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

-Mail

用户电子邮件地址

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

-ObjectId

键：用户的 ID

类型:	String
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

-SignedIn