如何优化PowerShell批量创建Azure AD安全组的脚本运行效率

原脚本采用串行单条调用已弃用的AzureAD模块接口，创建超过10个组时效率极低，且无错误校验、重复校验逻辑，容易出现执行中断、重复创建报错等问题。以下为可落地的优化方案：

1. 基础优化：替换为官方推荐的Microsoft Graph PowerShell模块 #

AzureAD模块已于2024年完全停止维护，换成官方主推的Microsoft Graph模块兼容性、稳定性、性能都有明显提升，且自带更完善的错误提示。

前置操作代码（仅首次运行需要） #

# 安装组管理专用模块
Install-Module Microsoft.Graph.Groups -Force -AllowClobber
# 连接AAD，申请组创建权限
Connect-MgGraph -Scopes "Group.ReadWrite.All"

带校验的基础优化版本脚本 #

# 导入CSV数据
$groups = Import-Csv -Path "C:\PathToCSVWithGroupsIWant\CSV.csv"
# 预查询现有组避免重复创建
$existingGroups = (Get-MgGroup -All -Property DisplayName).DisplayName
$createCount = 0
$failCount = 0

foreach ($group in $groups) {
    $groupName = $group.DisplayName.Trim()
    $groupDesc = $group.Description.Trim()
    # 跳过已存在/名称为空的组
    if ([string]::IsNullOrEmpty($groupName)) {
        Write-Warning "跳过空名称组"
        continue
    }
    if ($existingGroups -contains $groupName) {
        Write-Warning "组 $groupName 已存在，跳过创建"
        continue
    }
    try {
        # 调用Graph接口创建安全组
        New-MgGroup -DisplayName $groupName `
                    -Description $groupDesc `
                    -SecurityEnabled $true `
                    -MailEnabled $false `
                    -MailNickname ($groupName -replace "\s+","_") `
                    -ErrorAction Stop
        $createCount++
    }
    catch {
        Write-Error "创建组 $groupName 失败：$_"
        $failCount++
    }
}
Write-Host "执行完成：成功创建 $createCount 个组，失败 $failCount 个"

2. 大批量场景效率优化 #

如果需要创建的组超过50个，可使用以下两种方案将执行速度提升3~10倍：

• 改用PowerShell 7+的并行执行特性，并行数建议不超过15，避免触发AAD接口限流，代码示例：

$groups = Import-Csv -Path "C:\PathToCSVWithGroupsIWant\CSV.csv"
# 并行执行创建逻辑
$groups | ForEach-Object -Parallel {
    Connect-MgGraph -Scopes "Group.ReadWrite.All" -NoWelcome
    $groupName = $_.DisplayName.Trim()
    $groupDesc = $_.Description.Trim()
    if ([string]::IsNullOrEmpty($groupName)) {
        Write-Warning "跳过空名称组"
        return
    }
    $exist = Get-MgGroup -Filter "DisplayName eq '$groupName'" -Property DisplayName
    if ($exist) {
        Write-Warning "组 $groupName 已存在，跳过创建"
        return
    }
    try {
        New-MgGroup -DisplayName $groupName `
                    -Description $groupDesc `
                    -SecurityEnabled $true `
                    -MailEnabled $false `
                    -MailNickname ($groupName -replace "\s+","_") `
                    -ErrorAction Stop
        Write-Host "成功创建组：$groupName"
    }
    catch {
        Write-Error "创建组 $groupName 失败：$_"
    }
} -ThrottleLimit 10

• 调用Microsoft Graph批量提交接口，单次请求最多可提交20个创建任务，限流风险比并行执行更低，适合上千级别的超大批量创建场景。

3. 额外注意事项 #

• CSV导入前先校验字段合法性，避免空名称、特殊字符等非法值导致创建失败
• 全量执行前先拿1~2条测试数据验证逻辑正常
• 若出现429限流报错，可在循环内增加Start-Sleep -Seconds 1延迟，或降低并行数

内容的提问来源于stack exchange，提问作者BPengu