HOWTO · PowerShell

使用 PowerShell 获取用户的所有组成员身份

比较使用 PowerShell 列出用户的 Active Directory 组成员关系的四种方法,包括各自的前提条件和结果范围。

本页内容

若要列出用户的 Active Directory 组成员关系,可选择旧版 net 命令、ADSI、DirectorySearcher 或 Active Directory 模块。前三种方法无需安装该模块即可使用 Windows 目录服务;如果模块已可用,使用其 cmdlet 是最直接的做法。这些方法都需要连接到域控制器,并使用有权限读取目录的帐户。这里的“所有”是指各查询实际返回的成员关系:目录的 memberOf 属性以及这些示例显示的是直接组关系,并不会完整展开传递成员关系。它们也不一定包含用户的主组。

使用 net 旧版命令获取用户的组成员关系

运行 net user /domain,向域查询当前登录帐户的信息。结果包含该帐户所属的全局域组。若要查询其他域帐户,可提供用户名:net user username /domain。

这是一个旧版命令行工具,PowerShell 可以直接调用它;它不是 PowerShell 别名。该命令的输出经过格式化,供人查看。如果需要结构化对象或要在脚本中处理组名,请改用 Active Directory 查询。此命令报告的是域信息,不是用户在本地计算机上的组成员关系。

使用 ADSI 获取用户的组成员关系

ADSI 是 Windows 目录服务接口,可通过 PowerShell 的 [adsisearcher] 类型使用。此查询使用当前登录帐户的名称,并以可分辨名称的形式返回其 memberOf 值。在已连接域的 PowerShell 会话中运行 $searcher = [adsisearcher]"(samAccountName=$($env:USERNAME))"; $result = $searcher.FindOne(); if ($null -ne $result) { $result.Properties.memberof }。

每个值都通过 LDAP 可分辨名称标识一个组,其中包含其组织路径。筛选条件针对名称存储在 $env:USERNAME 中的帐户;它不会选择其他用户。memberOf 表示直接关系,不会列出主组。这种方法无需单独安装 PowerShell 模块,但仍需要连接目录并有权读取该帐户。查询能否成功取决于当前环境能否解析并搜索 Active Directory;本文没有提供域环境中的运行结果来支持相反的说法。
要从示例可分辨名称中提取通用名称部分,可以对返回的字符串应用正则表达式:

$memberOf = @(
    "CN=Finance,OU=Groups,DC=example,DC=com",
    "CN=Engineering,OU=Groups,DC=example,DC=com"
)
$memberOf -replace '^CN=([^,]+).+$', '$1'
Finance
Engineering

此转换会从给定字符串中去掉 LDAP 路径;它不会执行目录查询。该正则表达式假设通用名称中不含转义逗号。

使用新对象获取用户的组成员关系

DirectorySearcher 提供了另一种内置方式,可搜索指定帐户。此示例有意只接受由字母、数字、句点、下划线或连字符组成、最长为 20 个字符的 ASCII sAMAccountName。在构建 LDAP 筛选条件之前,应拒绝其他输入:if ($username -notmatch '^[A-Za-z0-9._-]{1,20}$') { throw 'Use a valid account name.' }。验证通过后,运行 $searcher = New-Object System.DirectoryServices.DirectorySearcher("(&(objectCategory=User)(samAccountName=$username))"); $result = $searcher.FindOne(); if ($null -ne $result) { $result.Properties.memberof }。受限的字符集可以防止输入值加入 LDAP 筛选语法;如果目录允许使用此示例范围以外的帐户名,请改用 LDAP 筛选器转义。

返回值是 LDAP 可分辨名称,而不只是组名。将 user01 替换为目标帐户的登录名。与 ADSI 示例一样,此方法读取 memberOf 属性,因此不会展开嵌套成员关系,也不包含主组。它需要访问域目录,但无需另行安装模块。

使用 Active Directory 模块获取用户的组成员关系

Active Directory 模块提供用于目录管理的 cmdlet。计算机上必须已具备此模块;单独运行 Install-Module 并不会安装这个 Windows 模块。请按照适用于当前 Windows 版本的 Microsoft 说明安装 RSAT。本文没有确定特定版本的 RSAT 命令或兼容性,因此此处不列出此类命令。

安装 Active Directory 模块

安装适用的 RSAT 组件后,在 PowerShell 会话中运行 Import-Module -Name ActiveDirectory 导入模块。

如果模块不可用,导入命令就无法加载它。不同 Windows 版本的安装步骤各异,请查阅 Microsoft 针对该版本的最新 RSAT 指南,不要直接套用其他版本的命令。

使用 Get-ADPrincipalGroupMembership Cmdlet

将用户帐户名传给 Get-ADPrincipalGroupMembership,然后选择组名以简洁显示结果:Get-ADPrincipalGroupMembership -Identity "user01" | Select-Object -ExpandProperty Name。

将 user01 替换为目标用户标识。该 cmdlet 会返回与该主体关联的组对象;选择 Name 后显示的是组名,而不是 LDAP 可分辨名称。此命令需要 Active Directory 模块、适当的目录连接以及读取权限。这些示例没有在 Windows 域环境中的执行证据,因此这里不将依赖域环境的输出和行为描述为已经测试过。