PowerShell移除用户所有通讯组脚本报错：–BypassSecurityGroupManagerCheck参数异常问题

你遇到的异常根源是参数格式错误——仔细看Remove-DistributionGroupMember里的–BypassSecurityGroupManagerCheck、–Member这些参数的破折号，它们是中文全角破折号，而PowerShell只识别英文半角的连字符-。这是复制脚本时很容易踩的小坑，直接导致PowerShell无法识别参数，进而卡住流程。

下面是修正后的完整脚本，我把所有全角破折号替换成了英文半角连字符，还新增了基础错误处理，避免单个组移除失败中断整个脚本：

$email = Read-Host "Please provide a user's email address to remove from all distribution groups"
try {
    $mailbox = Get-Mailbox -Identity $email -ErrorAction Stop
    $DN = $mailbox.DistinguishedName
    $Filter = "Members -like ""$DN"""
    $DistributionGroupsList = Get-DistributionGroup -ResultSize Unlimited -Filter $Filter -ErrorAction Stop

    Write-host "`nListing all Distribution Groups:`n"
    $DistributionGroupsList | Format-Table

    $answer = Read-Host "Would you like to proceed and remove $email from all distribution groups ( y / n )?"
    While ("y","n" -notcontains $answer) {
        $answer = Read-Host "Invalid input! Please enter y or n"
    }

    If ($answer -eq 'y') {
        $successCount = 0
        $failCount = 0
        ForEach ($item in $DistributionGroupsList) {
            try {
                Remove-DistributionGroupMember -Identity $item.DisplayName -Member $email -BypassSecurityGroupManagerCheck -Confirm:$false -ErrorAction Stop
                Write-Host "Successfully removed $email from $($item.DisplayName)"
                $successCount++
            }
            catch {
                Write-Host "Failed to remove $email from $($item.DisplayName): $_" -ForegroundColor Red
                $failCount++
            }
        }
        Write-host "`nOperation completed: $successCount groups updated successfully, $failCount failed."
    }
}
catch {
    Write-Host "Error occurred during initial setup: $_" -ForegroundColor Red
}
finally {
    Remove-Variable * -ErrorAction SilentlyContinue
}

额外注意事项： #

• 确保执行脚本的账号拥有Exchange Recipient Management或更高权限，尤其是使用-BypassSecurityGroupManagerCheck参数时，需要对应权限才能绕过组管理器的限制
• 如果Get-Mailbox无法通过邮箱地址找到用户，可以尝试用-UserPrincipalName或-Alias参数替代-Identity
• 新增的错误处理能帮你定位具体哪个组移除失败，避免整个脚本因单个异常卡住

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