大网数据广告活动
域与目录服务

Windows Server 命令与管理 — Advanced Active Directory Replication and Topology Management Using Windows PowerShell (Level 200)

· 52CE 我爱测

了解详细信息:使用 Windows PowerShell 的高级 Active Directory 复制和拓扑管理 (级别 200)

适用于:Windows Server 2016、Windows Server 2012 R2、Windows Server 2012

本主题更详细地解释了新的 AD DS 复制和拓扑管理 cmdlet,并提供了其他示例。 有关简介,请参阅 使用 Windows PowerShell (级别 100)Active Directory 复制和拓扑管理 。

  1. 简介

  2. 复制和元数据

  3. Get-ADReplicationAttributeMetadata

  4. Get-ADReplicationPartnerMetadata

  5. Get-ADReplicationFailure

  6. Get-ADReplicationQueueOperation 和 Get-ADReplicationUpToDatenessVectorTable

  7. Sync-ADObject

  8. 拓扑

介绍

Windows Server 2012 使用 25 个新 cmdlet 扩展用于 Windows PowerShell 的 Active Directory 模块,以管理复制和林拓扑。 在此之前,您被强制使用 * restore-adobject 名词或调用 .net 函数。

与所有 Active Directory Windows PowerShell cmdlet 一样,此新功能需要在至少一个域控制器(最好是所有域控制器)上安装 Active Directory 管理网关服务 。

下表列出了添加到 Active Directory Windows PowerShell 模块的新复制和拓扑 cmdlet。

Cmdlet 说明
Get-ADReplicationAttributeMetadata 返回对象的属性复制元数据
Get-ADReplicationConnection 返回域控制器连接对象详细信息
Get-ADReplicationFailure 返回域对象的最新复制故障
Get-ADReplicationPartnerMetadata 返回域控制器的复制配置
Get-ADReplicationQueueOperation 返回当前复制队列积压工作
Get-ADReplicationSite 返回站点信息
Get-ADReplicationSiteLink 返回站点链接信息
Get-ADReplicationSiteLinkBridge 返回站点链接桥信息
Get-ADReplicationSubnet 返回 AD 子网信息
Get-ADReplicationUpToDatenessVectorTable 返回域控制器的 UTD 向量
Get-ADTrust 返回有关域间和林间信任的信息
New-ADReplicationSite 创建新站点
New-ADReplicationSiteLink 创建新站点链接
New-ADReplicationSiteLinkBridge 创建新站点链接桥
New-ADReplicationSubnet 创建新 AD 子网
Remove-ADReplicationSite 删除站点
Remove-ADReplicationSiteLink 删除站点链接
Remove-ADReplicationSiteLinkBridge 删除站点链接桥
Remove-ADReplicationSubnet 删除 AD 子网
Set-ADReplicationConnection 修改连接
Set-ADReplicationSite 修改站点
Set-ADReplicationSiteLink 修改站点链接
Set-ADReplicationSiteLinkBridge 修改站点链接桥
Set-ADReplicationSubnet 修改 AD 子网
Sync-ADObject 强制复制单个对象

其中大部分 cmdlet 在 Repadmin.exe 中都具有其基础。 其他 cmdlet(未列出)处理诸如动态访问控制和组托管服务帐户的功能。

要获取所有 Active Directory Windows PowerShell cmdlet 的完整列表,请运行:

Get-command -module ActiveDirectory

要获取所有 Active Directory Windows PowerShell cmdlet 参数的完整列表,请参考帮助。 例如:

Get-help New-ADReplicationSite

使用 Update-Help cmdlet 下载和安装帮助文件

复制和元数据

Repadmin.exe 验证 Active Directory 复制的运行状况和一致性。 Repadmin.exe 提供简单的数据操作选项(例如,某些参数支持 CSV 输出),但自动化通常需要通过文本文件输出进行分析。 为了提供允许真正控制返回的数据的选项,将首先尝试 Windows PowerShell 的 Active Directory 模块;在此之前,你必须创建脚本或使用第三方工具。

此外,以下 cmdlet 实现 Target、Scope 和 EnumerationServer 的新参数集:

  • Get-ADReplicationFailure

  • Get-ADReplicationPartnerMetadata

  • Get-ADReplicationUpToDatenessVectorTable

Target 参数接受以逗号分隔的字符串列表,这些字符串可标识由 Scope 参数指定的目标服务器、站点、域或林。 还允许使用星号 (*) ,这意味着指定范围内的所有服务器。 如果未指定作用域,则表示当前用户林中的所有服务器。 Scope 参数指定搜索的范围。 可接受的值是 Server、Site、Domain 和 Forest。 EnumerationServer 指定用于枚举在 Target 和 Scope 中指定的域控制器列表的服务器。 它的操作方式与 Server 参数相同,并且要求指定的服务器运行 Active Directory Web 服务。

若要引入新的 cmdlet,下面提供了一些用于显示不适用于 repadmin.exe 的功能的示例方案;有了这些图示,可能实现的管理功能便显而易见。 查看有关特定用法要求的 cmdlet 帮助。

Get-ADReplicationAttributeMetadata

此 cmdlet 类似于 repadmin.exe /showobjmeta。 它允许你返回复制元数据(例如在属性发生更改时)、原始域控制器、版本和 USN 信息以及属性数据。 此 cmdlet 对于审核发生更改的位置和时间非常有用。

与 Repadmin 不同,Windows PowerShell 提供了灵活搜索和输出控制。 例如,可以输出以可读列表形式排列的 Domain Admins 对象的元数据:

Get-ADReplicationAttributeMetadata -object "cn=domain admins,cn=users,dc=corp,dc=contoso,dc=com" -server dc1.corp.contoso.com -showalllinkedvalues | format-list

显示以可读列表形式排列的 Domain Admins 对象的元数据输出的屏幕截图。

或者,可以在表中将该数据排列为类似于 repadmin 的形式:

Get-ADReplicationAttributeMetadata -object "cn=domain admins,cn=users,dc=corp,dc=contoso,dc=com" -server dc1.corp.contoso.com -showalllinkedvalues | format-table -wrap

在表中显示与 repadmin 显示的数据的屏幕截图。

或者,你可以使用筛选器(例如所有组)通过管道传送 Get-Adobject cmdlet 来为整个对象类获取元数据,然后再加上一个特定日期。 管道是在多个 cmdlet 之间用于传递数据的一个通道。 若要查看在 2012 年 1 月 13 日以某种方式修改的所有组:

get-adobject -filter 'objectclass -eq "group"' | Get-ADReplicationAttributeMetadata -server dc1.corp.contoso.com | where-object {$_.lastoriginatingchangetime -like "*1/13/2012*" -and $_.attributename -eq "name"} | format-table object

屏幕截图,显示了如何在2012年1月13日以某种方式查看所有组。

有关管道的更多 Windows PowerShell 操作的详细信息,请参阅 Windows PowerShell 中的管道系统和管道。

或者,若要了解每个包含 Tony Wang 这一成员的组,以及该组的最后修改时间:

get-adobject -filter 'objectclass -eq "group"' | Get-ADReplicationAttributeMetadata -server dc1.corp.contoso.com -showalllinkedvalues | where-object {$_.attributevalue -like "*tony wang*"} | format-table object,LastOriginatingChangeTime,version -auto

屏幕截图,显示了如何查找每个包含 Tony Wang 作为成员以及上次修改组的组。

或者,若要基于人为高版本,在域中查找所有使用系统状态备份授权还原的对象:

get-adobject -filter 'objectclass -like "*"' | Get-ADReplicationAttributeMetadata -server dc1.corp.contoso.com | where-object {$_.version -gt "100000" -and $_.attributename -eq "name"} | format-table object,LastOriginatingChangeTime

此屏幕截图显示了如何基于人为高版本,在域中查找所有使用系统状态备份授权还原的对象。

或者,将所有用户元数据发送到 CSV 文件,以供以后在 Microsoft Excel 中进行检查:

get-adobject -filter 'objectclass -eq "user"' | Get-ADReplicationAttributeMetadata -server dc1.corp.contoso.com -showalllinkedvalues | export-csv allgroupmetadata.csv

Get-ADReplicationPartnerMetadata

此 cmdlet 返回有关域控制器复制的配置和状态信息,从而允许你监视、盘存或解决问题。 与 Repadmin.exe 不同,使用 Windows PowerShell 意味着你仅能以所需格式看到对你而言非常重要的数据。

例如,单个域控制器的可读复制状态:

Get-ADReplicationPartnerMetadata -target dc1.corp.contoso.com

显示如何获取单个域控制器的可读复制状态的屏幕截图。

或者,域控制器最后一次复制入站及其合作伙伴的时间(采用表格式):

Get-ADReplicationPartnerMetadata -target dc1.corp.contoso.com | format-table lastreplicationattempt,lastreplicationresult,partner -auto

显示域控制器最后一次复制入站及其合作伙伴的时间的屏幕截图,格式为表格式。

或者,联系林中的所有域控制器,并显示上次尝试复制失败(出于任何原因)的任何域控制器:

Get-ADReplicationPartnerMetadata -target * -scope server | where {$_.lastreplicationresult -ne "0"} | ft server,lastreplicationattempt,lastreplicationresult,partner -auto

屏幕截图显示了如何联系林中的所有域控制器,并显示上次尝试复制失败(出于任何原因)的任何域控制器。

Get-ADReplicationFailure

此 cmdlet 可用于返回有关复制中最近出现的错误的信息。 它类似于 Repadmin.exe /showreplsum,但同样由于 Windows PowerShell,它可以更好地进行控制。

例如,可以返回域控制器最近发生的故障以及联系失败的合作伙伴:

Get-ADReplicationFailure dc1.corp.contoso.com

屏幕截图,显示如何返回域控制器最近发生的故障以及联系失败的合作伙伴。

或者,返回特定 AD 逻辑站点中的所有服务器的对应表视图,已对该视图排序以便进行查看,它仅包含最关键的数据:

Get-ADReplicationFailure -scope site -target default-first-site-name | format-table server,firstfailuretime,failurecount,lasterror,partner -auto

显示如何为特定 AD 逻辑站点中的所有服务器返回表视图的屏幕截图,排序以便于查看并仅包含最关键的数据。

Get-ADReplicationQueueOperation 和 Get-ADReplicationUpToDatenessVectorTable

这两个 cmdlet 将返回域控制器“更新程度”的其他方面,其中包括挂起的复制和版本矢量信息。

Sync-ADObject

此 cmdlet 类似于运行 Repadmin.exe /replsingleobject。 当你进行需要带外复制的更改(特别是修复某个问题)时,它将非常有用。

例如,如果某人删除了 CEO 的用户帐户,然后使用 Active Directory 回收站还原它,你可能希望将它立即复制到所有域控制器。 你可能还希望在不强制复制所做的所有其他对象更改的情况下执行此操作;毕竟这是你制定复制计划的原因 - 避免重载 WAN 链接。

Get-ADDomainController -filter * | foreach {Sync-ADObject -object "cn=tony wang,cn=users,dc=corp,dc=contoso,dc=com" -source dc1 -destination $_.hostname}

屏幕截图显示了如何将已删除的帐户从 Active Directory 回收站复制到所有域控制器,而不会强制复制所做的所有其他对象更改。

拓扑

虽然 Repadmin.exe 能够很好地返回有关复制拓扑(例如站点、站点链接、站点链接桥和连接)的信息,但它没有可进行更改的完整参数集。 事实上,从来没有任何可编写脚本的内部 Windows 实用工具可专供管理员创建和修改 AD DS 拓扑。 由于 Active Directory 在数以百万计的客户环境中日益成熟,因此批量修改 Active Directory 逻辑信息的需求也日益凸显。

例如,在快速扩张新的分支机构以及合并其他机构之后,你可能需要基于物理位置、网络更改和新容量要求来更改上百个站点。 可自动进行更改,而不是使用 Dssites.msc 和 Adsiedit.msc。 当你使用由网络和设施团队提供的数据电子表格开始操作时,这一点尤为引人注目。

\ Get-adreplication _ cmdlet 返回有关复制拓扑的信息,可用于批量传输到 get-adreplication \ * cmdlet。 Get* cmdlet 不会更改数据,只显示数据,或创建可通过管道传递到 get-adreplication \ cmdlet 的 Windows PowerShell 会话对象。 _ New* 和 Remove cmdlet 用于创建或删除 Active Directory 拓扑对象。

例如,你可以使用 CSV 文件创建新站点:

import-csv -path C:\newsites.csv | new-adreplicationsite

显示记事本界面的屏幕截图。

显示如何使用 CSV 文件创建新站点的屏幕截图。

或者,使用自定义的复制时间间隔和站点成本在两个现有站点之间创建新站点链接:

new-adreplicationsitelink -name "chicago<-->waukegan" -sitesincluded chicago,waukegan -cost 50 -replicationfrequencyinminutes 15

屏幕截图显示了使用自定义复制间隔和站点成本在两个现有站点之间创建新站点链接。

或者,在林中找到每个站点,并将其 Options 属性替换为该标志以启用站点间更改通知,从而通过压缩以最大速度进行复制:

get-adreplicationsitelink -filter * | set-adobject -replace @{options=$($_.options -bor 1)}

通过 powershell 进行高级管理

Important: 也可以设置 -bor 5 以在这些站点链接上禁用压缩。

或者,查找缺少子网分配的所有站点,以便协调该列表与这些位置的实际子网:

get-adreplicationsite -filter * -property subnets | where-object {!$_.subnets -eq "*"} | format-table name

屏幕截图显示了如何查找缺少子网分配的所有站点,以便将列表与这些位置的实际子网进行协调。

另请参阅

使用 Windows PowerShell 的 Active Directory 复制和拓扑管理简介 (级别 100)

历史资料。此文对应 2021-03-23 的中文文档快照,适用产品版本和命令行为以原文为准。

来源与署名:Microsoft 和文档贡献者(原始作者元数据 iainfoulds)。固定版本原文。文档采用 CC BY 4.0,示例代码采用 MIT 授权。本站将 Markdown 转为 HTML,规范化链接,移除外部媒体和导航标记。

资料来源与适用范围

资料来源
Microsoft / Windows Server 中文文档历史快照
适用范围
历史中文快照 2021-03-23;详见原文产品版本;文档日期 05/31/2017
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-16
授权说明
CC BY 4.0(文档)/ MIT(示例代码)

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。