参考来源与致谢
- 引用来源:PowerShell – Get a list of my domain Organizational Units
- 原作者:原页面署名作者或发布机构(剪藏记录未保存可核验的个人署名)
- 感谢词:感谢原作者及发布机构对技术知识的公开分享。本文已结合企业运维场景完成脱敏、核验与原创重写,并非原文转载;如权利人需要更正署名或来源信息,请联系本站。
适用场景 #
需要盘点域内全部组织单位(OU),用于资产梳理、权限审计、迁移前评估或文档整理。本文介绍在已加入域的管理主机上,通过 PowerShell 的 Active Directory 模块读取 OU 列表的通用做法。查询为只读操作,不修改目录数据。
准备与风险 #
- 执行账号需具备读取域目录的权限,通常为普通域用户即可;若权限受限,结果可能不完整。
- 确认主机已安装 RSAT 的 Active Directory 模块,或本身为域控制器。
- 查询本身无破坏性,但后续若基于结果执行批量修改,务必先在测试环境验证。
- 涉及任何写操作前,先备份相关对象或导出当前配置,并确认可回退。
- 输出可能包含内部命名信息,注意保存位置与访问范围。
处理步骤 #
1. 检查并加载模块 #
Get-Module -Name ActiveDirectory
Get-Module -Name ActiveDirectory -ListAvailable
Import-Module -Name ActiveDirectory
若第二条命令无输出,说明模块未安装,需先安装对应管理工具。具体安装方式请查阅所用操作系统版本的官方文档。
2. 确认可用命令 #
Get-Command -Module ActiveDirectory -Name *OrganizationalUnit*
3. 方法一:Get-ADOrganizationalUnit #
该命令用于获取单个或多个 OU 对象。先查看对象可用属性:
Get-ADOrganizationalUnit -Filter * | Get-Member
再按需筛选属性,例如输出规范名称:
Get-ADOrganizationalUnit -Filter * | Select-Object CanonicalName
如需同时查看可分辨名称与描述:
Get-ADOrganizationalUnit -Filter * |
Select-Object Name, DistinguishedName, CanonicalName
4. 方法二:Get-ADObject #
通过对象类别过滤,可获取 OU 对象:
Get-ADObject -Filter { ObjectClass -eq 'organizationalunit' }
结合属性选择,得到与上一种方法相近的结果:
Get-ADObject -Filter { ObjectClass -eq 'organizationalunit' } |
Select-Object Name, DistinguishedName
两种方法返回的属性集合略有差异,按实际需要选择。若需指定域或凭据,可使用命令自带的 -Server、-Credential 参数,参数值以 [服务器地址]、[管理员账号] 等占位符替换。
验证方法 #
- 将结果条数与图形化管理工具中显示的 OU 数量对照。
- 抽查若干 OU 的
DistinguishedName,确认层级关系正确。 - 对同一查询重复执行,结果应保持一致。
- 如需留档,可导出为文件:
Get-ADOrganizationalUnit -Filter * |
Select-Object Name, DistinguishedName, CanonicalName |
Export-Csv --password [密码] [导出文件路径] -NoTypeInformation -Encoding UTF8
回退建议 #
本文命令均为只读查询,不改变目录状态,无需回退。若在排查过程中曾临时调整模块或执行策略,恢复原设置即可。任何基于查询结果的批量修改,应先在测试环境演练,并保留导出文件作为对照依据。
常见问题 #
- 提示找不到命令:模块未安装或未加载,先执行导入并确认安装状态。
- 结果为空或不全:检查账号读取权限,以及是否指定了正确的域控制器。
- 输出属性缺失:不同命令返回的属性集合不同,可用
Get-Member确认后再筛选。 - 中文或特殊字符显示异常:注意控制台编码与导出文件的编码设置。
- 命令参数与行为随版本变化:请以所用系统与模块版本的官方文档为准。
