PowerShell 技能连载 - Hyper-V 虚拟机管理

适用于 PowerShell 5.1 及以上版本(Windows),需要 Hyper-V 角色

Hyper-V 是微软提供的原生虚拟化平台,从 Windows Server 2008 开始内置,在 Windows 10/11 专业版和企业版中同样可用。对于系统管理员和 DevOps 工程师来说,能够通过脚本批量管理虚拟机是提高效率的关键。PowerShell 的 Hyper-V 模块提供了完整的 cmdlet 集,覆盖虚拟机的创建、配置、启动、快照、迁移等全生命周期操作。

在实际运维场景中,手动通过 Hyper-V 管理器操作几台虚拟机尚可应付,但当你需要管理数十甚至上百台虚拟机时,手动操作不仅耗时,还容易出错。通过 PowerShell 脚本,我们可以将日常的虚拟机管理任务自动化,比如批量创建开发环境、定期检查虚拟机状态、自动创建检查点等。

本文将通过几个实用的示例,展示如何使用 PowerShell 完成 Hyper-V 虚拟机的日常管理任务,包括查询状态、批量创建虚拟机、管理检查点以及资源监控。

查询虚拟机状态

最基础的操作是了解当前 Hyper-V 主机上有哪些虚拟机以及它们的运行状态。使用 Get-VM 可以快速获取这些信息。

1
2
3
4
# 查询所有虚拟机的基本信息
Get-VM | Select-Object Name, State, CPUUsage, MemoryAssigned, Uptime,
@{N = 'MemoryMB'; E = { [math]::Round($_.MemoryAssigned / 1MB, 0) } } |
Format-Table -AutoSize

这段代码使用 Get-VM 获取所有虚拟机对象,然后通过 Select-Object 提取关键字段。其中 MemoryAssigned 原始值以字节为单位,我们用计算属性将其转换为兆字节(MB)以便阅读。

执行结果示例:

1
2
3
4
5
6
7
Name            State      CPUUsage MemoryAssigned     Uptime MemoryMB
---- ----- -------- -------------- ------ --------
Ubuntu-Dev Running 12 2147483648 12:34:56 2048
Win2022-Test Running 8 4294967296 06:12:30 4096
CentOS-Build Off 0 0 00:00:00 0
Win11-Client Saved 0 0 00:00:00 0
Docker-Host Running 25 2147483648 03:45:12 2048

如果只想查看正在运行的虚拟机,可以加上过滤条件:

1
2
3
4
# 仅查询正在运行的虚拟机
Get-VM | Where-Object { $_.State -eq 'Running' } |
Select-Object Name, @{N = 'CPU(%)'; E = { $_.CPUUsage } },
@{N = 'MemGB'; E = { [math]::Round($_.MemoryAssigned / 1GB, 2) } }

执行结果示例:

1
2
3
4
5
Name         CPU(%) MemGB
---- ------ -----
Ubuntu-Dev 12 2.00
Win2022-Test 8 4.00
Docker-Host 25 2.00

批量创建虚拟机

在搭建测试环境时,经常需要一次性创建多台虚拟机。手动一台台创建费时费力,下面的脚本可以批量完成这项工作。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# 批量创建虚拟机的配置参数
$vmConfigs = @(
@{
Name = 'Test-Web01'
Memory = 2GB
VHDSize = 60GB
Switch = 'Default Switch'
}
@{
Name = 'Test-DB01'
Memory = 4GB
VHDSize = 120GB
Switch = 'Default Switch'
}
@{
Name = 'Test-API01'
Memory = 2GB
VHDSize = 60GB
Switch = 'Default Switch'
}
)

# 获取 VHD 默认存储路径
$vhdPath = (Get-VMHost).VirtualHardDiskPath

foreach ($config in $vmConfigs) {
$vhdFilePath = Join-Path $vhdPath "$($config.Name).vhdx"

# 检查虚拟机是否已存在
$existing = Get-VM -Name $config.Name -ErrorAction SilentlyContinue
if ($existing) {
Write-Host "跳过: 虚拟机 '$($config.Name)' 已存在" -ForegroundColor Yellow
continue
}

Write-Host "正在创建虚拟机: $($config.Name)..." -ForegroundColor Cyan

# 创建动态扩展的虚拟硬盘
New-VHD -Path $vhdFilePath -SizeBytes $config.VHDSize -Dynamic |
Out-Null

# 创建虚拟机并挂载虚拟硬盘
New-VM -Name $config.Name -MemoryStartupBytes $config.Memory `
-VHDPath $vhdFilePath -SwitchName $config.Switch |
Out-Null

# 设置处理器数量
Set-VM -Name $config.Name -ProcessorCount 2

Write-Host " 完成: $($config.Name) (内存: $($config.Memory / 1GB)GB, " `
"磁盘: $($config.VHDSize / 1GB)GB, 2 vCPU)" -ForegroundColor Green
}

Write-Host "`n批量创建完成!" -ForegroundColor Green

这个脚本首先定义了一个配置数组,包含每台虚拟机的名称、内存大小、磁盘大小和虚拟交换机名称。然后遍历配置数组,逐一创建虚拟硬盘和虚拟机。脚本还加入了重复检查逻辑,避免在已有同名虚拟机时报错。

执行结果示例:

1
2
3
4
5
6
7
8
正在创建虚拟机: Test-Web01...
完成: Test-Web01 (内存: 2GB, 磁盘: 60GB, 2 vCPU)
正在创建虚拟机: Test-DB01...
完成: Test-DB01 (内存: 4GB, 磁盘: 120GB, 2 vCPU)
正在创建虚拟机: Test-API01...
完成: Test-API01 (内存: 2GB, 磁盘: 60GB, 2 vCPU)

批量创建完成!

管理检查点(快照)

检查点(Checkpoint,以前称为快照 Snapshot)是 Hyper-V 的重要功能,可以在虚拟机的特定时间点保存状态,方便后续回滚。下面的脚本展示了如何自动创建和还原检查点。

1
2
3
4
5
6
7
8
9
10
11
# 为所有运行中的虚拟机创建带时间戳的检查点
$timestamp = Get-Date -Format 'yyyy-MM-dd_HHmm'
$runningVMs = Get-VM | Where-Object { $_.State -eq 'Running' }

foreach ($vm in $runningVMs) {
$checkpointName = "AutoBackup_$timestamp"
Write-Host "正在为 '$($vm.Name)' 创建检查点: $checkpointName"
Checkpoint-VM -VM $vm -SnapshotName $checkpointName
}

Write-Host "`n所有检查点创建完成" -ForegroundColor Green

这段代码筛选出所有正在运行的虚拟机,为每台创建一个带有时间戳标记的检查点。这种做法特别适合在做系统更新或软件升级前保存一个回滚点。

执行结果示例:

1
2
3
4
5
正在为 'Ubuntu-Dev' 创建检查点: AutoBackup_2025-11-25_0800
正在为 'Win2022-Test' 创建检查点: AutoBackup_2025-11-25_0800
正在为 'Docker-Host' 创建检查点: AutoBackup_2025-11-25_0800

所有检查点创建完成

查询和还原检查点同样简单:

1
2
3
4
5
6
# 查看指定虚拟机的检查点列表
$vmName = 'Win2022-Test'
Get-VMSnapshot -VMName $vmName |
Select-Object Name, CreationTime, @{N = 'Type'; E = { $_.SnapshotType } } |
Sort-Object CreationTime -Descending |
Format-Table -AutoSize

执行结果示例:

1
2
3
4
5
Name                         CreationTime          Type
---- ------------ ----
AutoBackup_2025-11-25_0800 2025/11/25 08:00:15 Standard
BeforePatch_2025-11-20 2025/11/20 14:30:22 Standard
CleanInstall 2025/11/01 10:15:00 Standard

如果需要回滚到某个检查点:

1
2
3
4
5
6
7
8
9
10
11
# 回滚虚拟机到指定检查点
$snapshot = Get-VMSnapshot -VMName 'Win2022-Test' |
Where-Object { $_.Name -eq 'BeforePatch_2025-11-20' }

if ($snapshot) {
Write-Host "正在将 'Win2022-Test' 回滚到 '$($snapshot.Name)'..."
Restore-VMSnapshot -VMSnapshot $snapshot -Confirm:$false
Write-Host "回滚完成" -ForegroundColor Green
} else {
Write-Host "未找到指定的检查点" -ForegroundColor Red
}

执行结果示例:

1
2
正在将 'Win2022-Test' 回滚到 'BeforePatch_2025-11-20'...
回滚完成

批量启停虚拟机

在测试环境中,可能需要按特定顺序启动或关闭一组虚拟机。例如先启动数据库服务器,再启动应用服务器和 Web 服务器。PowerShell 可以精确控制这个流程。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# 按顺序启动虚拟机组
$startOrder = @('Test-DB01', 'Test-API01', 'Test-Web01')

foreach ($vmName in $startOrder) {
$vm = Get-VM -Name $vmName -ErrorAction SilentlyContinue

if (-not $vm) {
Write-Host "跳过: 虚拟机 '$vmName' 不存在" -ForegroundColor Yellow
continue
}

if ($vm.State -eq 'Running') {
Write-Host "跳过: '$vmName' 已在运行" -ForegroundColor Gray
continue
}

Write-Host "正在启动: $vmName" -ForegroundColor Cyan
Start-VM -Name $vmName

# 等待虚拟机进入运行状态
$timeout = 60
$elapsed = 0
while ((Get-VM -Name $vmName).State -ne 'Running' -and $elapsed -lt $timeout) {
Start-Sleep -Seconds 2
$elapsed += 2
}

if ((Get-VM -Name $vmName).State -eq 'Running') {
Write-Host " 已启动: $vmName (等待 $($elapsed)s)" -ForegroundColor Green
} else {
Write-Host " 超时: $vmName 未能在 ${timeout}s 内启动" -ForegroundColor Red
}
}

这段脚本按照指定的顺序逐台启动虚拟机,并在每台启动后等待确认其进入 Running 状态再继续下一台,确保服务依赖关系正确。同时加入了超时机制,避免某台虚拟机启动失败时脚本无限等待。

执行结果示例:

1
2
3
4
5
6
正在启动: Test-DB01
已启动: Test-DB01 (等待 8s)
正在启动: Test-API01
已启动: Test-API01 (等待 6s)
正在启动: Test-Web01
已启动: Test-Web01 (等待 4s)

关闭虚拟机时,建议优先使用正常关机而非强制断电:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
# 优雅关闭所有运行中的虚拟机
$runningVMs = Get-VM | Where-Object { $_.State -eq 'Running' }

foreach ($vm in $runningVMs) {
Write-Host "正在关闭: $($vm.Name)" -ForegroundColor Cyan
Stop-VM -Name $vm.Name -Force

# 等待虚拟机完全关闭
$count = 0
while ((Get-VM -Name $vm.Name).State -ne 'Off' -and $count -lt 30) {
Start-Sleep -Seconds 2
$count++
}

$finalState = (Get-VM -Name $vm.Name).State
if ($finalState -eq 'Off') {
Write-Host " 已关闭: $($vm.Name)" -ForegroundColor Green
} else {
Write-Host " 强制关闭: $($vm.Name)" -ForegroundColor Yellow
Stop-VM -Name $vm.Name -TurnOff -Force
}
}

Stop-VM 默认会向虚拟机发送关机信号(类似于按下电源按钮),操作系统正常处理后关闭。如果虚拟机在一定时间内没有响应关机信号,脚本会使用 -TurnOff 参数强制断电。

执行结果示例:

1
2
3
4
5
6
正在关闭: Ubuntu-Dev
已关闭: Ubuntu-Dev
正在关闭: Win2022-Test
已关闭: Win2022-Test
正在关闭: Docker-Host
已关闭: Docker-Host

资源使用监控

监控虚拟机的资源使用情况是运维的重要环节。下面的脚本会收集所有虚拟机的 CPU、内存和磁盘使用信息,并生成一个汇总报告。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
# 虚拟机资源使用报告
$report = foreach ($vm in Get-VM) {
$vhd = Get-VMHardDiskDrive -VMName $vm.Name |
Select-Object -First 1

$vhdInfo = $null
if ($vhd -and (Test-Path $vhd.Path)) {
$vhdItem = Get-VHD -Path $vhd.Path
$vhdInfo = @{
SizeGB = [math]::Round($vhdItem.Size / 1GB, 1)
UsedGB = [math]::Round($vhdItem.FileSize / 1GB, 1)
Fragment = [math]::Round($vhdItem.FragmentationPercentage, 1)
}
}

[PSCustomObject]@{
Name = $vm.Name
State = $vm.State
CPUUsage = "$($vm.CPUUsage)%"
MemoryGB = [math]::Round($vm.MemoryAssigned / 1GB, 2)
MemDemandGB = [math]::Round($vm.MemoryDemand / 1GB, 2)
DiskSizeGB = if ($vhdInfo) { $vhdInfo.SizeGB } else { 'N/A' }
DiskUsedGB = if ($vhdInfo) { $vhdInfo.UsedGB } else { 'N/A' }
Uptime = $vm.Uptime.ToString('dd\天hh\时mm\分')
}
}

$report | Format-Table -AutoSize

# 输出汇总统计
$totalRunning = ($report | Where-Object { $_.State -eq 'Running' }).Count
$totalMemGB = ($report | Where-Object { $_.State -eq 'Running' } |
Measure-Object -Property MemoryGB -Sum).Sum

Write-Host "`n--- 汇总 ---" -ForegroundColor Cyan
Write-Host "虚拟机总数: $(($report).Count)"
Write-Host "运行中: $totalRunning"
Write-Host "总内存占用: $([math]::Round($totalMemGB, 1)) GB"

这个脚本通过 Get-VM 获取虚拟机基本信息,再结合 Get-VMHardDiskDriveGet-VHD 获取磁盘使用详情。最终生成一个格式化的报告,包含每台虚拟机的 CPU 使用率、内存分配与需求、磁盘容量与实际使用量等关键指标。

执行结果示例:

1
2
3
4
5
6
7
8
9
10
11
12
Name          State   CPUUsage MemoryGB MemDemandGB DiskSizeGB DiskUsedGB Uptime
---- ----- -------- -------- ----------- ---------- ---------- ------
Ubuntu-Dev Running 12% 2 1.85 60.0 18.3 12天06时34分
Win2022-Test Running 8% 4 3.42 120.0 45.7 06天12时30分
CentOS-Build Off 0% 0 0 80.0 32.1 00天00时00分
Win11-Client Saved 0% 0 0 60.0 25.6 00天00时00分
Docker-Host Running 25% 2 1.92 60.0 22.8 03天15时45分

--- 汇总 ---
虚拟机总数: 5
运行中: 3
总内存占用: 8.0 GB

注意事项

  • 权限要求:管理 Hyper-V 虚拟机需要管理员权限,并且当前用户必须是 Hyper-V Administrators 组的成员。如果 cmdlet 执行失败,请以管理员身份运行 PowerShell 并检查组成员身份。
  • Hyper-V 模块可用性:Hyper-V 模块仅在 Windows 上可用,且需要安装 Hyper-V 角色。在 Windows 10/11 上可以通过”启用或关闭 Windows 功能”安装,在 Windows Server 上通过 Install-WindowsFeature Hyper-V-PowerShell 安装。
  • 检查点不是备份:检查点依赖于虚拟硬盘的差异链,不能替代完整的虚拟机备份。生产环境中务必配合 Windows Server Backup 或第三方备份方案使用,避免因宿主机故障导致数据丢失。
  • 动态内存的影响:使用动态内存时,MemoryAssigned 显示的是当前分配值,可能随负载变化。如果需要固定内存,创建虚拟机时应设置 -MemoryMinimumBytes-MemoryMaximumBytes-MemoryStartupBytes 为相同值。
  • 虚拟硬盘类型选择New-VHD 支持 Fixed(固定大小)和 Dynamic(动态扩展)两种类型。动态扩展创建速度快、初始占用空间小,但 I/O 性能略低于固定大小。生产数据库等 I/O 密集型场景建议使用固定大小的虚拟硬盘。
  • 网络适配器配置:创建虚拟机时指定的虚拟交换机决定了网络连接方式。如果需要更灵活的网络配置,可以在创建后使用 Add-VMNetworkAdapter 添加额外的网络适配器,或用 Set-VMNetworkAdapterVlan 配置 VLAN 标签。

PowerShell 技能连载 - Active Directory 用户管理

适用于 PowerShell 5.1(Windows),需要 ActiveDirectory 模块及管理员权限

Active Directory 是企业 Windows 网络的身份基础,用户账号的创建、修改、禁用、报告是系统管理员的日常任务。AD 用户管理看似简单——在图形界面里点几下鼠标就行,但当需要批量处理几十上百个账号时,手动操作既耗时又容易出错。PowerShell 的 ActiveDirectory 模块提供了完整的用户生命周期管理能力,从批量创建到权限审计,一条命令就能替代数十次点击。

本文将介绍 AD 用户管理的常用操作和批量自动化方案。

用户查询与报告

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
# 导入模块
Import-Module ActiveDirectory

# 查询用户基本信息
Get-ADUser -Identity "zhangsan" -Properties DisplayName, Department, Title, LastLogonDate |
Select-Object SamAccountName, DisplayName, Department, Title, Enabled, LastLogonDate |
Format-List

# 搜索特定部门的用户
$users = Get-ADUser -Filter { Department -eq "工程部" -and Enabled -eq $true } `
-Properties DisplayName, EmailAddress, Title, WhenCreated

$users | Select-Object DisplayName, EmailAddress, Title, WhenCreated |
Format-Table -AutoSize

Write-Host "工程部活跃用户:$($users.Count) 人" -ForegroundColor Green

# 查找长期未登录的用户(90 天未活动)
$inactiveDate = (Get-Date).AddDays(-90)
$inactive = Get-ADUser -Filter { LastLogonDate -lt $inactiveDate -and Enabled -eq $true } `
-Properties DisplayName, LastLogonDate, Department |
Sort-Object LastLogonDate |
Select-Object DisplayName, Department, LastLogonDate

Write-Host "90 天未登录的活跃账号:$($inactive.Count) 个" -ForegroundColor Yellow
$inactive | Format-Table -AutoSize

# 即将过期的密码统计
$expiringSoon = Get-ADUser -Filter { Enabled -eq $true -and PasswordNeverExpires -eq $false } `
-Properties DisplayName, PasswordLastSet, "msDS-UserPasswordExpiryTimeComputed" |
Where-Object {
$expiry = [datetime]::FromFileTime($_."msDS-UserPasswordExpiryTimeComputed")
$expiry -lt (Get-Date).AddDays(7) -and $expiry -gt (Get-Date)
} |
Select-Object DisplayName,
@{N='PasswordExpires'; E={ [datetime]::FromFileTime($_."msDS-UserPasswordExpiryTimeComputed") }}

Write-Host "7 天内密码过期的用户:$($expiringSoon.Count) 人" -ForegroundColor Red
$expiringSoon | Format-Table -AutoSize

执行结果示例:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
SamAccountName : zhangsan
DisplayName : 张三
Department : 工程部
Title : 高级工程师
Enabled : True
LastLogonDate : 2025/9/1 14:30:00

工程部活跃用户:15
90 天未登录的活跃账号:8
DisplayName Department LastLogonDate
----------- ---------- -------------
王五 市场部 2025/5/10
赵六 财务部 2025/4/15

7 天内密码过期的用户:3
DisplayName PasswordExpires
----------- ----------------
张三 2025/9/5
李四 2025/9/3

批量用户创建

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
# 从 CSV 批量创建用户
$csvData = @"
Name,DisplayName,Department,Title,Manager
li.si,李四,工程部,工程师,zhangsan
wang.wu,王五,市场部,市场专员,zhangsan
zhao.liu,赵六,财务部,会计,lisi
chen.qi,陈七,工程部,初级工程师,zhangsan
"@ | ConvertFrom-Csv

function New-BatchADUsers {
param(
[Parameter(Mandatory)]
[object[]]$UserData,

[string]$BaseOU = "OU=员工,DC=contoso,DC=com",

[string]$DefaultPassword = "P@ssw0rd!2025",

[string]$UPNSuffix = "contoso.com"
)

$results = @()
$successCount = 0
$failCount = 0

$securePassword = ConvertTo-SecureString $DefaultPassword -AsPlainText -Force

foreach ($user in $UserData) {
try {
# 检查是否已存在
$existing = Get-ADUser -Filter { SamAccountName -eq $user.Name } -ErrorAction SilentlyContinue
if ($existing) {
Write-Host "用户已存在:$($user.Name)" -ForegroundColor Yellow
$results += @{ Name = $user.Name; Status = "已存在" }
continue
}

# 创建用户
$newUserParams = @{
Name = $user.DisplayName
DisplayName = $user.DisplayName
SamAccountName = $user.Name
UserPrincipalName = "$($user.Name)@$UPNSuffix"
GivenName = ($user.DisplayName -split '')[1]
Surname = ($user.DisplayName -split '')[0]
Department = $user.Department
Title = $user.Title
Path = $BaseOU
AccountPassword = $securePassword
Enabled = $true
ChangePasswordAtLogon = $true
}

if ($user.Manager) {
$newUserParams['Manager'] = $user.Manager
}

New-ADUser @newUserParams
$successCount++
Write-Host "已创建:$($user.Name)($($user.Department))" -ForegroundColor Green
$results += @{ Name = $user.Name; Status = "成功" }
} catch {
$failCount++
Write-Host "创建失败:$($user.Name) - $($_.Exception.Message)" -ForegroundColor Red
$results += @{ Name = $user.Name; Status = "失败:$($_.Exception.Message)" }
}
}

Write-Host "`n汇总:成功 $successCount,失败 $failCount" -ForegroundColor Cyan
return $results
}

# 执行批量创建
New-BatchADUsers -UserData $csvData

# 从 CSV 文件导入(生产环境常用)
# $importData = Import-Csv "C:\HR\NewEmployees_202509.csv"
# New-BatchADUsers -UserData $importData

执行结果示例:

1
2
3
4
5
已创建:li.si(工程部)
已创建:wang.wu(市场部)
已创建:zhao.liu(财务部)
已创建:chen.qi(工程部)
汇总:成功 4,失败 0

用户生命周期管理

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
# 批量修改用户属性
$users = @("li.si", "wang.wu")
foreach ($name in $users) {
Set-ADUser -Identity $name -Department "研发部" -Company "Contoso Corp"
Write-Host "已更新 $name 的部门和公司信息" -ForegroundColor Green
}

# 禁用离职用户
function Disable-DepartedUsers {
param([string[]]$UserNames)

foreach ($name in $UserNames) {
try {
$user = Get-ADUser -Identity $name -Properties DisplayName
Disable-ADAccount -Identity $name

# 移动到离职 OU
Move-ADObject -Identity $user.DistinguishedName `
-TargetPath "OU=离职员工,DC=contoso,DC=com"

# 移除所有组(保留 Domain Users)
$groups = Get-ADPrincipalGroupMembership -Identity $name |
Where-Object { $_.Name -ne "Domain Users" }
foreach ($group in $groups) {
Remove-ADGroupMember -Identity $group.SamAccountName -Members $name -Confirm:$false
}

Write-Host "已禁用并归档:$($user.DisplayName)($name)" -ForegroundColor Yellow
} catch {
Write-Host "处理失败:$name - $($_.Exception.Message)" -ForegroundColor Red
}
}
}

Disable-DepartedUsers -UserNames @("zhao.liu")

# 用户组管理
function Set-UserDepartmentGroups {
param(
[string]$UserName,
[string]$Department
)

$deptGroups = @{
"工程部" = @("SG_Developers", "SG_Git_Access", "SG_Build_Servers")
"市场部" = @("SG_Marketing", "SG_CRM_Access")
"财务部" = @("SG_Finance", "SG_ERP_Access", "SG_Reporting")
}

$groups = $deptGroups[$Department]
if (-not $groups) {
Write-Host "未定义 $Department 的默认组" -ForegroundColor Yellow
return
}

foreach ($group in $groups) {
try {
Add-ADGroupMember -Identity $group -Members $UserName -ErrorAction Stop
Write-Host "已加入组:$group" -ForegroundColor Green
} catch {
Write-Host "加入组失败:$group - $($_.Exception.Message)" -ForegroundColor Red
}
}
}

Set-UserDepartmentGroups -UserName "chen.qi" -Department "工程部"

执行结果示例:

1
2
3
4
5
6
已更新 li.si 的部门和公司信息
已更新 wang.wu 的部门和公司信息
已禁用并归档:赵六(zhao.liu)
已加入组:SG_Developers
已加入组:SG_Git_Access
已加入组:SG_Build_Servers

注意事项

  1. 权限要求:AD 操作需要相应权限,建议使用最小权限原则,为管理账号分配专门的 OU 管理权限
  2. 密码策略:批量创建用户时设置的初始密码应符合域密码策略要求
  3. 测试先行:批量操作前先用 -WhatIf 参数预览变更,确认无误后再执行
  4. 日志审计:AD 关键操作应记录日志,包括操作人、时间、变更内容
  5. OU 结构:用户创建前确认目标 OU 路径正确,避免创建到错误位置
  6. 同步延迟:多域控制器环境下,修改后存在复制延迟,不要立即在另一台 DC 上查询验证