Get-MgUser - 使用 PowerShell 获取 Azure AD 用户

PowerShell 中的 Get-MgUser cmdlet 用于检索有关 Microsoft Graph 用户的信息。此命令允许您根据用户名、电子邮件地址和 Azure Active Directory 经理等条件获取和提取有关用户或特定用户的信息。

Microsoft 365 租户中的用户帐户集中存储在 Azure Active Directory 中

下面给出了在 Azure Active Directory 中检索用户的语法。

Get-MgUser
   -UserId <String>
   -InputObject <IUsersIdentity>
   [-ExpandProperty <String[]>]
   [-Property <String[]>]
   [-Filter <String>]
   [-Search <String>]
   [-Sort <String[]>]
   [-Top <Int32>]
   [-ConsistencyLevel <String>]
   [-PageSize <Int32>]
   [-All]
   [-CountVariable <String>]
   [<CommonParameters>]

在本文中，我们将讨论如何使用 PowerShell 中的 Get-MgUser cmdlet 获取所有用户的列表、通过 ID 获取用户以及根据筛选条件获取用户。

如何获取 Azure AD 中所有用户的列表

首先，您需要使用正确的范围连接到 Microsoft Graph。要检索用户数据，我们可以使用User.Read.All范围。

Connect-MgGraph -Scopes 'User.Read.All'

此命令同意读取用户数据的权限。

要获取 Microsoft Graph 中所有用户的列表，请使用 PowerShell 中的 Get-MgUser cmdlet。

Get-MgUser -All

此命令返回 Azure Active Directory 中所有用户的列表。

Get-MgUser cmdlet 的输出包括以下属性。

• DisplayName：用户的名称。
• Id：用户的唯一ID。
• 邮件：用户的电子邮件地址。
• UserPrincipalName：用户的用户主体名称。

如何通过 Id 和 UserPrincipalName 获取用户

在 PowerShell 中使用 Get-MgUser cmdlet 和 -UserId 参数可按用户主体名称获取用户。 -UserId 参数指定用户的唯一标识符。

# Get the user by the UserPricipalName
Get-MgUser -UserId [email  

此命令通过 UserPrincipalName 获取用户。

您可以使用以下命令通过用户 ID 获取用户。

Get-MgUser -UserId cf634aac-d7d1-41a4-aad9-544c0bfda070

上述命令的输出提供了用户属性，例如 DisplayName、Id、Mail、UserPrincipalName。

PS C:\> Get-MgUser -UserId [email      
                                                      
DisplayName    Id                                   Mail                               UserPrincipalName
-----------    --                                   ----                               -----------------
Samer Amberson cf634aac-d7d1-41a4-aad9-544c0bfda070 [email  [email ...


PS C:\> Get-MgUser -UserId cf634aac-d7d1-41a4-aad9-544c0bfda070      
                                                   
DisplayName    Id                                   Mail                               UserPrincipalName
-----------    --                                   ----                               -----------------
Samer Amberson cf634aac-d7d1-41a4-aad9-544c0bfda070 [email  [email ...


PS C:\>                  

Get-MgUser cmdlet 可用于检索有关 Microsoft Graph 用户的各种信息，例如：

• 显示名称，
• ID
• 电子邮件地址
• 部门
• 职称
• 电话号码
• 创建日期时间
• 办公地点
• 国家
• 经理
• 许可证分配

此信息可用于管理用户帐户并跟踪用户活动。

如何获取 Microsoft Graph 中所有用户的计数

要获取 Azure AD 中所有用户的计数，请使用以下命令。

 Get-MgUser -Count userCount -ConsistencyLevel eventual

此命令返回 Azure AD 中所有用户的列表及其计数。 $userCount 变量包含结果中对象的计数。

Get-MgUser 命令使用 -Count 参数和 -ConsistencyLevel 参数来指示请求的一致性级别。

如何使用 Get-MgUser 所有属性

要获取 Microsoft Graph 用户的所有属性，请使用 Get-MgUser cmdlet。此命令检索用户的默认属性，并将用户对象的输出通过管道传输到 Format-List (FL) 命令以获取用户对象的所有属性。

Get-MgUser -UserId '65bbf88c-ec92-417c-b7f1-fab8ecae7561' | FL

此命令检索 Azure AD 中 Microsoft Graph 用户的所有属性。

您可以通过运行以下命令来选择用户的特定属性。

Get-MgUser -UserId 'cf634aac-d7d1-41a4-aad9-544c0bfda070' | Select Id, Email,Mail, JobTitle  

该命令打印用户的特定属性。

PS C:\> Get-MgUser -UserId 'cf634aac-d7d1-41a4-aad9-544c0bfda070' | Select Id, Email,Mail, JobTitle                     
Id                                   Email Mail                               JobTitle
--                                   ----- ----                               --------
cf634aac-d7d1-41a4-aad9-544c0bfda070       [email  Manager

如何通过 Get-MgUser 命令使用过滤器

在 PowerShell 中使用过滤器和 Get-MgUser cmdlet 可以让您根据过滤条件检索用户。

您可以使用以下运算符（例如eq、and、or 和startswith）来通过Get-MgUser cmdlet 筛选用户。

让我们通过 Get-MgUser 示例来了解如何使用过滤器。

如何通过显示名称查找用户

要通过显示名称查找用户，请使用以下命令。

Get-MgUser -Filter "DisplayName eq 'Samer Amberson'" 

此命令通过全名查找用户。

下面给出了 Get-MgUser 命令的输出。

PS C:\> Get-MgUser -Filter "DisplayName eq 'Samer Amberson'"      
                                                      
DisplayName    Id                                   Mail                               UserPrincipalName
-----------    --                                   ----                               -----------------
Samer Amberson cf634aac-d7d1-41a4-aad9-544c0bfda070 [email  [email ...

如何按部门查找 Mg 用户

若要按部门名称和国家/地区获取 Microsoft Graph 用户，请使用以下命令。

Get-MgUser -Filter "department eq 'Finance' and country eq 'United States'"  

此命令返回属于“美国”国家/地区“财务”部门的所有用户。

如何在 Azure AD 中获取启用的用户帐户

要使用 PowerShell 中的 Get-MgUser cmdlet 获取启用的用户帐户，请运行以下命令。

Get-MgUser -Filter 'accountEnabled eq true' -All  

Get-MgUser 命令使用 -Filter 参数指定将用户帐户 accountEnabled 设置为 true 的条件。

如何获取显示名称以“j”开头的用户

要获取显示名称以“j”开头的用户，请使用带有 -Filter 参数的 Get-MgUser cmdlet。 -Filter 参数用于指定使用 startswith 参数查找显示名称以“j”开头的用户的条件。

Get-MgUser -Filter "startsWith(DisplayName, 'J')"     

此命令返回显示名称以“J”开头的用户。

PS C:\> Get-MgUser -Filter "startsWith(DisplayName, 'J')"    
                                                           
DisplayName Id                                   Mail                              UserPrincipalName
----------- --                                   ----                              -----------------
john alwin  ec2e9ac0-680b-4666-a8a9-e10a24910c80 [email  [email 


PS C:\>                                                                                                                                                                                                                                                            

如何使用搜索在 Azure AD 中查找用户

Get-MgUser cmdlet 有一个 -Search 参数，可用于在 Azure AD 中查找用户。

Get-MgUser -Search 'DisplayName:joh' -ConsistencyLevel eventual

Get-MgUser 命令使用 -Search 参数指定搜索条件，例如查找显示名称中包含“joh”的用户。

如何获取所有用户并导出为 CSV

要从 Azure Active Directory 获取所有用户，请使用带有 -All 参数的 Get-MgUser cmdlet。此命令从 Azure AD 检索所有使用情况，并将它们通过管道传送到 Export-CSV cmdlet，以将它们导出到 CSV 文件。

 Get-MgUser -All | Export-Csv -Path D:\PS_delete\mgusers_list.csv -NoTypeInformation

此命令从 Azure AD 获取所有用户并将其导出到指定位置的 CSV 文件。

结论

希望上述有关如何使用 Get-MgUser cmdlet 从 Azure AD 获取所有用户、使用 PowerShell 筛选或搜索用户的文章对您有所帮助。

您可以在 ShellGeek 主页上找到有关 PowerShell Active Directory 命令和 PowerShell 基础知识的更多主题。

相关链接

新用户管理

获取 MgUserCount